[PATCH xserver/hw/xfree86/man/xorg.conf.man] .BI style: monitor section
Peter Hutterer
peter.hutterer at who-t.net
Wed Sep 21 15:29:05 PDT 2011
On Wed, Aug 31, 2011 at 07:23:01AM +0200, vdb at picaros.org wrote:
> The xorg.conf manual uses the following convention in most of its
> sections:
>
> bold = text to be copied literally to the config file,
> italic = a symbolic name to be substituted by a true value.
>
> Some configuration keywords seem to have been changed into generic
> options. Prepending Option to the manual entry swapped the
> bold-italic logic. This patch restores the convention in the monitor
> section and consists of
>
> -.BI "Option " "\*qPreferredMode\*q " \*qstring\*q
> +.BI "Option \*qPreferredMode\*q \*q" name \*q
>
> modifications.
>
> Signed-off-by: Servaas Vandenberghe
merged, thank you. I've changed the subject a bit and added a note in the
commit message about the other minor changes in this patch but left the
actual patch untouched.
This is in my tree now, it'll land on master soon-ish.
Cheers,
Peter
> diff --git a/hw/xfree86/man/xorg.conf.man b/hw/xfree86/man/xorg.conf.man
> index 4bec316..7d4738a 100644
> --- a/hw/xfree86/man/xorg.conf.man
> +++ b/hw/xfree86/man/xorg.conf.man
> @@ -1428,7 +1428,7 @@
> section with an output by adding an option to the Device section in the
> following format:
>
> -.B Option \*qMonitor-outputname\*q \*qmonitorsection\*q
> +.BI "Option \*qMonitor-" outputname "\*q \*q" monitorsection \*q
>
> (for example,
> .B Option \*qMonitor-VGA\*q \*qVGA monitor\*q
> @@ -1444,7 +1444,7 @@ modes available.
> When modes are specified explicitly in the
> .B Monitor
> section (with the
> -.BR Modes ,
> +.BR Mode ,
> .BR ModeLine ,
> or
> .B UseModes
> @@ -1593,7 +1593,7 @@ mentioned above doubles this value.
> This entry is a more compact version of the
> .B Mode
> entry, and it also can be used to specify video modes for the monitor.
> -is a single line format for specifying video modes.
> +This is a single line format for specifying video modes.
> In most cases this isn't necessary because the built\-in set of VESA
> standard modes will be sufficient.
> .PP
> @@ -1648,61 +1648,61 @@ The
> and
> .B VScan
> options mentioned above in the
> -.B Modes
> +.B Mode
> entry description can also be used here.
> .RE
> .TP 7
> -.BI "Option " "\*qDPMS\*q " \*qbool\*q
> +.BI "Option \*qDPMS\*q \*q" bool \*q
> This option controls whether the server should enable the DPMS extension
> for power management for this screen. The default is to enable the
> extension.
> .TP 7
> -.BI "Option " "\*qSyncOnGreen\*q " \*qbool\*q
> +.BI "Option \*qSyncOnGreen\*q \*q" bool \*q
> This option controls whether the video card should drive the sync signal
> on the green color pin. Not all cards support this option, and most
> monitors do not require it. The default is off.
> .TP 7
> -.BI "Option " "\*qPrimary\*q " \*qbool\*q
> +.BI "Option \*qPrimary\*q \*q" bool \*q
> This optional entry specifies that the monitor should be treated as the primary
> monitor. (RandR 1.2-supporting drivers only)
> .TP 7
> -.BI "Option " "\*qPreferredMode\*q " \*qstring\*q
> +.BI "Option \*qPreferredMode\*q \*q" name \*q
> This optional entry specifies a mode to be marked as the preferred initial mode
> of the monitor.
> (RandR 1.2-supporting drivers only)
> .TP 7
> -.BI "Option " "\*qPosition\*q " "\*qx y\*q"
> +.BI "Option \*qPosition\*q \*q" x " " y \*q
> This optional entry specifies the position of the monitor within the X
> screen.
> (RandR 1.2-supporting drivers only)
> .TP 7
> -.BI "Option " "\*qLeftOf\*q " \*qoutput\*q
> +.BI "Option \*qLeftOf\*q \*q" output \*q
> This optional entry specifies that the monitor should be positioned to the
> left of the output (not monitor) of the given name.
> (RandR 1.2-supporting drivers only)
> .TP 7
> -.BI "Option " "\*qRightOf\*q " \*qoutput\*q
> +.BI "Option \*qRightOf\*q \*q" output \*q
> This optional entry specifies that the monitor should be positioned to the
> right of the output (not monitor) of the given name.
> (RandR 1.2-supporting drivers only)
> .TP 7
> -.BI "Option " "\*qAbove\*q " \*qoutput\*q
> +.BI "Option \*qAbove\*q \*q" output \*q
> This optional entry specifies that the monitor should be positioned above the
> output (not monitor) of the given name.
> (RandR 1.2-supporting drivers only)
> .TP 7
> -.BI "Option " "\*qBelow\*q " \*qoutput\*q
> +.BI "Option \*qBelow\*q \*q" output \*q
> This optional entry specifies that the monitor should be positioned below the
> output (not monitor) of the given name.
> (RandR 1.2-supporting drivers only)
> .TP 7
> -.BI "Option " "\*qEnable\*q " \*qbool\*q
> +.BI "Option \*qEnable\*q \*q" bool \*q
> This optional entry specifies whether the monitor should be turned on
> at startup. By default, the server will attempt to enable all connected
> monitors.
> (RandR 1.2-supporting drivers only)
> .TP 7
> -.BI "Option " "\*qDefaultModes\*q " \*qbool\*q
> +.BI "Option \*qDefaultModes\*q \*q" bool \*q
> This optional entry specifies whether the server should add supported default
> modes to the list of modes offered on this monitor. By default, the server
> will add default modes; you should only disable this if you can guarantee
> @@ -1710,21 +1710,21 @@ that EDID will be available at all times, or if you have added custom modelines
> which the server can use.
> (RandR 1.2-supporting drivers only)
> .TP 7
> -.BI "Option " "\*qMinClock\*q " \*qfrequency\*q
> +.BI "Option \*qMinClock\*q \*q" frequency \*q
> This optional entry specifies the minimum dot clock, in kHz, that is supported
> by the monitor.
> .TP 7
> -.BI "Option " "\*qMaxClock\*q " \*qfrequency\*q
> +.BI "Option \*qMaxClock\*q \*q" frequency \*q
> This optional entry specifies the maximum dot clock, in kHz, that is supported
> by the monitor.
> .TP 7
> -.BI "Option " "\*qIgnore\*q " \*qbool\*q
> +.BI "Option \*qIgnore\*q \*q" bool \*q
> This optional entry specifies that the monitor should be ignored entirely,
> and not reported through RandR. This is useful if the hardware reports the
> presence of outputs that don't exist.
> (RandR 1.2-supporting drivers only)
> .TP 7
> -.BI "Option " "\*qRotate\*q " \*qrotation\*q
> +.BI "Option \*qRotate\*q \*q" rotation \*q
> This optional entry specifies the initial rotation of the given monitor.
> Valid values for rotation are \*qnormal\*q, \*qleft\*q, \*qright\*q, and
> \*qinverted\*q.
> _______________________________________________
> xorg-devel at lists.x.org: X.Org development
> Archives: http://lists.x.org/archives/xorg-devel
> Info: http://lists.x.org/mailman/listinfo/xorg-devel
>
More information about the xorg-devel
mailing list