Update xorg.conf man page & sample for changes in Xorg 1.7

AllowMouseOpenFail description changed to reflect actual behaviour
and point to AllowEmptyInput for previously described behaviour.

Update default DPMS mode timeouts to match new defaults set
in April 2009 by commit d52fddefae

Update autoloaded module list to match ModuleDefaults in xf86Config.c
Update module subdir list to match stdSubdirs in loadmod.c

Add xorg.conf options that were added to the code:
- XkbDir option added in February 2009
  by commit 76f18b94bd
- DRI2 option added in April 2008
  by 35982bc109

Remove xorg.conf options that were removed from the code:
- XkbDisable option was removed in January 2009
  by commit 40877c6680
- PciProbe/Config options were removed in August 2008
  by commit fdf7c747a8
- EstimateSizesAggressively was removed in August 2008
  by commit cd1e8f2614
- loadable font modules were removed in July 2008
  by commit affec10635
- ModInDev options were removed in December 2008
  by commit 6de6ffff35

(Also strips some trailing whitespaces to make git happier.)

Signed-off-by: Alan Coopersmith <alan.coopersmith@sun.com>
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
This commit is contained in:
Alan Coopersmith 2009-09-14 15:59:41 +10:00 committed by Peter Hutterer
parent b6f5c54fc6
commit 2b00afec4b
3 changed files with 71 additions and 111 deletions

View File

@ -37,6 +37,8 @@ MANDEFS = \
-D__mandir__=$(mandir) \ -D__mandir__=$(mandir) \
-D__projectroot__=$(prefix) \ -D__projectroot__=$(prefix) \
-D__xconfigfile__=$(__XCONFIGFILE__) -D__xconfigdir__=$(XCONFIGDIR) \ -D__xconfigfile__=$(__XCONFIGFILE__) -D__xconfigdir__=$(XCONFIGDIR) \
-D__xkbdir__=$(XKB_BASE_DIRECTORY) \
-D__modulepath__="$(DEFAULT_MODULE_PATH)" \
-D__xlogfile__=$(XLOGFILE) -D__xservername__=$(XSERVERNAME) -D__xlogfile__=$(XLOGFILE) -D__xservername__=$(XSERVERNAME)
.pre: .pre:

View File

@ -1,4 +1,3 @@
.\" $XdotOrg: xserver/xorg/hw/xfree86/doc/man/xorg.conf.man.pre,v 1.7 2006/05/26 00:12:18 reed Exp $
.\" shorthand for double quote that works everywhere. .\" shorthand for double quote that works everywhere.
.ds q \N'34' .ds q \N'34'
.TH __xconfigfile__ __filemansuffix__ __vendorversion__ .TH __xconfigfile__ __filemansuffix__ __vendorversion__
@ -96,7 +95,8 @@ is the machine's hostname as reported by
.PP .PP
The The
.I __xconfigfile__ .I __xconfigfile__
file is composed of a number of sections which may be present in any order. file is composed of a number of sections which may be present in any order,
or omitted to use default configuration values.
Each section has the form: Each section has the form:
.PP .PP
.RS 4 .RS 4
@ -358,23 +358,10 @@ font path elements (which can be set inside a catalogue directory):
.nf .nf
.I __projectroot__/lib/X11/fonts/misc/ .I __projectroot__/lib/X11/fonts/misc/
.I __projectroot__/lib/X11/fonts/TTF/ .I __projectroot__/lib/X11/fonts/TTF/
.I __projectroot__/lib/X11/fonts/OTF/
.I __projectroot__/lib/X11/fonts/Type1/ .I __projectroot__/lib/X11/fonts/Type1/
.I __projectroot__/lib/X11/fonts/75dpi/
.I __projectroot__/lib/X11/fonts/100dpi/ .I __projectroot__/lib/X11/fonts/100dpi/
.fi
.RE
.PP
The recommended font path contains the following font path elements:
.PP
.RS 4
.nf
.I __projectroot__/lib/X11/fonts/local/
.I __projectroot__/lib/X11/fonts/misc/
.I __projectroot__/lib/X11/fonts/75dpi/:unscaled
.I __projectroot__/lib/X11/fonts/100dpi/:unscaled
.I __projectroot__/lib/X11/fonts/Type1/
.I __projectroot__/lib/X11/fonts/75dpi/ .I __projectroot__/lib/X11/fonts/75dpi/
.I __projectroot__/lib/X11/fonts/100dpi/
.fi .fi
.RE .RE
.PP .PP
@ -389,7 +376,11 @@ searches for loadable modules loading in the order specified.
Multiple Multiple
.B ModulePath .B ModulePath
entries may be specified, and they will be concatenated to build the entries may be specified, and they will be concatenated to build the
module search path used by the server. module search path used by the server. The default module path is
.PP
.RS 11
__modulepath__
.RE
.\" The LogFile keyword is not currently implemented .\" The LogFile keyword is not currently implemented
.ig .ig
.TP 7 .TP 7
@ -406,6 +397,15 @@ where
.I <n> .I <n>
is the display number for the __xservername__ server. is the display number for the __xservername__ server.
.. ..
.TP 7
.BI "XkbDir \*q" path \*q
sets the base directory for keyboard layout files. The
.B \-xkbdir
command line option can be used to override this. The default directory is
.PP
.RS 11
__xkbdir__
.RE
.SH "SERVERFLAGS SECTION" .SH "SERVERFLAGS SECTION"
In addition to options specific to this section (described below), the In addition to options specific to this section (described below), the
.B ServerFlags .B ServerFlags
@ -492,8 +492,12 @@ extension) to connect from another host.
Default: off. Default: off.
.TP 7 .TP 7
.BI "Option \*qAllowMouseOpenFail\*q \*q" boolean \*q .BI "Option \*qAllowMouseOpenFail\*q \*q" boolean \*q
This allows the server to start up even if the mouse device can't be This tells the mousedrv(__drivermansuffix__) and vmmouse(__drivermansuffix__)
opened/initialised. drivers to not report failure if the mouse device can't be opened/initialised.
It has no effect on the evdev(__drivermansuffix__) or other drivers.
The previous functionality of allowing the server to start up even if
the mouse device can't be opened/initialised is now handled by the
AllowEmptyInput option.
Default: false. Default: false.
.TP 7 .TP 7
.BI "Option \*qVTSysReq\*q \*q" boolean \*q .BI "Option \*qVTSysReq\*q \*q" boolean \*q
@ -508,30 +512,6 @@ keys used for the default VT switch sequence, which means that clients can
access them. access them.
Default: off. Default: off.
.TP 7 .TP 7
.BI "Option \*qXkbDisable\*q \*q" boolean \*q
disable/enable the XKEYBOARD extension.
The \-kb command line option overrides this config file option.
Default: XKB is enabled.
.\" The following four options are "undocumented".
.ig
.TP 7
.BI "Option \*qPciProbe1\*q"
Use PCI probe method 1.
Default: set.
.TP 7
.BI "Option \*qPciProbe2\*q"
Use PCI probe method 2.
Default: not set.
.TP 7
.BI "Option \*qPciForceConfig1\*q"
Force the use PCI config type 1.
Default: not set.
.TP 7
.BI "Option \*qPciForceConfig2\*q"
Force the use PCI config type 2.
Default: not set.
..
.TP 7
.BI "Option \*qBlankTime\*q \*q" time \*q .BI "Option \*qBlankTime\*q \*q" time \*q
sets the inactivity timeout for the sets the inactivity timeout for the
.B blank .B blank
@ -551,7 +531,7 @@ phase of DPMS mode.
.I time .I time
is in minutes, and the value can be changed at run\-time with is in minutes, and the value can be changed at run\-time with
.BR xset(__appmansuffix__). .BR xset(__appmansuffix__).
Default: 20 minutes. Default: 10 minutes.
This is only suitable for VESA DPMS compatible monitors, and may not be This is only suitable for VESA DPMS compatible monitors, and may not be
supported by all video drivers. supported by all video drivers.
It is only enabled for screens that have the It is only enabled for screens that have the
@ -565,7 +545,7 @@ phase of DPMS mode.
.I time .I time
is in minutes, and the value can be changed at run\-time with is in minutes, and the value can be changed at run\-time with
.BR xset(__appmansuffix__). .BR xset(__appmansuffix__).
Default: 30 minutes. Default: 10 minutes.
This is only suitable for VESA DPMS compatible monitors, and may not be This is only suitable for VESA DPMS compatible monitors, and may not be
supported by all video drivers. supported by all video drivers.
It is only enabled for screens that have the It is only enabled for screens that have the
@ -579,7 +559,7 @@ phase of DPMS mode.
.I time .I time
is in minutes, and the value can be changed at run\-time with is in minutes, and the value can be changed at run\-time with
.BR xset(__appmansuffix__). .BR xset(__appmansuffix__).
Default: 40 minutes. Default: 10 minutes.
This is only suitable for VESA DPMS compatible monitors, and may not be This is only suitable for VESA DPMS compatible monitors, and may not be
supported by all video drivers. supported by all video drivers.
It is only enabled for screens that have the It is only enabled for screens that have the
@ -599,13 +579,6 @@ Specify that the machine is a Japanese PC\-98 machine.
This should not be enabled for anything other than the Japanese\-specific This should not be enabled for anything other than the Japanese\-specific
PC\-98 architecture. PC\-98 architecture.
Default: auto\-detected. Default: auto\-detected.
.\" Doubt this should be documented.
.ig
.TP 7
.BI "Option \*qEstimateSizesAggressively\*q \*q" value \*q
This option affects the way that bus resource sizes are estimated.
Default: 0.
..
.TP 7 .TP 7
.BI "Option \*qNoPM\*q \*q" boolean \*q .BI "Option \*qNoPM\*q \*q" boolean \*q
Disables something to do with power management events. Disables something to do with power management events.
@ -618,6 +591,9 @@ Default is disabled.
.BI "Option \*qAIGLX\*q \*q" boolean \*q .BI "Option \*qAIGLX\*q \*q" boolean \*q
enable or disable AIGLX. AIGLX is enabled by default. enable or disable AIGLX. AIGLX is enabled by default.
.TP 7 .TP 7
.BI "Option \*qDRI2\*q \*q" boolean \*q
enable or disable DRI2. DRI2 is disabled by default.
.TP 7
.BI "Option \*qGlxVisuals\*q \*q" string \*q .BI "Option \*qGlxVisuals\*q \*q" string \*q
This option controls how many GLX visuals the GLX modules sets up. This option controls how many GLX visuals the GLX modules sets up.
The default value is The default value is
@ -667,8 +643,8 @@ The
.B Module .B Module
section is used to specify which __xservername__ server modules should be loaded. section is used to specify which __xservername__ server modules should be loaded.
This section is ignored when the __xservername__ server is built in static form. This section is ignored when the __xservername__ server is built in static form.
The types of modules normally loaded in this section are __xservername__ server The type of modules normally loaded in this section are __xservername__ server
extension modules, and font rasteriser modules. extension modules.
Most other module types are loaded automatically when they are needed via Most other module types are loaded automatically when they are needed via
other mechanisms. other mechanisms.
The The
@ -690,10 +666,10 @@ The standard name is case\-sensitive, and does not include the \(lqlib\(rq
prefix, or the \(lq.a\(rq, \(lq.o\(rq, or \(lq.so\(rq suffixes. prefix, or the \(lq.a\(rq, \(lq.o\(rq, or \(lq.so\(rq suffixes.
.PP .PP
.RS 7 .RS 7
Example: the FreeType font rasteriser can be loaded with the following entry: Example: the DRI extension module can be loaded with the following entry:
.PP .PP
.RS 4 .RS 4
.B "Load \*qfreetype\*q" .B "Load \*qdri\*q"
.RE .RE
.RE .RE
.TP 7 .TP 7
@ -733,23 +709,23 @@ disabled by using the following entry:
.PP .PP
Modules are searched for in each directory specified in the Modules are searched for in each directory specified in the
.B ModulePath .B ModulePath
search path, and in the drivers, input, extensions, fonts, and search path, and in the drivers, extensions, input, internal, and
internal subdirectories of each of those directories. multimedia subdirectories of each of those directories.
In addition to this, operating system specific subdirectories of all In addition to this, operating system specific subdirectories of all
the above are searched first if they exist. the above are searched first if they exist.
.PP .PP
To see what font and extension modules are available, check the contents To see what extension modules are available, check the contents
of the following directories: of the following directory:
.PP .PP
.RS 4 .RS 4
.nf .nf
__projectroot__/lib/modules/fonts
__projectroot__/lib/modules/extensions __projectroot__/lib/modules/extensions
.fi .fi
.RE .RE
.PP .PP
The \(lqextmod\(rq, \(lqdbe\(rq, \(lqglx\(rq, and \(lqdri\(rq extension The \(lqextmod\(rq, \(lqdbe\(rq, \(lqdri\(rq, \(lqdri2\(rq, \(lqglx\(rq,
modules are loaded automatically, unless disabled with \*qDisable\*q entries. and \(lqrecord\(rq extension modules are loaded automatically, if they
are present, unless disabled with \*qDisable\*q entries.
It is recommended It is recommended
that at very least the \(lqextmod\(rq extension module be loaded. that at very least the \(lqextmod\(rq extension module be loaded.
If it isn't, some commonly used server extensions (like the SHAPE If it isn't, some commonly used server extensions (like the SHAPE
@ -784,7 +760,8 @@ Example: the MIT-SHM extension can be disabled with the following entry:
The config file may have multiple The config file may have multiple
.B InputDevice .B InputDevice
sections. sections.
There will normally be at least two: one for the core (primary) keyboard, If HAL is not being used for input device configuration, there will normally
be at least two: one for the core (primary) keyboard,
and one of the core pointer. and one of the core pointer.
If either of these two is missing, a default configuration for the missing If either of these two is missing, a default configuration for the missing
ones will be used. ones will be used.

View File

@ -73,11 +73,6 @@ XCOMM initialisation of the XFree86-DGA extension within that module.
Option "omit xfree86-dga" Option "omit xfree86-dga"
EndSubSection EndSubSection
XCOMM This loads the Type1 and FreeType font modules
Load "type1"
Load "freetype"
EndSection EndSection
@ -99,8 +94,8 @@ XCOMM events.
XCOMM Option "DontVTSwitch" XCOMM Option "DontVTSwitch"
XCOMM Uncomment this to enable the <Ctrl><Alt><BS> server abort sequence XCOMM Uncomment this to disable the <Ctrl><Alt><BS> server abort sequence
XCOMM The default allows clients to receive this key event. XCOMM This allows clients to receive this key event.
XCOMM Option "DontZap" "false" XCOMM Option "DontZap" "false"
@ -120,28 +115,18 @@ XCOMM Uncomment this to enable the use of a non-local xvidtune client.
XCOMM Option "AllowNonLocalXvidtune" XCOMM Option "AllowNonLocalXvidtune"
XCOMM Uncomment this to disable dynamically modifying the input device
XCOMM (mouse and keyboard) settings.
XCOMM Option "DisableModInDev"
XCOMM Uncomment this to enable the use of a non-local client to
XCOMM change the keyboard or mouse settings (currently only xset).
XCOMM Option "AllowNonLocalModInDev"
XCOMM Set the basic blanking screen saver timeout. XCOMM Set the basic blanking screen saver timeout.
Option "blank time" "10" # 10 minutes Option "BlankTime" "10" # 10 minutes
XCOMM Set the DPMS timeouts. These are set here because they are global XCOMM Set the DPMS timeouts. These are set here because they are global
XCOMM rather than screen-specific. These settings alone don't enable DPMS. XCOMM rather than screen-specific. These settings alone don't enable DPMS.
XCOMM It is enabled per-screen (or per-monitor), and even then only when XCOMM It is enabled per-screen (or per-monitor), and even then only when
XCOMM the driver supports it. XCOMM the driver supports it.
Option "standby time" "20" Option "StandbyTime" "10" # 10 minutes
Option "suspend time" "30" Option "SuspendTime" "10" # 10 minutes
Option "off time" "60" Option "OffTime" "10" # 10 minutes
EndSection EndSection
@ -167,10 +152,6 @@ XCOMM Specifiy which keyboard LEDs can be user-controlled (eg, with xset(1)).
XCOMM Option "Xleds" "1 2 3" XCOMM Option "Xleds" "1 2 3"
XCOMM To disable the XKEYBOARD extension, uncomment XkbDisable.
XCOMM Option "XkbDisable"
XCOMM To customise the XKB settings to suit your keyboard, modify the XCOMM To customise the XKB settings to suit your keyboard, modify the
XCOMM lines below (which are the defaults). For example, for a European XCOMM lines below (which are the defaults). For example, for a European
XCOMM keyboard, you will probably want to use one of: XCOMM keyboard, you will probably want to use one of:
@ -395,14 +376,14 @@ Section "Device"
XCOMM The Identifier must be present. XCOMM The Identifier must be present.
Identifier "Generic VGA" Identifier "Generic VESA"
XCOMM The Driver line must be present. When using run-time loadable driver XCOMM The Driver line must be present. When using run-time loadable driver
XCOMM modules, this line instructs the server to load the specified driver XCOMM modules, this line instructs the server to load the specified driver
XCOMM module. Even when not using loadable driver modules, this line XCOMM module. Even when not using loadable driver modules, this line
XCOMM indicates which driver should interpret the information in this section. XCOMM indicates which driver should interpret the information in this section.
Driver "vga" Driver "vesa"
XCOMM The chipset line is optional in most cases. It can be used to override XCOMM The chipset line is optional in most cases. It can be used to override
XCOMM the driver's chipset detection, and should not normally be specified. XCOMM the driver's chipset detection, and should not normally be specified.
@ -466,7 +447,7 @@ Section "Screen"
XCOMM The Identifier, Device and Monitor lines must be present XCOMM The Identifier, Device and Monitor lines must be present
Identifier "Screen 1" Identifier "Screen 1"
Device "Generic VGA" Device "Generic VESA"
Monitor "Generic Monitor" Monitor "Generic Monitor"
XCOMM The favoured Depth and/or Bpp may be specified here XCOMM The favoured Depth and/or Bpp may be specified here