Package: xserver-xorg-core
Version: 2:21.1.23-1
Severity: minor
Tags: patch
Additional remarks.
Mails from me to "[email protected]" are no longer acknowledged. A
Debian maintainer told me, that he would contact the mail administrator
about me not wanting to send bugs upstream.
-.-
Dear Maintainer,
>From "/usr/share/doc/debian/bug-reporting.txt.gz":
Don't file bugs upstream
If you file a bug in Debian, don't send a copy to the upstream software
maintainers yourself, as it is possible that the bug exists only in
Debian. If necessary, the maintainer of the package will forward the
bug upstream.
-.-
For forwarding bug reports to upstream see:
https://www.debian.org/Bugs/Developer#forward
-.-
"Handling bug reports" in
http://people.debian.org/~enrico/dcg/ch03s02.html
-.-
I do not send reports upstream if I have to get an account there.
The Debian maintainers have one already.
If I get a negative (or no) response from upstream, I send henceforth
bugs to Debian.
-.-
* What led up to the situation?
Checking for defects with a new version
test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=0 -ww -z < "man page"
[Use
grep -n -e ' $' -e '\\~$' -e ' \\f.$' -e ' \\"' <file>
to find (most) trailing spaces.]
["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).
[The fate of "test-nroff" was decided in groff bug #55941.]
* What was the outcome of this action?
-mandoc -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=0 -ww -z
* What outcome did you expect instead?
No output (no warnings).
-.-
General remarks and further material, if a diff-file exist, are in the
attachments.
-- System Information:
Debian Release: forky/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 7.0.10+deb14-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1),
LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages xserver-xorg-core depends on:
ii keyboard-configuration 1.248
ii libaudit1 1:4.1.2-1+b1
ii libc6 2.42-16
ii libdbus-1-3 1.16.2-5
ii libdrm2 2.4.134-1
ii libegl1 1.7.0-3+b1
ii libepoxy0 1.5.10-2+b2
ii libgbm1 26.0.8-1
ii libgl1 1.7.0-3+b1
ii libnettle8t64 3.10.2-1+b1
ii libpciaccess0 0.17-3+b4
ii libpixman-1-0 0.46.4-1+b2
ii libselinux1 3.10-1
ii libsystemd0 260.1-1
ii libudev1 260.1-1
ii libunwind8 1.8.1-0.4
ii libxau6 1:1.0.11-1+b2
ii libxcvt0 0.1.3-1+b2
ii libxdmcp6 1:1.1.5-2+b1
ii libxfont2 1:2.0.6-2+b1
ii libxshmfence1 1.3.3-1+b2
ii udev 260.1-1
ii xserver-common 2:21.1.23-1
Versions of packages xserver-xorg-core recommends:
pn default-logind | logind <none>
ii libgl1-mesa-dri 26.0.8-1
pn xcvt <none>
Versions of packages xserver-xorg-core suggests:
ii xfonts-100dpi 1:1.0.5
ii xfonts-75dpi 1:1.0.5
pn xfonts-scalable <none>
-- no debconf information
Input file is xorg.conf.5
Output from "mandoc -T lint xorg.conf.5": (shortened list)
8 STYLE
2 STYLE: input text line longer than 80 bytes
1 STYLE: whitespace at end of input line
6 WARNING: skipping paragraph macro
Find trailing whitespace with:
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <man page>
-.-.
Output from
test-groff mandoc -Kutf8 -ww -z xorg.conf.5: (shortened list)
4 .BI expects at least 2 arguments, got 1
8 .BR expects at least 2 arguments, got 1
1 .IR expects at least 2 arguments, got 1
22 end of sentence detected before end of text line [-w style]
1 trailing whitespace [-w trail]
Find trailing whitespace with:
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <man page>
-.-.
Remove space characters (whitespace) at the end of lines.
Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".
See more information in the attachment "trailing whitespace".
Number of lines affected is
1
-.-.
Change '-' (\-) to '\(en' (en-dash) for a (numeric) range.
GNU gnulib has recently (2023-06-18) updated its
"build_aux/update-copyright" to recognize "\(en" in man pages.
'-' is rendered as a hyphen (u2010) in UTF-8 encoding.
xorg.conf.5:1633:If this entry is omitted, a default range of 28\-33kHz is used.
xorg.conf.5:1652:If this entry is omitted, a default range of 43\-72Hz is used.
-.-.
Change two HYPHEN-MINUSES (code 0x2D) to an em-dash (\(em),
if one is intended.
" \(em " creates a too big gap in the text (in "troff").
An en-dash is usually surrounded by a space,
while an em-dash is used without spaces.
"man" (1 byte characters in input) transforms an en-dash (\(en) to one
HYPHEN-MINUS,
and an em-dash to two HYPHEN-MINUSES without considering the space
around it.
If "--" are two single "-"
(begin of an option or end of options)
then use "\-\-".
xorg.conf.5:670:"xrandr --setprovideroutputsource". Enabled by default.
-.-.
Add a (no-break, "\ " or "\~") space between a number and a unit,
as these are not one entity.
1633:If this entry is omitted, a default range of 28\-33kHz is used.
-.-.
Use the correct macro for the font change of a single argument or
split the argument into two.
640:.BR "all"
901:.BI "Option \*qCorePointer\*q"
905:.BI "Option \*qCoreKeyboard\*q"
1977:.BI " SubSection \*qDisplay\*q"
2077:.BI "Option \*qAccel\*q"
-.-.
Use the word (in)valid instead of (il)legal,
if not related to legal matters.
See "www.gnu.org/prep/standards".
Think about translations into other languages!
xorg.conf.5:1407:The legal values of
-.-.
Change a HYPHEN-MINUS (code 0x2D) to a minus(-dash) (\-),
if it
is in front of a name for an option,
is a symbol for standard input,
is a single character used to indicate an option,
or is in the NAME section (man-pages(7)).
N.B. - (0x2D), processed as a UTF-8 file, is changed to a hyphen
(0x2010, groff \[u2010] or \[hy]) in the output.
378:.I 75dpi:unscaled:pri=20 -> /usr/share/X11/fonts/75dpi
379:.I gscript:pri=60 -> /usr/share/fonts/default/ghostscript
670:"xrandr --setprovideroutputsource". Enabled by default.
788:of \*qXorg -extension ?\*q.
965:.B "-1 none (only constant deceleration is applied)"
1498:.B -seat
2063:.B -seat
2474:.B -seat
-.-.
Add a "\&" (or a comma (Oxford comma)) after an abbreviation
or use English words
(man-pages(7)).
Abbreviation points should be marked as such and protected against being
interpreted as an end of sentence, if they are not, and that independent
of the current place on the line.
668:offload-sources. Making e.g. laptop outputs connected only to the secondary
809:sections in the xorg.conf if hotplugging is in use (i.e. AutoAddDevices is
931:(i.e.
1007:profiles use it directly (i.e. they accelerate by the factor), for other
-.-.
Wrong distance (not two spaces, not a new line character (\n)) between
sentences in the input file.
Separate the sentences and subordinate clauses; each begins on a new
line. See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").
The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.
Remember coding: Only one command ("sentence") on each (logical) line.
E-mail: Easier to quote exactly the relevant lines.
Generally: Easier to edit the sentence.
Patches: Less unaffected text.
Search for two adjacent words is easier, when they belong to the same line,
and the same phrase.
The amount of space between sentences in the output can then be
controlled with the ".ss" request.
Mark a final abbreviation point as such by suffixing it with "\&".
Some sentences (etc.) do not begin on a new line.
Split (sometimes) lines after a punctuation mark; before a conjunction.
Lines with only one (or two) space(s) between sentences could be split,
so latter sentences begin on a new line.
Use
#!/usr/bin/sh
sed -e '/^\./n' \
-e 's/\([[:alpha:]]\)\. */\1.\n/g' $1
to split lines after a sentence period.
Check result with the difference between the formatted outputs.
See also the attachment "general.bugs"
[List of affected lines removed.]
-.-.
Split lines longer than 80 characters (fill completely
an A4 sized page line on a terminal)
into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.
Line 940, length 97
.BI "Option \*qTransformationMatrix\*q \*q" a " " b " " c " " d " " e " " f " "
g " " h " " i \*q
Line 2020, length 95
section to be used as a secondary GPU device for this screen. When multiple
graphics cards are
Line 2027, length 84
section in the config file. This can be specified up to 4 times for a single
screen.
Longest line is number 940 with 97 characters
-.-.
Split a punctuation mark from a single argument for a two-font macro
568:.BR xset(1).
577:.BR xset(1).
591:.BR xset(1).
605:.BR xset(1).
733:.BR SubSection,
1673:.IR modesection\-id.
2194:.BR Xorg(1)).
-.-.
The name of a man page is typeset in bold (or italic) and the section in
roman (see man-pages(7)).
17:described in the Xserver(1) and
18:Xorg(1) manual pages. Most configuration file
554:This tells the mousedrv(4) and vmmouse(4)
556:It has no effect on the evdev(4) or other drivers.
953:these can be adjusted at runtime, see the xinput(1) man page for details.
Only
-.-.
Split a punctuation from a single argument, if a two-font macro is meant.
924:.B CorePointer,
925:.B CoreKeyboard,
926:.B AlwaysCore,
928:.B SendCoreEvents,
1156:.B NoMatchProduct,
1157:.B NoMatchVendor,
1158:.B NoMatchDevicePath,
1159:.B NoMatchOS,
1160:.B NoMatchPnPID,
1161:.B NoMatchUSBID,
1162:.B NoMatchDriver,
1163:.B NoMatchTag,
1979:.I " ...
-.-.
Put a parenthetical sentence, phrase on a separate line,
if not part of a code.
See man-pages(7), item "semantic newline".
[List of affected lines removed.]
-.-.
Use a no-break space between a number and a (SI) unit
1652:If this entry is omitted, a default range of 43\-72Hz is used.
-.-.
Use a hyphen between a number and the unit (name) "bit",
see "man-pages(7)", item "Terms to avoid".
2056:where some hardware supports both a packed 24 bit framebuffer layout and a
2057:sparse 32 bit framebuffer layout.
-.-.
Only one space character is after a possible end of sentence
(after a punctuation, that can end a sentence).
[List of affected lines removed.]
-.-.
Remove quotes when there is a printable
but no space character between them
and the quotes are not for emphasis (markup),
for example as an argument to a macro.
xorg.conf.5:635:.BR "typical" ,
xorg.conf.5:638:.BR "minimal" ,
xorg.conf.5:640:.BR "all"
xorg.conf.5:797:.B "EndSection"
xorg.conf.5:846:.B "EndSection"
xorg.conf.5:1038:.B "EndSection"
xorg.conf.5:1088:.B "EndSection"
xorg.conf.5:1227:.B "EndSection"
xorg.conf.5:1274:.B "EndSection"
xorg.conf.5:1334:.B "EndSection"
xorg.conf.5:1464:.BI "VideoRam " "mem"
xorg.conf.5:1472:.BI "MemBase " "baseaddress"
xorg.conf.5:1478:.BI "IOBase " "baseaddress"
xorg.conf.5:1483:.BI "ChipID " "id"
xorg.conf.5:1489:.BI "ChipRev " "rev"
xorg.conf.5:1494:.BI "MatchSeat " "seat\-id"
xorg.conf.5:1556:.B "EndSection"
xorg.conf.5:1616:.BI "HorizSync " "horizsync\-range"
xorg.conf.5:1635:.BI "VertRefresh " "vertrefresh\-range"
xorg.conf.5:1660:.BI "Gamma " "gamma\-value"
xorg.conf.5:1928:.B "EndSection"
xorg.conf.5:1982:.B "EndSection"
xorg.conf.5:2059:.BI "MatchSeat " "seat\-id"
xorg.conf.5:2352:.B "EndSection"
xorg.conf.5:2381:.BI "Screen " "screen\-num" " \*qscreen\-id\*q "
"position\-information"
xorg.conf.5:2470:.BI "MatchSeat " "seat\-id"
xorg.conf.5:2521:.B "EndSection"
-.-.
Add "\&" after an ellipsis, when it does not end a sentence.
1825:.BI "Option \*qZoomModes\*q \*q" name " " name " " ... \*q
-.-.
Generally:
Split (sometimes) lines after a punctuation mark; before a conjunction.
-.-
Tables:
Use the preprocessor 'tbl' to make tables.
Put data, that are wider than the header in the (centered) last column,
in a "T{...\nT}" block(, when the table gets wider than the output line).
Table headings, that are wider than any data in the corresponding
column, do not need to be centered, so left adjustment (l, L) is
sufficient.
--- xorg.conf.5 2026-06-15 22:00:25.783409865 +0000
+++ xorg.conf.5.new 2026-06-15 22:46:09.120155522 +0000
@@ -14,8 +14,9 @@ than one way, the highest precedence mec
mechanisms is ordered from highest precedence to lowest. Note that not
all parameters can be supplied via all methods. The available command
line options and environment variables (and some defaults) are
-described in the Xserver(1) and
-Xorg(1) manual pages. Most configuration file
+described in the
+.BR Xserver "(1) and " Xorg (1)
+manual pages. Most configuration file
parameters, with their defaults, are described below. Driver and module
specific configuration parameters are described in the relevant driver
or module manual page.
@@ -375,11 +376,10 @@ is a number used to order the fontfile F
.PP
.RS 4
.nf
-.I 75dpi:unscaled:pri=20 -> /usr/share/X11/fonts/75dpi
-.I gscript:pri=60 -> /usr/share/fonts/default/ghostscript
+.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
.fi
-.PP
.RE
.RE
.RE
@@ -551,9 +551,14 @@ extension) to connect from another host.
Default: off.
.TP 7
.BI "Option \*qAllowMouseOpenFail\*q \*q" boolean \*q
-This tells the mousedrv(4) and vmmouse(4)
+This tells the
+.BR mousedrv (4)
+and
+.BR vmmouse (4)
drivers to not report failure if the mouse device can't be opened/initialised.
-It has no effect on the evdev(4) or other drivers.
+It has no effect on the
+.BR evdev (4)
+or other drivers.
Default: false.
.TP 7
.BI "Option \*qBlankTime\*q \*q" time \*q
@@ -565,7 +570,7 @@ is in minutes.
This is equivalent to the Xorg server's
.B \-s
flag, and the value can be changed at run\-time with
-.BR xset(1).
+.BR xset (1).
Default: 10 minutes.
.TP 7
.BI "Option \*qStandbyTime\*q \*q" time \*q
@@ -574,7 +579,7 @@ sets the inactivity timeout for the
phase of DPMS mode.
.I time
is in minutes, and the value can be changed at run\-time with
-.BR xset(1).
+.BR xset (1).
Default: 10 minutes.
This is only suitable for VESA DPMS compatible monitors, and may not be
supported by all video drivers.
@@ -588,7 +593,7 @@ sets the inactivity timeout for the
phase of DPMS mode.
.I time
is in minutes, and the value can be changed at run\-time with
-.BR xset(1).
+.BR xset (1).
Default: 10 minutes.
This is only suitable for VESA DPMS compatible monitors, and may not be
supported by all video drivers.
@@ -602,7 +607,7 @@ sets the inactivity timeout for the
phase of DPMS mode.
.I time
is in minutes, and the value can be changed at run\-time with
-.BR xset(1).
+.BR xset (1).
Default: 10 minutes.
This is only suitable for VESA DPMS compatible monitors, and may not be
supported by all video drivers.
@@ -637,7 +642,7 @@ which will setup up a typical subset of
the GLXFBConfigs provided by the driver as GLX visuals. Other options are
.BR "minimal" ,
which will set up the minimal set allowed by the GLX specification and
-.BR "all"
+.R "all"
which will setup GLX visuals for all GLXFBConfigs.
.TP 7
.BI "Option \*qUseDefaultFontPath\*q \*q" boolean \*q
@@ -665,9 +670,9 @@ backend. Enabled by default. (May need t
.TP 7
.BI "Option \*qAutoBindGPU\*q \*q" boolean \*q
If enabled then secondary GPUs will be automatically set up as output-sinks and
-offload-sources. Making e.g. laptop outputs connected only to the secondary
+offload-sources. Making e.g.\& laptop outputs connected only to the secondary
GPU directly available for use without needing to run
-"xrandr --setprovideroutputsource". Enabled by default.
+"xrandr \-\-setprovideroutputsource". Enabled by default.
.TP 7
.BI "Option \*qLog\*q \*q" string \*q
This option controls whether the log is flushed and/or synced to disk after
@@ -730,7 +735,7 @@ instruction, the standard name is case-s
"lib" prefix, or the ".a", ".o", or ".so" suffixes.
.PP
The second form of entry is a
-.BR SubSection,
+.BR SubSection ,
with the subsection name being the module name, and the contents of the
.B SubSection
being
@@ -785,7 +790,7 @@ it.
Entries in this section are listed as Option statements with the name of
the extension as the first argument, and a boolean value as the second.
The extension name is case\-sensitive, and matches the form shown in the output
-of \*qXorg -extension ?\*q.
+of \*qXorg \-extension ?\*q.
.PP
.RS 7
Example: the MIT-SHM extension can be disabled with the following entry:
@@ -806,7 +811,7 @@ Recent X servers employ HAL or udev back
and input hotplugging. It is usually not
necessary to provide
.B InputDevice
-sections in the xorg.conf if hotplugging is in use (i.e. AutoAddDevices is
+sections in the xorg.conf if hotplugging is in use (i.e.\& AutoAddDevices is
enabled). If hotplugging is enabled,
.B InputDevice
sections using the
@@ -885,7 +890,6 @@ and
.BR mousedrv (4)
on other platforms.
.PP
-.PP
.B InputDevice
sections recognise some driver\-independent
.BR Options ,
@@ -898,11 +902,11 @@ Always add the device to the ServerLayou
the server. This affects implied layouts as well as explicit layouts
specified in the configuration and/or on the command line.
.TP 7
-.BI "Option \*qCorePointer\*q"
+.B "Option \*qCorePointer\*q"
Deprecated, see
.B Floating
.TP 7
-.BI "Option \*qCoreKeyboard\*q"
+.B "Option \*qCoreKeyboard\*q"
Deprecated, see
.B Floating
.TP 7
@@ -921,14 +925,14 @@ report events through any master device
only available to clients using the X Input Extension API. This option is
disabled by default.
The options
-.B CorePointer,
-.B CoreKeyboard,
-.B AlwaysCore,
+.BR CorePointer ,
+.BR CoreKeyboard ,
+.BR AlwaysCore ,
and
-.B SendCoreEvents,
+.BR SendCoreEvents ,
are the inverse of option
.B Floating
-(i.e.
+(i.e.\&
.B SendCoreEvents \*qon\*q
is equivalent to
.B Floating \*qoff\*q
@@ -950,7 +954,9 @@ respectively. The identity matrix is "1
.SS POINTER ACCELERATION
For pointing devices, the following options control how the pointer
is accelerated or decelerated with respect to physical device motion. Most of
-these can be adjusted at runtime, see the xinput(1) man page for details. Only
+these can be adjusted at runtime, see the
+.BR xinput (1)
+man page for details. Only
the most important acceleration options are discussed here.
.TP 7
.BI "Option \*qAccelerationProfile\*q \*q" integer \*q
@@ -962,7 +968,7 @@ is constructed. This is mainly a matter
.RS 6
.nf
.B " 0 classic (mostly compatible)"
-.B "-1 none (only constant deceleration is applied)"
+.B "\-1 none (only constant deceleration is applied)"
.B " 1 device-dependent"
.B " 2 polynomial (polynomial function)"
.B " 3 smooth linear (soft knee, then linear)"
@@ -1004,7 +1010,7 @@ profiles to suit the users needs. The
.B simple
and
.B limited
-profiles use it directly (i.e. they accelerate by the factor), for other
+profiles use it directly (i.e.\& they accelerate by the factor), for other
profiles it should hold that a higher acceleration factor leads to a faster
pointer. Typically, 1 is unaccelerated and values up to 5 are sensible.
.TP 7
@@ -1079,11 +1085,11 @@ attribute. For example:
.nf
.B "Section \*qInputClass\*q"
.B " Identifier \*qMy Class\*q"
-.B " # product string must contain example and
-.B " # either gizmo or gadget
-.B " MatchProduct \*qexample\*q
-.B " MatchProduct \*qgizmo|gadget\*q
-.B " NoMatchDriver \*qdrivername\*q
+.B " # product string must contain example and"
+.B " # either gizmo or gadget"
+.B " MatchProduct \*qexample\*q"
+.B " MatchProduct \*qgizmo|gadget\*q"
+.B " NoMatchDriver \*qdrivername\*q"
.I " ..."
.B "EndSection"
.fi
@@ -1153,14 +1159,14 @@ if no named
sections have been found.
.PP
The above directives have equivalents for negative matching with the
-.B NoMatchProduct,
-.B NoMatchVendor,
-.B NoMatchDevicePath,
-.B NoMatchOS,
-.B NoMatchPnPID,
-.B NoMatchUSBID,
-.B NoMatchDriver,
-.B NoMatchTag,
+.BR NoMatchProduct ,
+.BR NoMatchVendor ,
+.BR NoMatchDevicePath ,
+.BR NoMatchOS ,
+.BR NoMatchPnPID ,
+.BR NoMatchUSBID ,
+.BR NoMatchDriver ,
+.BR NoMatchTag ,
and
.B NoMatchLayout
directives. These NoMatch directives match if the subsequent match is not
@@ -1268,8 +1274,8 @@ For example:
.nf
.B "Section \*qOutputClass\*q"
.B " Identifier \*qMy Class\*q"
-.B " # kernel driver must be either foo or bar
-.B " MatchDriver \*qfoo|bar\*q
+.B " # kernel driver must be either foo or bar"
+.B " MatchDriver \*qfoo|bar\*q"
.I " ..."
.B "EndSection"
.fi
@@ -1404,7 +1410,7 @@ section is required for each head, and t
parameter determines which head each of the
.B Device
sections applies to.
-The legal values of
+The valid values of
.I number
range from 0 to one less than the total number of heads per entity.
Most drivers require that the primary screen (0) be present.
@@ -1495,7 +1501,7 @@ when the driver-specific documentation r
Only apply this
.B Device
section if X server was started with
-.B -seat
+.B \-seat
.I seat\-id
option.
.TP 7
@@ -1630,7 +1636,7 @@ is added to the end of the line.
The data given here is used by the Xorg server to determine if video
modes are within the specifications of the monitor.
This information should be available in the monitor's handbook.
-If this entry is omitted, a default range of 28\-33kHz is used.
+If this entry is omitted, a default range of 28\(en33\ kHz is used.
.TP 7
.BI "VertRefresh " "vertrefresh\-range"
gives the range(s) of vertical refresh frequencies supported by the
@@ -1649,7 +1655,7 @@ is added to the end of the line.
The data given here is used by the Xorg server to determine if video
modes are within the specifications of the monitor.
This information should be available in the monitor's handbook.
-If this entry is omitted, a default range of 43\-72Hz is used.
+If this entry is omitted, a default range of 43\(en72\ Hz is used.
.TP 7
.BI "DisplaySize " "width height"
This optional entry gives the width and height, in millimetres, of the
@@ -1670,7 +1676,7 @@ Not all drivers are capable of using thi
Include the set of modes listed in the
.B Modes
section called
-.IR modesection\-id.
+.IR modesection\-id .
This makes all of the modes defined in that section available for use by
this monitor.
.TP 7
@@ -1973,10 +1979,10 @@ sections have the following format:
.BI " GPUDevice \*q" devid \*q
.BI " Monitor \*q" monid \*q
.I " entries"
-.I " ..."
-.BI " SubSection \*qDisplay\*q"
+.I " ...\&"
+.B " SubSection \*qDisplay\*q"
.I " entries"
-.I " ...
+.I " ..."
.B " EndSubSection"
.I " ..."
.B "EndSection"
@@ -2053,14 +2059,14 @@ The
command line option can be used to override this.
In most cases the driver will chose the best default value for this.
The only case where there is even a choice in this value is for depth 24,
-where some hardware supports both a packed 24 bit framebuffer layout and a
-sparse 32 bit framebuffer layout.
+where some hardware supports both a packed 24-bit framebuffer layout and a
+sparse 32-bit framebuffer layout.
.TP 7
.BI "MatchSeat " "seat\-id"
Only apply this
.B Screen
section if X server was started with
-.B -seat
+.B \-seat
.I seat\-id
option.
.TP 7
@@ -2074,7 +2080,7 @@ Some are driver\-specific and are descri
Others are driver\-independent, and will eventually be described here.
.\" XXX These should really be in an xaa man page.
.TP 7
-.BI "Option \*qAccel\*q"
+.B "Option \*qAccel\*q"
Enables 2D hardware acceleration.
This option is on by default, but it may be necessary to turn it off if
there are bugs in the driver.
@@ -2092,7 +2098,7 @@ Default: mesa.
.TP 7
.BI "Option \*RenderingAPI\*q \*q" string \*q
This option specifies an rendering API for use in conjunction with Glamor
-accel method. You can specify OpenGL with a value "gl" and OpenGL ES with a
+accel method. You can specify OpenGL with a value "gl" and OpenGL ES with a
value "es", and the default is both, when Glamor fallbacks to GLES if GL 2.1 is
not available. This may be useful for embedded and old cards, where GL ES
feature set works faster than GL feature set.
@@ -2191,7 +2197,7 @@ formats.
This may also be specified from the command line with the
.B \-weight
option (see
-.BR Xorg(1)).
+.BR Xorg (1)).
.TP 7
.BI "Virtual " "xdim ydim"
This optional entry specifies the virtual screen resolution to be used.
@@ -2242,7 +2248,7 @@ built-in VESA standard modes.
.BI "Visual \*q" visual\-name \*q
This optional entry sets the default root visual type.
This may also be specified from the command line (see the
-.BR Xserver(1)
+.BR Xserver (1)
man page).
The visual types available for depth 8 are (default is
.BR PseudoColor ):
@@ -2471,7 +2477,7 @@ and core keyboard devices respectively.
Only apply this
.B ServerLayout
section if X server was started with
-.B -seat
+.B \-seat
.I seat\-id
option.
.TP 7
@@ -2538,7 +2544,6 @@ entry and multiple
.B Option
flags.
The data therein is not used in this release.
-.PP
.SH "SEE ALSO"
General:
.BR X (7),
Check the output from "lintian" in the Debian distribution.
Any program (person), that produces man pages, should check the output
for defects by using (both groff and nroff)
[gn]roff -mandoc -t -ww -b -z -K utf8 <man page>
To find most trailing spaces use
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <man page>
The same goes for man pages that are used as an input.
-.-
For a style guide use
mandoc -T lint
-.-
For general input conventions consult the man page "nroff(7)" (item
"Input conventions") or the Texinfo manual about the same item.
-.-
Any "autogenerator" should check its products with the above mentioned
'groff', 'mandoc', and additionally with 'nroff ...'.
It should also check its input files for too long (> 80) lines.
This is just a simple quality control measure.
The "autogenerator" may have to be corrected to get a better man page,
the source file may, and any additional file may.
-.-
Common defects:
Not removing trailing spaces (in in- and output).
The reason for these trailing spaces should be found and eliminated.
"git" has a "tool" to point out whitespace,
see for example "git-apply(1)" and git-config(1)")
-.-
Not beginning each input sentence on a new line.
Line length and patch size should thus be reduced when that has been fixed.
The script "reportbug" uses 'quoted-printable' encoding when a line is
longer than 1024 characters in an 'ascii' file.
See man-pages(7), item "semantic newline".
-.-
The difference between the formatted output of the original
and patched file can be seen with:
nroff -mandoc <file1> > <out1>
nroff -mandoc <file2> > <out2>
diff -d -u <out1> <out2>
and for groff, using
\"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - \"
instead of 'nroff -mandoc'
Add the option '-t', if the file contains a table.
Read the output from 'diff -d -u ...' with 'less -R' or similar.
-.-.
If 'man' (man-db) is used to check the manual for warnings,
the following must be set:
The option "-warnings=w"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT="-ww -b -z"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-
--- Begin Message ---
Trailing whitespace is so unnecessary, that its presence may be removed
before files containing it are distributed.
Some programs have a tool to point out its presence, like
gcc
with option "-Wtrailing-whitespace"
git
with option "apply --whitespace=..."
and in ".git/config"
[core]
whitespace=...
grep
with option -e '[[:blank:]]$'
less
with command "/ $"
mandoc -T lint
default action
--- End Message ---
