Bug#919142: Xorg.1: Some formatting and word corrections in the manual
Package: xserver-xorg-core
Version: 2:1.20.3-1
Severity: minor
Tags: patch
Dear Maintainer,
see man-pages(7) for a style guide.
--- Xorg.1 2018-10-25 18:15:23.000000000 +0000
+++ Xorg.1.new 2019-01-13 05:09:21.000000000 +0000
@@ -3,12 +3,12 @@
.ds q \N'34'
.TH Xorg 1 "xorg-server 1.20.3" "X Version 11"
.SH NAME
-Xorg - X11R7 X server
+Xorg \- X11R7 X server
.SH SYNOPSIS
.B Xorg
.RI [\fB:\fP display ]
.RI [ option
-.IR ... ]
+.IR \&.\|.\|.\& ]
.SH DESCRIPTION
.B Xorg
is a full featured X server that was originally designed for UNIX and
@@ -33,19 +33,22 @@ free/OpenSource UNIX-like systems such a
OpenBSD, and Solaris. Commercial UNIX operating systems such as
UnixWare are also supported. Other supported operating systems include
GNU Hurd. Mac OS X is supported with the
-Xquartz(1) X server. Win32/Cygwin is supported with the
-XWin(1) X server.
-.PP
+.BR Xquartz (1)
+X server. Win32/Cygwin is supported with the
+.BR XWin (1)
+X server.
.SH "NETWORK CONNECTIONS"
.B Xorg
supports connections made using the following reliable
byte-streams:
.TP 4
-.I "Local"
+.I Local
On most platforms, the "Local" connection type is a UNIX-domain socket.
On some System V platforms, the "local" connection types also include
STREAMS pipes, named pipes, and some other mechanisms. See the
-"LOCAL CONNECTIONS" section of X(7) for details.
+"LOCAL CONNECTIONS" section of
+.BR X (7)
+for details.
.TP 4
.I TCP/IP
.B Xorg
@@ -56,12 +59,15 @@ where
is the display number. This connection type is usually disabled by default,
but may be enabled with the
.B \-listen
-option (see the Xserver(1) man page for details).
+option (see the
+.BR Xserver (1)
+man page for details).
.SH OPTIONS
.B Xorg
supports several mechanisms for supplying/obtaining configuration and
run-time parameters: command line options, environment variables, the
-xorg.conf(5) configuration files, auto-detection, and
+.BR xorg.conf (5)
+configuration files, auto-detection, and
fallback defaults. When the same information is supplied in more than
one way, the highest precedence mechanism is used. The list of mechanisms
is ordered from highest precedence to lowest. Note that not all parameters
@@ -69,12 +75,14 @@ can be supplied via all methods. The av
and environment variables (and some defaults) are described here and in
the Xserver(1) manual page. Most configuration file
parameters, with their defaults, are described in the
-xorg.conf(5) manual page. Driver and module specific
+.BR xorg.conf (5)
+manual page. Driver and module specific
configuration parameters are described in the relevant driver or module
manual page.
.PP
In addition to the normal server options described in the
-Xserver(1) manual page,
+.BR Xserver (1)
+manual page,
.B Xorg
accepts the following command line switches:
.TP 8
@@ -92,14 +100,16 @@ as Linux, BSD, OpenSolaris, SVR3, and SV
Allow the server to start up even if the mouse device can't be opened
or initialised. This is equivalent to the
.B AllowMouseOpenFail
-xorg.conf(5) file option.
+.BR xorg.conf (5)
+file option.
.TP 8
.B \-allowNonLocalXvidtune
Make the VidMode extension available to remote clients. This allows
the xvidtune client to connect from another host. This is equivalent
to the
.B AllowNonLocalXvidtune
-xorg.conf(5) file option. By default non-local
+.BR xorg.conf (5)
+file option. By default non-local
connections are not allowed.
.TP 8
.BI \-bgamma " value"
@@ -139,7 +149,9 @@ config directory search path for all oth
When this option is specified, the
.B Xorg
server loads all video driver modules, probes for available hardware,
-and writes out an initial xorg.conf(5) file based on
+and writes out an initial
+.BR xorg.conf (5)
+file based on
what was detected. This option currently has some problems on some
platforms, but in most cases it is a good way to bootstrap the
configuration process. This option is only available when the server
@@ -151,7 +163,7 @@ SCO only. This is the same as the
option, and is provided for compatibility with the native SCO X server.
.TP 8
.BI \-depth " n"
-Sets the default color depth. Legal values are 1, 4, 8, 15, 16, and
+Sets the default color depth. Valid values are 1, 4, 8, 15, 16, and
24. Not all drivers support all values.
.TP 8
.B \-disableVidMode
@@ -159,7 +171,8 @@ Disable the parts of the VidMode extensi
client) that can be used to change the video modes. This is equivalent
to the
.B DisableVidModeExtension
-xorg.conf(5) file option.
+.BR xorg.conf (5)
+file option.
.TP 8
.B \-fbbpp \fIn\fP
Sets the number of framebuffer bits per pixel. You should only set this
@@ -168,7 +181,7 @@ value from
.B \-depth
above. Useful if you want to run a depth 24 configuration with a 24
bpp framebuffer rather than the (possibly default) 32 bpp framebuffer
-(or vice versa). Legal values are 1, 8, 16, 24, 32. Not all drivers
+(or vice versa). Valid values are 1, 8, 16, 24, 32. Not all drivers
support all values.
.TP 8
.B \-flipPixels
@@ -221,12 +234,14 @@ is ignored if
is anything other than \(oqPCI\(cq.
.TP 8
.B \-keeptty
-Prevent the server from detaching its initial controlling terminal. If you
+Prevent the server from detaching its initial controlling terminal. If you
want to use systemd-logind integration you must specify this option.
Not all platforms support (or can use) this option.
.TP 8
.BI \-keyboard " keyboard-name"
-Use the xorg.conf(5) file
+Use the
+.BR xorg.conf (5)
+file
.B InputDevice
section called
.I keyboard-name
@@ -238,7 +253,9 @@ section and this option, the first relev
section is used for the core keyboard.
.TP 8
.BI \-layout " layout-name"
-Use the xorg.conf(5) file
+Use the
+.BR xorg.conf (5)
+file
.B Layout
section called
.IR layout-name .
@@ -291,7 +308,9 @@ Disable the automatic switching on X ser
VT that was active when the server started, if supported by the OS.
.TP 8
.BI \-pointer " pointer-name"
-Use the xorg.conf(5) file
+Use the
+.BR xorg.conf (5)
+file
.B InputDevice
section called
.I pointer-name
@@ -321,7 +340,9 @@ options.
Share virtual terminals with another X server, if supported by the OS.
.TP 8
.BI \-screen " screen-name"
-Use the xorg.conf(5) file
+Use the
+.BR xorg.conf (5)
+file
.B Screen
section called
.IR screen-name .
@@ -374,7 +395,7 @@ The
.B Xorg
server is normally configured to recognize various special combinations
of key presses that instruct the server to perform some action, rather
-than just sending the key press event to a client application. These actions
+than just sending the key press event to a client application. These actions
depend on the XKB keymap loaded by a particular keyboard device and may or
may not be available on a given configuration.
.PP
@@ -382,15 +403,16 @@ The following key combinations are commo
keymap.
.TP 8
.B Ctrl+Alt+Backspace
-Immediately kills the server -- no questions asked. It can be disabled by
-setting the
+Immediately kills the server \(en no questions asked.
+It can be disabled by setting the
.B DontZap
-xorg.conf(5) file option to a TRUE value.
+.BR xorg.conf (5)
+file option to a TRUE value.
.PP
.RS 8
It should be noted that zapping is triggered by the
.B Terminate_Server
-action in the keyboard map. This action is not part of the default keymaps
+action in the keyboard map. This action is not part of the default keymaps
but can be enabled with the XKB option
.B \*qterminate:ctrl_alt_bksp\*q.
.RE
@@ -399,20 +421,23 @@ but can be enabled with the XKB option
Change video mode to next one specified in the configuration file.
This can be disabled with the
.B DontZoom
-xorg.conf(5) file option.
+.BR xorg.conf (5)
+file option.
.TP 8
.B Ctrl+Alt+Keypad-Minus
Change video mode to previous one specified in the configuration file.
This can be disabled with the
.B DontZoom
-xorg.conf(5) file option.
+.BR xorg.conf (5)
+file option.
.TP 8
-.B Ctrl+Alt+F1...F12
+.B Ctrl+Alt+F1\|.\|.\|.F12
For systems with virtual terminal support, these keystroke
combinations are used to switch to virtual terminals 1 through 12,
respectively. This can be disabled with the
.B DontVTSwitch
-xorg.conf(5) file option.
+.BR xorg.conf (5)
+file option.
.SH CONFIGURATION
.B Xorg
typically uses a configuration file called
@@ -422,7 +447,9 @@ and configuration files with the suffix
in a directory called
.B xorg.conf.d
for its initial setup.
-Refer to the xorg.conf(5) manual page for information
+Refer to the
+.BR xorg.conf (5)
+manual page for information
about the format of this file.
.PP
.B Xorg
@@ -454,8 +481,10 @@ supported by Xorg. Enhancements are pla
The
.B Xorg
server config files can be found in a range of locations. These are
-documented fully in the xorg.conf(5) manual page. The
-most commonly used locations are shown here.
+documented fully in the
+.BR xorg.conf (5)
+manual page.
+The most commonly used locations are shown here.
.TP 30
.B /etc/X11/xorg.conf
Server configuration file.
@@ -516,49 +545,53 @@ Manual pages.
Initial access control list for display
.IR n .
.SH "SEE ALSO"
-X(7), Xserver(1), xdm(1), xinit(1),
-xorg.conf(5), xvidtune(1),
-xkeyboard-config (7),
-apm(4),
-ati(4),
-chips(4),
-cirrus(4),
-cyrix(4),
-fbdev(4),
-glide(4),
-glint(4),
-i128(4),
-i740(4),
-imstt(4),
-intel(4),
-mga(4),
-neomagic(4),
-nsc(4),
-nv(4),
-openchrome (4),
-r128(4),
-rendition(4),
-s3virge(4),
-siliconmotion(4),
-sis(4),
-sunbw2(4),
-suncg14(4),
-suncg3(4),
-suncg6(4),
-sunffb(4),
-sunleo(4),
-suntcx(4),
-tdfx(4),
-tga(4),
-trident(4),
-tseng(4),
-v4l(4),
-vesa(4),
-vmware(4),
+.BR X (7),
+.BR Xserver (1),
+.BR xdm (1),
+.BR xinit (1),
+.BR xorg.conf (5),
+.BR xvidtune (1),
+.BR xkeyboard-config (7),
+.BR apm (4),
+.BR ati (4),
+.BR chips (4),
+.BR cirrus (4),
+.BR cyrix (4),
+.BR fbdev (4),
+.BR glide (4),
+.BR glint (4),
+.BR i128 (4),
+.BR i740 (4),
+.BR imstt (4),
+.BR intel (4),
+.BR mga (4),
+.BR neomagic (4),
+.BR nsc (4),
+.BR nv (4),
+.BR openchrome (4),
+.BR r128 (4),
+.BR rendition (4),
+.BR s3virge (4),
+.BR siliconmotion (4),
+.BR sis (4),
+.BR sunbw2 (4),
+.BR suncg14 (4),
+.BR suncg3 (4),
+.BR suncg6 (4),
+.BR sunffb (4),
+.BR sunleo (4),
+.BR suntcx (4),
+.BR tdfx (4),
+.BR tga (4),
+.BR trident (4),
+.BR tseng (4),
+.BR v4l (4),
+.BR vesa (4),
+.BR vmware (4).
.br
Web site
.IR <http://www.x.org> .
-
+.
.SH AUTHORS
Xorg has many contributors world wide. The names of most of them
can be found in the documentation, ChangeLog files in the source tree,
-- System Information:
Debian Release: buster/sid
APT prefers stable-updates
APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)
Kernel: Linux 4.9.144-1 (SMP w/2 CPU cores)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE=is_IS.iso88591 (charmap=ISO-8859-1)
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages xserver-xorg-core depends on:
ii keyboard-configuration 1.188
ii libaudit1 1:2.8.4-2
ii libbsd0 0.9.1-1
ii libc6 2.28-4
ii libdbus-1-3 1.12.12-1
ii libdrm2 2.4.95-1
ii libegl1 1.1.0-1
ii libegl1-mesa 18.2.8-2
ii libepoxy0 1.5.3-0.1
ii libgbm1 18.2.8-2
ii libgcrypt20 1.8.4-4
ii libgl1 1.1.0-1
ii libpciaccess0 0.14-1
ii libpixman-1-0 0.36.0-1
ii libselinux1 2.8-1+b1
ii libsystemd0 240-2
ii libudev1 240-2
ii libunwind8 1.2.1-8
ii libxau6 1:1.0.8-1+b2
ii libxdmcp6 1:1.1.2-3
ii libxfont2 1:2.0.3-1
ii libxshmfence1 1.3-1
ii udev 240-2
ii xserver-common 2:1.20.3-1
Versions of packages xserver-xorg-core recommends:
ii libgl1-mesa-dri 18.2.8-2
pn libpam-systemd <none>
Versions of packages xserver-xorg-core suggests:
ii xfonts-100dpi 1:1.0.4+nmu1
ii xfonts-75dpi 1:1.0.4+nmu1
pn xfonts-scalable <none>
-- no debconf information
--
Bjarni I. Gislason
Reply to: