Making the manual pages doclifter-clean

Eric S. Raymond esr at thyrsus.com
Thu Aug 23 16:45:57 PDT 2012 

I've jut applied a couple hundred small patches to the xorg repos that 
make all the manpages installed on x86 doclifter-clean.  Alan Coopersmith
tells me that the server repo shouldn't be pushed to directly, so here are
the patches you should apply to finish the cleanup.

The point of these patches is to give the page higher-level structure that
doclifter can grasp.  If you want to reproduce the old visual appearance 
exactly, tweak the definitions of .EX/.EE by adding .RS/.RE so they make a 
relative indent. Please don't use .in for that, though.

--- xorg.conf.5-unpatched	2012-07-23 22:05:05.602756617 -0400
+++ xorg.conf.5	2012-07-23 22:05:20.658756373 -0400
@@ -1,5 +1,13 @@
 .\" shorthand for double quote that works everywhere.
 .ds q \N'34'
+.de EX
+.nf
+.ft CW
+..
+.de EE
+.ft
+.fi
+..
 .TH xorg.conf 5 "xorg-server 1.11.3" "X Version 11"
 .SH NAME
 xorg.conf and xorg.conf.d \- configuration files for
@@ -33,8 +41,7 @@
 configuration file is searched for in the following places when the
 server is started as a normal user:
 .PP
-.RS 4
-.nf
+.EX
 .IR /etc/X11/ <cmdline>
 .IR /usr/etc/X11/ <cmdline>
 .IB /etc/X11/ $XORGCONFIG
@@ -45,8 +52,7 @@
 .I /usr/etc/X11/xorg.conf
 .IR /usr/lib/X11/xorg.conf. <hostname>
 .I /usr/lib/X11/xorg.conf
-.fi
-.RE
+.EE
 .PP
 where
 .I <cmdline>
@@ -63,8 +69,7 @@
 When the Xorg server is started by the \(lqroot\(rq user, the config file
 search locations are as follows:
 .PP
-.RS 4
-.nf
+.EX
 <cmdline>
 .IR /etc/X11/ <cmdline>
 .IR /usr/etc/X11/ <cmdline>
@@ -77,8 +82,7 @@
 .I /usr/etc/X11/xorg.conf
 .IR /usr/lib/X11/xorg.conf. <hostname>
 .I /usr/lib/X11/xorg.conf
-.fi
-.RE
+.EE
 .PP
 where
 .I <cmdline>
@@ -98,14 +102,12 @@
 Additional configuration files are searched for in the following
 directories when the server is started as a normal user:
 .PP
-.RS 4
-.nf
+.EX
 .IR /etc/X11/ <cmdline>
 .IR /etc/X11/ <cmdline>
 .I /etc/X11/xorg.conf.d
 .I /etc/X11/xorg.conf.d
-.fi
-.RE
+.EE
 .PP
 where
 .I <cmdline>
@@ -116,15 +118,13 @@
 When the Xorg server is started by the \(lqroot\(rq user, the
 config directory search locations are as follows:
 .PP
-.RS 4
-.nf
+.EX
 <cmdline>
 .IR /etc/X11/ <cmdline>
 .IR /etc/X11/ <cmdline>
 .I /etc/X11/xorg.conf.d
 .I /etc/X11/xorg.conf.d
-.fi
-.RE
+.EE
 .PP
 where
 .I <cmdline>
@@ -137,12 +137,10 @@
 the vendor or 3rd party packages from those of local administration.
 These files are found in the following directories:
 .PP
-.RS 4
-.nf
+.EX
 .I /usr/share/X11/xorg.conf.d
 .I /usr/share/X11/xorg.conf.d
-.fi
-.RE
+.EE
 .PP
 The
 .I xorg.conf
@@ -152,19 +150,16 @@
 or omitted to use default configuration values.
 Each section has the form:
 .PP
-.RS 4
-.nf
+.EX
 .BI "Section  \*q" SectionName \*q
 .RI "    " SectionEntry
     ...
 .B EndSection
-.fi
-.RE
+.EE
 .PP
 The section names are:
 .PP
-.RS 4
-.nf
+.EX
 .BR "Files          " "File pathnames"
 .BR "ServerFlags    " "Server flags"
 .BR "Module         " "Dynamic module loading"
@@ -179,8 +174,7 @@
 .BR "ServerLayout   " "Overall layout"
 .BR "DRI            " "DRI\-specific configuration"
 .BR "Vendor         " "Vendor\-specific configuration"
-.fi
-.RE
+.EE
 .PP
 The following obsolete section names are still recognised for compatibility
 purposes.
@@ -188,12 +182,10 @@
 .B InputDevice
 section should be used instead.
 .PP
-.RS 4
-.nf
+.EX
 .BR "Keyboard       " "Keyboard configuration"
 .BR "Pointer        " "Pointer/mouse configuration"
-.fi
-.RE
+.EE
 .PP
 The old
 .B XInput
@@ -234,13 +226,11 @@
 with the number and types of the arguments depending on the keyword.
 The argument types are:
 .PP
-.RS 4
-.nf
+.EX
 .BR "Integer     " "an integer number in decimal, hex or octal"
 .BR "Real        " "a floating point number"
 .BR "String      " "a string enclosed in double quote marks (\*q)"
-.fi
-.RE
+.EE
 .PP
 Note: hex integer values must be prefixed with \(lq0x\(rq, and octal values
 with \(lq0\(rq.
@@ -255,15 +245,13 @@
 option value.
 Some commonly used option value types include:
 .PP
-.RS 4
-.nf
+.EX
 .BR "Integer     " "an integer number in decimal, hex or octal"
 .BR "Real        " "a floating point number"
 .BR "String      " "a sequence of characters"
 .BR "Boolean     " "a boolean value (see below)"
 .BR "Frequency   " "a frequency value (see below)"
-.fi
-.RE
+.EE
 .PP
 Note that
 .I all
@@ -299,15 +287,13 @@
 .PP
 Example: the following option entries are equivalent:
 .PP
-.RS 4
-.nf
+.EX
 .B "Option \*qAccel\*q   \*qOff\*q"
 .B "Option \*qNoAccel\*q"
 .B "Option \*qNoAccel\*q \*qOn\*q"
 .B "Option \*qAccel\*q   \*qfalse\*q"
 .B "Option \*qAccel\*q   \*qno\*q"
-.fi
-.RE
+.EE
 .PP
 Frequency option values consist of a real number that is optionally
 followed by one of the following frequency units:
@@ -372,8 +358,7 @@
 .I <priority>
 is a number used to order the fontfile FPEs. Examples:
 .PP
-.RS 4
-.nf
+.EX
 .I 75dpi:unscaled:pri=20  -> /usr/share/X11/fonts/75dpi
 .I gscript:pri=60 -> /usr/share/fonts/default/ghostscript
 .I misc:unscaled:pri=10 \-> /usr/share/X11/fonts/misc
@@ -408,16 +393,14 @@
 to the compiled\-in default font path, which contains the following
 font path elements (which can be set inside a catalogue directory):
 .PP
-.RS 4
-.nf
+.EX
 .I /usr/share/fonts/X11/misc/
 .I /usr/share/fonts/X11/TTF/
 .I /usr/share/fonts/X11/OTF/
 .I /usr/share/fonts/X11/Type1/
 .I /usr/share/fonts/X11/100dpi/
 .I /usr/share/fonts/X11/75dpi/
-.fi
-.RE
+.EE
 .PP
 Font path elements that are found to be invalid are removed from the
 font path when the server starts up.
@@ -432,9 +415,9 @@
 entries may be specified, and they will be concatenated to build the
 module search path used by the server.  The default module path is
 .PP
-.RS 11
+.EX
 /usr/lib/xorg/modules
-.RE
+.EE
 .\" The LogFile keyword is not currently implemented
 .ig
 .TP 7
@@ -442,9 +425,9 @@
 sets the name of the Xorg server log file.
 The default log file name is
 .PP
-.RS 11
+.EX
 .RI /var/log/Xorg. <n> .log
-.RE
+.EE
 .PP
 .RS 7
 where
@@ -457,9 +440,9 @@
 .B \-xkbdir
 command line option can be used to override this.  The default directory is
 .PP
-.RS 11
+.EX
 /usr/share/X11/xkb
-.RE
+.EE
 .SH "SERVERFLAGS SECTION"
 In addition to options specific to this section (described below), the
 .B ServerFlags
@@ -753,13 +736,11 @@
 server extensions) can be loaded, with the XFree86\-DGA extension
 disabled by using the following entry:
 .PP
-.RS 4
-.nf
+.EX
 .B "SubSection \*qextmod\*q"
 .B "   Option  \*qomit XFree86\-DGA\*q"
 .B EndSubSection
-.fi
-.RE
+.EE
 .PP
 Modules are searched for in each directory specified in the
 .B ModulePath
@@ -771,11 +752,9 @@
 To see what extension modules are available, check the extensions
 subdirectory under:
 .PP
-.RS 4
-.nf
+.EX
 /usr/lib/xorg/modules
-.fi
-.RE
+.EE
 .PP
 The \(lqextmod\(rq, \(lqdbe\(rq, \(lqdri\(rq, \(lqdri2\(rq, \(lqglx\(rq,
 and \(lqrecord\(rq extension modules are loaded automatically, if they
@@ -802,13 +781,11 @@
 .RS 7
 Example: the MIT-SHM extension can be disabled with the following entry:
 .PP
-.RS 4
-.nf
+.EX
 .B "Section \*qExtensions\*q"
 .B "    Option \*qMIT-SHM\*q \*qDisable\*q"
 .B "EndSection"
-.fi
-.RE
+.EE
 .RE
 .SH "INPUTDEVICE SECTION"
 The config file may have multiple
@@ -848,16 +825,14 @@
 .B InputDevice
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qInputDevice\*q"
 .BI "    Identifier \*q" name \*q
 .BI "    Driver     \*q" inputdriver \*q
 .I  "    options"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 The
 .B Identifier
@@ -982,8 +957,7 @@
 .B  " 5      power (power function)"
 .B  " 6      linear (more speed, more acceleration)"
 .B  " 7      limited (like linear, but maxes out at threshold)"
-.fi
-.RE
+.EE
 .TP 7
 .BI "Option \*qConstantDeceleration\*q  \*q" real \*q
 Makes the pointer go
@@ -1003,8 +977,7 @@
 .B  "predictable   default algorithm (behaving more predictable)"
 .B  "lightweight   old acceleration code (as specified in the X protocol spec)"
 .B  "none          no acceleration or deceleration"
-.fi
-.RE
+.EE
 .TP 7
 .BI "Option \*qAccelerationNumerator\*q  \*q" integer \*q
 .TP 7
@@ -1038,8 +1011,7 @@
 .B InputClass
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qInputClass\*q"
 .BI "    Identifier  \*q" name \*q
 .I  "    entries"
@@ -1047,8 +1019,7 @@
 .I  "    options"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 The
 .B Identifier
@@ -1086,8 +1057,7 @@
 same type may be supplied to add multiple matching conditions on the same
 attribute. For example:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qInputClass\*q"
 .B  "    Identifier   \*qMy Class\*q"
 .B  "    # product string must contain example and
@@ -1096,8 +1066,7 @@
 .B  "    MatchProduct \*qgizmo|gadget\*q
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .TP 7
 .BI "MatchProduct  \*q" matchproduct \*q
 This entry can be used to check if the substring
@@ -1206,16 +1175,14 @@
 .B Device
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qDevice\*q"
 .BI "    Identifier \*q" name \*q
 .BI "    Driver     \*q" driver \*q
 .I  "    entries"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 The
 .B Identifier
@@ -1417,15 +1384,13 @@
 .B Monitor
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qMonitor\*q"
 .BI "    Identifier \*q" name \*q
 .I  "    entries"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 The only mandatory entry in a
 .B Monitor
@@ -1772,15 +1737,13 @@
 .B Modes
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qModes\*q"
 .BI "    Identifier \*q" name \*q
 .I  "    entries"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 The
 .B Identifier
@@ -1818,8 +1781,7 @@
 .B Screen
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qScreen\*q"
 .BI "    Identifier \*q" name \*q
 .BI "    Device     \*q" devid \*q
@@ -1832,8 +1794,7 @@
 .B  "    EndSubSection"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 The
 .B Identifier
@@ -2034,15 +1995,13 @@
 .B Display
 subsections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "    SubSection \*qDisplay\*q"
 .BI "        Depth  " depth
 .I  "        entries"
 .I  "        ..."
 .B  "    EndSubSection"
-.fi
-.RE
+.EE
 .TP 7
 .BI "Depth  " depth
 This entry specifies what colour depth the
@@ -2140,27 +2099,23 @@
 The visual types available for depth 8 are (default is
 .BR PseudoColor ):
 .PP
-.RS 11
-.nf
+.EX
 .B StaticGray
 .B GrayScale
 .B StaticColor
 .B PseudoColor
 .B TrueColor
 .B DirectColor
-.fi
-.RE
+.EE
 .PP
 .RS 7
 The visual type available for the depths 15, 16 and 24 are (default is
 .BR TrueColor ):
 .PP
-.RS 4
-.nf
+.EX
 .B TrueColor
 .B DirectColor
-.fi
-.RE
+.EE
 .PP
 Not all drivers support
 .B DirectColor
@@ -2169,14 +2124,12 @@
 The visual types available for the depth 4 are (default is
 .BR StaticColor ):
 .PP
-.RS 4
-.nf
+.EX
 .B StaticGray
 .B GrayScale
 .B StaticColor
 .B PseudoColor
-.fi
-.RE
+.EE
 .PP
 The visual type available for the depth 1 (monochrome) is
 .BR StaticGray .
@@ -2232,8 +2185,7 @@
 .B ServerLayout
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qServerLayout\*q"
 .BI "    Identifier   \*q" name \*q
 .BI "    Screen       \*q" screen\-id \*q
@@ -2243,8 +2195,7 @@
 .I  "    options"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 Each
 .B ServerLayout
@@ -2347,18 +2298,13 @@
 Normally only session\-specific input device options would be used here.
 The most commonly used options are:
 .PP
-.RS 11
-.nf
+.EX
 .B \*qCorePointer\*q
 .B \*qCoreKeyboard\*q
 .B \*qSendCoreEvents\*q
-.fi
-.RE
-.PP
-.RS 7
+.EE
 and the first two should normally be used to indicate the core pointer
 and core keyboard devices respectively.
-.RE
 .TP 7
 .B Options
 In addition to the following, any option permitted in the
@@ -2393,8 +2339,7 @@
 .B ServerLayout
 section for a dual headed configuration with two mice:
 .PP
-.RS 4
-.nf
+.EX
 .B "Section \*qServerLayout\*q"
 .B "    Identifier  \*qLayout 1\*q"
 .B "    Screen      \*qMGA 1\*q"
@@ -2404,8 +2349,7 @@
 .B "    InputDevice \*qMouse 2\*q    \*qSendCoreEvents\*q"
 .B "    Option      \*qBlankTime\*q  \*q5\*q"
 .B "EndSection"
-.fi
-.RE
+.EE
 .SH "DRI SECTION"
 This optional section is used to provide some information for the
 Direct Rendering Infrastructure.
--- xorg.conf.d.5-unpatched	2012-07-23 22:05:05.602756617 -0400
+++ xorg.conf.d.5	2012-07-23 22:05:20.658756373 -0400
@@ -1,5 +1,13 @@
 .\" shorthand for double quote that works everywhere.
 .ds q \N'34'
+.de EX
+.nf
+.ft CW
+..
+.de EE
+.ft
+.fi
+..
 .TH xorg.conf 5 "xorg-server 1.11.3" "X Version 11"
 .SH NAME
 xorg.conf and xorg.conf.d \- configuration files for
@@ -33,8 +41,7 @@
 configuration file is searched for in the following places when the
 server is started as a normal user:
 .PP
-.RS 4
-.nf
+.EX
 .IR /etc/X11/ <cmdline>
 .IR /usr/etc/X11/ <cmdline>
 .IB /etc/X11/ $XORGCONFIG
@@ -45,8 +52,7 @@
 .I /usr/etc/X11/xorg.conf
 .IR /usr/lib/X11/xorg.conf. <hostname>
 .I /usr/lib/X11/xorg.conf
-.fi
-.RE
+.EE
 .PP
 where
 .I <cmdline>
@@ -63,8 +69,7 @@
 When the Xorg server is started by the \(lqroot\(rq user, the config file
 search locations are as follows:
 .PP
-.RS 4
-.nf
+.EX
 <cmdline>
 .IR /etc/X11/ <cmdline>
 .IR /usr/etc/X11/ <cmdline>
@@ -77,8 +82,7 @@
 .I /usr/etc/X11/xorg.conf
 .IR /usr/lib/X11/xorg.conf. <hostname>
 .I /usr/lib/X11/xorg.conf
-.fi
-.RE
+.EE
 .PP
 where
 .I <cmdline>
@@ -98,14 +102,12 @@
 Additional configuration files are searched for in the following
 directories when the server is started as a normal user:
 .PP
-.RS 4
-.nf
+.EX
 .IR /etc/X11/ <cmdline>
 .IR /etc/X11/ <cmdline>
 .I /etc/X11/xorg.conf.d
 .I /etc/X11/xorg.conf.d
-.fi
-.RE
+.EE
 .PP
 where
 .I <cmdline>
@@ -116,15 +118,13 @@
 When the Xorg server is started by the \(lqroot\(rq user, the
 config directory search locations are as follows:
 .PP
-.RS 4
-.nf
+.EX
 <cmdline>
 .IR /etc/X11/ <cmdline>
 .IR /etc/X11/ <cmdline>
 .I /etc/X11/xorg.conf.d
 .I /etc/X11/xorg.conf.d
-.fi
-.RE
+.EE
 .PP
 where
 .I <cmdline>
@@ -137,12 +137,10 @@
 the vendor or 3rd party packages from those of local administration.
 These files are found in the following directories:
 .PP
-.RS 4
-.nf
+.EX
 .I /usr/share/X11/xorg.conf.d
 .I /usr/share/X11/xorg.conf.d
-.fi
-.RE
+.EE
 .PP
 The
 .I xorg.conf
@@ -152,19 +150,16 @@
 or omitted to use default configuration values.
 Each section has the form:
 .PP
-.RS 4
-.nf
+.EX
 .BI "Section  \*q" SectionName \*q
 .RI "    " SectionEntry
     ...
 .B EndSection
-.fi
-.RE
+.EE
 .PP
 The section names are:
 .PP
-.RS 4
-.nf
+.EX
 .BR "Files          " "File pathnames"
 .BR "ServerFlags    " "Server flags"
 .BR "Module         " "Dynamic module loading"
@@ -179,8 +174,7 @@
 .BR "ServerLayout   " "Overall layout"
 .BR "DRI            " "DRI\-specific configuration"
 .BR "Vendor         " "Vendor\-specific configuration"
-.fi
-.RE
+.EE
 .PP
 The following obsolete section names are still recognised for compatibility
 purposes.
@@ -188,12 +182,10 @@
 .B InputDevice
 section should be used instead.
 .PP
-.RS 4
-.nf
+.EX
 .BR "Keyboard       " "Keyboard configuration"
 .BR "Pointer        " "Pointer/mouse configuration"
-.fi
-.RE
+.EE
 .PP
 The old
 .B XInput
@@ -234,13 +226,11 @@
 with the number and types of the arguments depending on the keyword.
 The argument types are:
 .PP
-.RS 4
-.nf
+.EX
 .BR "Integer     " "an integer number in decimal, hex or octal"
 .BR "Real        " "a floating point number"
 .BR "String      " "a string enclosed in double quote marks (\*q)"
-.fi
-.RE
+.EE
 .PP
 Note: hex integer values must be prefixed with \(lq0x\(rq, and octal values
 with \(lq0\(rq.
@@ -255,15 +245,13 @@
 option value.
 Some commonly used option value types include:
 .PP
-.RS 4
-.nf
+.EX
 .BR "Integer     " "an integer number in decimal, hex or octal"
 .BR "Real        " "a floating point number"
 .BR "String      " "a sequence of characters"
 .BR "Boolean     " "a boolean value (see below)"
 .BR "Frequency   " "a frequency value (see below)"
-.fi
-.RE
+.EE
 .PP
 Note that
 .I all
@@ -299,15 +287,13 @@
 .PP
 Example: the following option entries are equivalent:
 .PP
-.RS 4
-.nf
+.EX
 .B "Option \*qAccel\*q   \*qOff\*q"
 .B "Option \*qNoAccel\*q"
 .B "Option \*qNoAccel\*q \*qOn\*q"
 .B "Option \*qAccel\*q   \*qfalse\*q"
 .B "Option \*qAccel\*q   \*qno\*q"
-.fi
-.RE
+.EE
 .PP
 Frequency option values consist of a real number that is optionally
 followed by one of the following frequency units:
@@ -372,8 +358,7 @@
 .I <priority>
 is a number used to order the fontfile FPEs. Examples:
 .PP
-.RS 4
-.nf
+.EX
 .I 75dpi:unscaled:pri=20  -> /usr/share/X11/fonts/75dpi
 .I gscript:pri=60 -> /usr/share/fonts/default/ghostscript
 .I misc:unscaled:pri=10 \-> /usr/share/X11/fonts/misc
@@ -408,16 +393,14 @@
 to the compiled\-in default font path, which contains the following
 font path elements (which can be set inside a catalogue directory):
 .PP
-.RS 4
-.nf
+.EX
 .I /usr/share/fonts/X11/misc/
 .I /usr/share/fonts/X11/TTF/
 .I /usr/share/fonts/X11/OTF/
 .I /usr/share/fonts/X11/Type1/
 .I /usr/share/fonts/X11/100dpi/
 .I /usr/share/fonts/X11/75dpi/
-.fi
-.RE
+.EE
 .PP
 Font path elements that are found to be invalid are removed from the
 font path when the server starts up.
@@ -432,9 +415,9 @@
 entries may be specified, and they will be concatenated to build the
 module search path used by the server.  The default module path is
 .PP
-.RS 11
+.EX
 /usr/lib/xorg/modules
-.RE
+.EE
 .\" The LogFile keyword is not currently implemented
 .ig
 .TP 7
@@ -442,9 +425,9 @@
 sets the name of the Xorg server log file.
 The default log file name is
 .PP
-.RS 11
+.EX
 .RI /var/log/Xorg. <n> .log
-.RE
+.EE
 .PP
 .RS 7
 where
@@ -457,9 +440,9 @@
 .B \-xkbdir
 command line option can be used to override this.  The default directory is
 .PP
-.RS 11
+.EX
 /usr/share/X11/xkb
-.RE
+.EE
 .SH "SERVERFLAGS SECTION"
 In addition to options specific to this section (described below), the
 .B ServerFlags
@@ -753,13 +736,11 @@
 server extensions) can be loaded, with the XFree86\-DGA extension
 disabled by using the following entry:
 .PP
-.RS 4
-.nf
+.EX
 .B "SubSection \*qextmod\*q"
 .B "   Option  \*qomit XFree86\-DGA\*q"
 .B EndSubSection
-.fi
-.RE
+.EE
 .PP
 Modules are searched for in each directory specified in the
 .B ModulePath
@@ -771,11 +752,9 @@
 To see what extension modules are available, check the extensions
 subdirectory under:
 .PP
-.RS 4
-.nf
+.EX
 /usr/lib/xorg/modules
-.fi
-.RE
+.EE
 .PP
 The \(lqextmod\(rq, \(lqdbe\(rq, \(lqdri\(rq, \(lqdri2\(rq, \(lqglx\(rq,
 and \(lqrecord\(rq extension modules are loaded automatically, if they
@@ -802,13 +781,11 @@
 .RS 7
 Example: the MIT-SHM extension can be disabled with the following entry:
 .PP
-.RS 4
-.nf
+.EX
 .B "Section \*qExtensions\*q"
 .B "    Option \*qMIT-SHM\*q \*qDisable\*q"
 .B "EndSection"
-.fi
-.RE
+.EE
 .RE
 .SH "INPUTDEVICE SECTION"
 The config file may have multiple
@@ -848,16 +825,14 @@
 .B InputDevice
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qInputDevice\*q"
 .BI "    Identifier \*q" name \*q
 .BI "    Driver     \*q" inputdriver \*q
 .I  "    options"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 The
 .B Identifier
@@ -982,8 +957,7 @@
 .B  " 5      power (power function)"
 .B  " 6      linear (more speed, more acceleration)"
 .B  " 7      limited (like linear, but maxes out at threshold)"
-.fi
-.RE
+.EE
 .TP 7
 .BI "Option \*qConstantDeceleration\*q  \*q" real \*q
 Makes the pointer go
@@ -1003,8 +977,7 @@
 .B  "predictable   default algorithm (behaving more predictable)"
 .B  "lightweight   old acceleration code (as specified in the X protocol spec)"
 .B  "none          no acceleration or deceleration"
-.fi
-.RE
+.EE
 .TP 7
 .BI "Option \*qAccelerationNumerator\*q  \*q" integer \*q
 .TP 7
@@ -1038,8 +1011,7 @@
 .B InputClass
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qInputClass\*q"
 .BI "    Identifier  \*q" name \*q
 .I  "    entries"
@@ -1047,8 +1019,7 @@
 .I  "    options"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 The
 .B Identifier
@@ -1086,8 +1057,7 @@
 same type may be supplied to add multiple matching conditions on the same
 attribute. For example:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qInputClass\*q"
 .B  "    Identifier   \*qMy Class\*q"
 .B  "    # product string must contain example and
@@ -1096,8 +1066,7 @@
 .B  "    MatchProduct \*qgizmo|gadget\*q
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .TP 7
 .BI "MatchProduct  \*q" matchproduct \*q
 This entry can be used to check if the substring
@@ -1206,16 +1175,14 @@
 .B Device
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qDevice\*q"
 .BI "    Identifier \*q" name \*q
 .BI "    Driver     \*q" driver \*q
 .I  "    entries"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 The
 .B Identifier
@@ -1417,15 +1384,13 @@
 .B Monitor
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qMonitor\*q"
 .BI "    Identifier \*q" name \*q
 .I  "    entries"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 The only mandatory entry in a
 .B Monitor
@@ -1772,15 +1737,13 @@
 .B Modes
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qModes\*q"
 .BI "    Identifier \*q" name \*q
 .I  "    entries"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 The
 .B Identifier
@@ -1818,8 +1781,7 @@
 .B Screen
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qScreen\*q"
 .BI "    Identifier \*q" name \*q
 .BI "    Device     \*q" devid \*q
@@ -1832,8 +1794,7 @@
 .B  "    EndSubSection"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 The
 .B Identifier
@@ -2034,15 +1995,13 @@
 .B Display
 subsections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "    SubSection \*qDisplay\*q"
 .BI "        Depth  " depth
 .I  "        entries"
 .I  "        ..."
 .B  "    EndSubSection"
-.fi
-.RE
+.EE
 .TP 7
 .BI "Depth  " depth
 This entry specifies what colour depth the
@@ -2140,27 +2099,23 @@
 The visual types available for depth 8 are (default is
 .BR PseudoColor ):
 .PP
-.RS 11
-.nf
+.EX
 .B StaticGray
 .B GrayScale
 .B StaticColor
 .B PseudoColor
 .B TrueColor
 .B DirectColor
-.fi
-.RE
+.EE
 .PP
 .RS 7
 The visual type available for the depths 15, 16 and 24 are (default is
 .BR TrueColor ):
 .PP
-.RS 4
-.nf
+.EX
 .B TrueColor
 .B DirectColor
-.fi
-.RE
+.EE
 .PP
 Not all drivers support
 .B DirectColor
@@ -2169,14 +2124,12 @@
 The visual types available for the depth 4 are (default is
 .BR StaticColor ):
 .PP
-.RS 4
-.nf
+.EX
 .B StaticGray
 .B GrayScale
 .B StaticColor
 .B PseudoColor
-.fi
-.RE
+.EE
 .PP
 The visual type available for the depth 1 (monochrome) is
 .BR StaticGray .
@@ -2232,8 +2185,7 @@
 .B ServerLayout
 sections have the following format:
 .PP
-.RS 4
-.nf
+.EX
 .B  "Section \*qServerLayout\*q"
 .BI "    Identifier   \*q" name \*q
 .BI "    Screen       \*q" screen\-id \*q
@@ -2243,8 +2195,7 @@
 .I  "    options"
 .I  "    ..."
 .B  "EndSection"
-.fi
-.RE
+.EE
 .PP
 Each
 .B ServerLayout
@@ -2347,18 +2298,13 @@
 Normally only session\-specific input device options would be used here.
 The most commonly used options are:
 .PP
-.RS 11
-.nf
+.EX
 .B \*qCorePointer\*q
 .B \*qCoreKeyboard\*q
 .B \*qSendCoreEvents\*q
-.fi
-.RE
-.PP
-.RS 7
+.EE
 and the first two should normally be used to indicate the core pointer
 and core keyboard devices respectively.
-.RE
 .TP 7
 .B Options
 In addition to the following, any option permitted in the
@@ -2393,8 +2339,7 @@
 .B ServerLayout
 section for a dual headed configuration with two mice:
 .PP
-.RS 4
-.nf
+.EX
 .B "Section \*qServerLayout\*q"
 .B "    Identifier  \*qLayout 1\*q"
 .B "    Screen      \*qMGA 1\*q"
@@ -2404,8 +2349,7 @@
 .B "    InputDevice \*qMouse 2\*q    \*qSendCoreEvents\*q"
 .B "    Option      \*qBlankTime\*q  \*q5\*q"
 .B "EndSection"
-.fi
-.RE
+.EE
 .SH "DRI SECTION"
 This optional section is used to provide some information for the
 Direct Rendering Infrastructure.

-- 
		<a href="http://www.catb.org/~esr/">Eric S. Raymond</a>

More information about the xorg-devel mailing list