CVS log for xc/programs/Xserver/hw/xfree86/XF86Config.man
	Help

Request diff between arbitrary revisions

fix typo

typo

 349. Fix for ServerFlags "Log" option, and document it in the XF86Config
      man page (David Dawes).

remove references to obsolete doc

 283. First phase of dynamic configuration (David Dawes, S. Lussos,
      Michael Dawes, J. D. Darling, X-Oz Technologies).

 257. Automatic configuration updates, including:
       - Modify the parser/config support to allow multiple configuration
         sources to be combined.
       - Modify the parser/config support to allow multiple ServerFlags,
         Files, and Module sections.
       - Allow the automatically-generated configuration to be appended to
         a partial static configuration.
       - Use a more complete set of the probed EDID information in determining
         the monitor parameters.
       - Add a "preferred" mode type, which can be obtained from the probed
         EDID information or from the configuration.
       - Some parser interface cleanups.
      (David Dawes, X-Oz Technologies).

 256. Extend the parser/config support to allow multiple Monitor sections
      to be referenced from a Screen section (David Dawes).
CVS----------------------------------------------------------------------

some more cleanups

info about auto-configuration
+ spell check

 486. Add "automatic configuration" support for the XFree86 server, allowing
      it to be started in a useful way without an XF86Config file.
       - Add support to the config file parser for processing internally
         supplied configuration data.
       - Modify the algorithm for finding core input devices to maximise the
         likelihood that they will be found.
       - Add a FindDevice function to the OSMouse interface, allowing
         an OS-specific function to be called to find the mouse device when
         none is specified in the configuration.  Implementations included for
         Linux and FreeBSD.
       - Add a GuessProtocol function to the OSMouse interface, allowing
         an OS-specific function to be called as a fallback when the mouse
         protocol can't otherwise be detected.  Implementation included for
         Linux.
       - Bump the OSMouse interface version to 1.1 with the addition of the
         above two functions.
       - An interface for calling an external utility "getconfig" to generate
         some configuration data.  Implementation of getconfig included.
       - Generate a default internal configuration, autodetecting as much
         as possible, with reasonable fallbacks.
       - Recognise "DefaultDepth" and "DefaultFbbpp" options in the Device
         section.
       - Add a "TargetRefreshRate" option to help prevent modes with too
         high a resolution (and poor refresh rate) being used as the default.
       - Use DDC-probed mode timings to estimate the monitor parameters when
         the DDC-probed information doesn't include a DS_RANGES property.
         This should improve the reliability of monitor auto-detection.
      (David Dawes, X-Oz Technologies).

Document the Int10 module options.

fix typos

 400. Update the Xserver(1), XFree86(1) and XF86Config(5) man pages to
      clarify how XFree86 configuration/run-time parameters are specified
      and their order of precedence (David Dawes).

 398. Make the specification of a Monitor in the Screen sections of the
      XF86Config file optional.  Some drivers may need changes (coming later)
      to maximise the utility of this (David Dawes).
 397. When a core keyboard or core pointer cannot be found in the
      configuration, create default ones.  The pointer part of this
      requires some changes to the mouse driver (coming later) before
      the default core pointer configuration will be useful on most
      platforms (David Dawes).

 381. Allow a Display subsection with no depth or fbbpp specified to match
      any depth/fbbpp, and make Display subsections optional, creating one
      with default parameters when no suitable one can be found (David Dawes).

Fix manual pages typos (Bugzilla #316, Jens Schweikhardt).

avoid \(cq (not all *roff know about it)

 961. Add documentation about using XKB for the XFree86 server's special
      key sequences and the HandleSpecialKeys config option (#5653, Joe Moss).

 930. Fix run-time enabling/disabling of VT switching via xf86EnableVTSwitch()
      (David Dawes).
 929. Add a "DontVTSwitch" option to allow VT switching to be disabled
      (on platforms where the X server initiates VT switches) (#5640,
      Branden Robinson).

remove comments that break the HTML formatting

 546. Document the "nomtrr" option in the XF86Config man page (#5494,
      Mike Harris).

- numerous man pages fixes, add some missing manpages (#5365, #5373,
#5376, #5377, #5382-5385, #5390, #5391, #5393, #5295 Branden Robinson
#5374, Jonathan Amery #5378, Jochen Voss)
- intall bdftruncate and ucs2any without the .pl extension
(#5391, Branden Robinson)

 381. Add a "kbd" driver module that can eventually replace the built-in
      "keyboard" driver (#5344, Ivan Pascal).
 381. Add os-support level support for a loadable keyboard driver for BSD
      and Linux (#5344, Ivan Pascal).
 380. Add some new common layer functions for supporting a loadable keyboard
      driver (#5344, Ivan Pascal).
 379. Move the XkbDisable option to a global server flag rather than
      keyboard driver flag, since it really is a global setting (#5344,
      Ivan Pascal).

- Fix the man page information about Absolute screen positioning in
  the ServerLayout section.
- Recognise the "Absolute" keyword that was documented in the man page.

Document the DefaultServerLayout serverflags option.

Summary of changes for grab removal/client-closedown key sequences:

o Changed XF86MISC_MINOR_VERSION from 4 to 5
o Added the function "int XF86MiscSetGrabKeysState(Display *dpy, Bool enable)"
  to the XF86Misc extension. The enable argument means allow or disallow the
  use of the keys Ctrl+Alt+KP_Divide or Ctrl+Alt+KP_Multiply.
  The return values are:
  MiscExtGrabStateSuccess:	success, enabled or disabled key sequences
  MiscExtGrabStateLocked:	another client already disabled the key
				sequences
  MiscExtGrabStateAlready:	call for enabling when enabled, or disable
				when disabled
o The key sequence Ctrl+Alt+KP_Divide deactivates any active keyboard/pointer
  grab, if the XF86Config option allowDeactivateGrabs is set.
o The key sequence Ctrl+Alt+KP_Multiply closes the connection for the client
  owner of any active keyboard/pointer/server grab, if the XF86Config option
  allowClosedownGrabs is set.

Sample program to protect xlock from being killed:
--%<--
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <signal.h>
#include <X11/Xlib.h>
#include <X11/extensions/xf86misc.h>

int
main(int argc, char *argv[])
{
    int xfree86, major, minor;
    Display *display = XOpenDisplay(NULL);

    if (display == NULL) {
	fprintf(stderr, "Cannot open display.\n");
	exit(1);
    }

    xfree86 = strstr(ServerVendor(display), "XFree86");

    if (xfree86) {
	signal(SIGHUP, SIG_IGN);
	signal(SIGPIPE, SIG_IGN);
	signal(SIGINT, SIG_IGN);
	signal(SIGQUIT, SIG_IGN);

	if (XF86MiscQueryVersion(display, &major, &minor) == False) {
	    fprintf(stderr, "Failed to call XF86MiscQueryVersion.\n");
	    exit(1);
	}

	if (major >= 0 && minor >= 5 &&
	    XF86MiscSetGrabKeysState(display, False) ==
	    MiscExtGrabStateLocked) {
	    fprintf(stderr, "Cannot disable XFree86 hotkeys to remove grabs.\n");
	    exit(1);
	}
	XFlush(display);
    }

    system("xlock");

    if (xfree86 && major >= 0 && minor >= 5) {
	XF86MiscSetGrabKeysState(display, True);
	XFlush(display);
    }

    return (0);
}
--%<--

compile it as:
cc -o wrap-xlock wrap-xlock.c -I/usr/X11R6/include -L/usr/X11R6/lib -lX11 -lXext -lXxf86misc

Another option is to add this code to the screen lock programs.

Note that for safety, only screensavers should use this api.

Documents Xaa specific options in XF86Config manual page
(#4616, Branden Robinson)

 341. Add a driver for VMware virtual SVGA devices.  This is for use
      by X servers running under a VMware guest OS (#4529, VMware, Inc).
 340. Remove Cygwin-specific #ifdef in Xserver/os/Waitfor.c, which fixes
      a crash (#4528, Suhaib Siddiqi).
 339. Cygwin build fixes (#4527, Suhaib Siddiqi).
- fix some doc typos

 144. Fix the neomagic driver so that it saves/restores the palette (#4452,
      Ken Hornstein).
 143. Fix a palette saving bug in the vgahw module (#4452, Ken Hornstein).
 142. Fix a typo in Xfbdev.man (#4446, Juliusz Chroboczek).
 141. Major updates to the savage driver, including:
       - DDC support
       - I2C support
       - XVideo YUV overlay support for Savage/MX and Savage/IX
       - DGA support
       - yanks Ani Joshi's depth/bitsPerPixel patch for searching the BIOS
       - fixes interactions with frame buffer and SVGATextMode consoles;
         VT switching now seems quite reliable for almost everyone
       - yanks unused options
       - adds new options for hacks to deal with the status register hangs
       - adds one special case memory configuration for Savage 4
       - adds support for doublescan modes (320x240 works)
       - adds LCD panel detection
       - fixes a panning bug at depth 24 (panning must be to even pixels)
       - adds a workaround for bugs in the latest ProSavage BIOSes
      (#4445, 4448, Tim Roberts).
 140. Make 'X -configure' use the long monitor name when present in the
      DDC info (#4444, Andrew C. Aitchison).
 139. Make glxinfo respect $DISPLAY (#4443, Meelis Roos).
 138. Fix TrueType font problems in 4.0.2 (#4439, Juliusz Chroboczek).
 137. Document the "DisplaySize" keyword in the XF86Config man page (#4438,
      Andrew C. Aitchison).

  88. Set the version strings in man pages dynamically (David Dawes).
  87. Remove the XF86_VERSION string from xf86Version.h, leaving just
      the numerical values.  All the version information is now derived
      from that single set of values (David Dawes).

  79. Preprocess all man pages to make sure that the references to pages
      in sections that are platform-dependent are correct.  Also fixed some
      misc formatting problems found while doing that (David Dawes).