Improve man page formatting

More closely follow common style as described on
https://man7.org/linux/man-pages/man7/man-pages.7.html
and fix warnings raised by `mandoc -T lint` and `groff -rCHECKSTYLE=10`

Part-of: <https://gitlab.freedesktop.org/xorg/driver/xf86-video-chips/-/merge_requests/13>

man/chips.man

@@ -1,8 +1,8 @@
 .\" shorthand for double quote that works everywhere.
 .ds q \N'34'
-.TH CHIPS __drivermansuffix__ __vendorversion__
+.TH CHIPS __drivermansuffix__ 2011-03-29 __vendorversion__
 .SH NAME
-chips \- Chips and Technologies video driver
+chips \- Chips and Technologies video driver for Xorg
 .SH SYNOPSIS
 .nf
 .B "Section \*qDevice\*q"
@@ -12,73 +12,75 @@ chips \- Chips and Technologies video driver
 .B EndSection
 .fi
 .SH DESCRIPTION
-.B chips 
+.B chips
-is an __xservername__ driver for Chips and Technologies video processors.  The majority
+is an Xorg driver for Chips and Technologies video processors.
-of the Chips and Technologies chipsets are supported by this driver. In general
+The majority of the Chips and Technologies chipsets are supported by this driver.
-the limitation on the capabilities of this driver are determined by the 
+In general the limitation on the capabilities of this driver are determined by
-chipset on which it is run. Where possible, this driver provides full
+the chipset on which it is run.
-acceleration and supports the following depths: 1, 4, 8, 15, 16, 24 and on
+Where possible, this driver provides full acceleration and
-the latest chipsets an 8+16 overlay mode. All visual types are supported for
+supports the following depths: 1, 4, 8, 15, 16, 24,
-depth 1, 4 and 8 and both TrueColor and DirectColor visuals are supported
+and on the latest chipsets, an 8+16 overlay mode.
-where possible. Multi-head configurations are supported on PCI or AGP buses.
+All visual types are supported for depth 1, 4 and 8,
+and both TrueColor and DirectColor visuals are supported where possible.
+Multi-head configurations are supported on PCI or AGP buses.
 .SH SUPPORTED HARDWARE
 The
 .B chips
 driver supports video processors on most of the bus types currently available.
-The chipsets supported fall into one of three architectural classes. A
+The chipsets supported fall into one of three architectural classes: a
 .B basic
 architecture, the
 .B WinGine
-architecture and the newer
+architecture, and the newer
 .B HiQV
 architecture.
-.PP
+.SS Basic Architecture
-.B Basic Architecture
-.PP
 The supported chipsets are
-.B ct65520, ct65525, ct65530, ct65535, ct65540, ct65545, ct65546
+.BR ct65520 ", " ct65525 ", " ct65530 ", "
-and 
+.BR ct65535 ", " ct65540 ", " ct65545 ", "
-.B ct65548
+.B ct65546
+and
+.BR ct65548 .
 .PP
-Color depths 1, 4 and 8 are supported on all chipsets, while depths 15, 16
+Color depths 1, 4, and 8 are supported on all chipsets,
-and 24 are supported only on the
+while depths 15, 16, and 24 are supported only on the
-.B 65540, 65545, 65546
+.BR 65540 ", " 65545 ", " 65546
-and 
+and
 .B 65548
-chipsets. The driver is accelerated when used with the
+chipsets.
-.B 65545, 65546
+The driver is accelerated when used with the
+.BR 65545 ", " 65546
 or
 .B 65548
 chipsets, however the DirectColor visual is not available.
-.PP
+.SS Wingine Architecture
-.B Wingine Architecture
-.PP
 The supported chipsets are
 .B ct64200
-and 
+and
-.B ct64300
+.BR ct64300.
 .PP
-Color depths 1, 4 and 8 are supported on both chipsets, while depths 15, 16
+Color depths 1, 4, and 8 are supported on both chipsets,
-and 24 are supported only on the
+while depths 15, 16, and 24 are supported only on the
 .B 64300
-chipsets. The driver is accelerated when used with the
+chipsets.
+The driver is accelerated when used with the
 .B 64300
 chipsets, however the DirectColor visual is not available.
-.PP
+.SS HiQV Architecture
-.B HiQV Architecture
-.PP
 The supported chipsets are
-.B ct65550, ct65554, ct65555, ct68554, ct69000
+.BR ct65550 ", " ct65554 ", " ct65555 ", " ct68554 ", " ct69000
-and 
+and
-.B ct69030
+.BR  ct69030 .
 .PP
 Color depths 1, 4, 8, 15, 16, 24 and 8+16 are supported on all chipsets.
 The DirectColor visual is supported on all color depths except the 8+16
-overlay mode. Full acceleration is supplied for all chipsets.
+overlay mode.
+Full acceleration is supplied for all chipsets.
 .SH CONFIGURATION DETAILS
-Please refer to __xconfigfile__(__filemansuffix__) for general configuration
+Please refer to
-details.  This section only covers configuration details specific to this
+.BR xorg.conf (__filemansuffix__)
-driver.
+for general configuration details.
+This section only covers configuration details specific to this driver.
 .PP
 The driver auto-detects the chipset type, but the following
 .B ChipSet
@@ -92,8 +94,8 @@ section, and will override the auto-detection:
 "ct64200", "ct64300".
 .RE
 .PP
-The driver will auto-detect the amount of video memory present for all
+The driver will auto-detect the amount of video memory present for all chipsets,
-chipsets.  But maybe overridden with the
+but it may be overridden with the
 .B VideoRam
 entry in the config file
 .B \*qDevice\*q
@@ -104,7 +106,8 @@ The following driver
 are supported, on one or more of the supported chipsets:
 .TP
 .BI "Option \*qNoAccel\*q \*q" boolean \*q
-Disable or enable acceleration.  Default: acceleration is enabled.
+Disable or enable acceleration.
+Default: acceleration is enabled.
 .TP
 .BI "Option \*qNoLinear\*q \*q" boolean \*q
 Disables linear addressing in cases where it is enabled by default.
@@ -115,35 +118,44 @@ Enables linear addressing in cases where it is disabled by default.
 Default: off
 .TP
 .BI "Option \*qHWCursor\*q \*q" boolean \*q
-Enable or disable the HW cursor.  Default: on.
+Enable or disable the HW cursor.
+Default: on.
 .TP
 .BI "Option \*qSWCursor\*q \*q" boolean \*q
-Enable or disable the SW cursor.  Default: off.
+Enable or disable the SW cursor.
+Default: off.
 .TP
 .BI "Option \*qSTN\*q \*q" boolean \*q
-Force detection of STN screen type. Default: off.
+Force detection of STN screen type.
+Default: off.
 .TP
 .BI "Option \*qUseModeline\*q \*q" boolean \*q
-Reprogram flat panel timings with values from the modeline. Default: off
+Reprogram flat panel timings with values from the modeline.
+Default: off
 .TP
 .BI "Option \*qFixPanelSize\*q \*q" boolean \*q
-Reprogram flat panel size with values from the modeline. Default: off
+Reprogram flat panel size with values from the modeline.
+Default: off
 .TP
 .BI "Option \*qNoStretch\*q \*q" boolean \*q
 This option disables the stretching on a mode on a flat panel to fill the
-screen. Default: off
+screen.
+Default: off
 .TP
 .BI "Option \*qLcdCenter\*q \*q" boolean \*q
-Center the mode displayed on the flat panel on the screen. Default: off
+Center the mode displayed on the flat panel on the screen.
+Default: off
 .TP
 .BI "Option \*qHWclocks\*q \*q" boolean \*q
 Force the use of fixed hardware clocks on chips that support both fixed
-and programmable clocks. Default: off
+and programmable clocks.
+Default: off
 .TP
 .BI "Option \*qUseVclk1\*q \*q" boolean \*q
 Use the Vclk1 programmable clock on
 .B HiQV
-chipsets instead of Vclk2. Default: off
+chipsets instead of Vclk2.
+Default: off
 .TP
 .BI "Option \*qFPClock8\*q \*q" float \*q
 .TP
@@ -152,37 +164,43 @@ chipsets instead of Vclk2. Default: off
 .BI "Option \*qFPClock24\*q \*q" float \*q
 .TP
 .BI "Option \*qFPClock32\*q \*q" float \*q
-Force the use of a particular video clock speed for use with the 
+Force the use of a particular video clock speed for use with the
 flat panel at a specified depth
 .TP
 .BI "Option \*qMMIO\*q \*q" boolean \*q
-Force the use of memory mapped IO for acceleration registers. Default: off
+Force the use of memory mapped IO for acceleration registers.
+Default: off
 .TP
 .BI "Option \*qFullMMIO\*q \*q" boolean \*q
-Force the use of memory mapped IO where it can be used. Default: off
+Force the use of memory mapped IO where it can be used.
+Default: off
 .TP
 .BI "Option \*qSuspendHack\*q \*q" boolean \*q
-Force driver to leave centering and stretching registers alone. This
+Force driver to leave centering and stretching registers alone.
-can fix some laptop suspend/resume problems. Default: off
+This can fix some laptop suspend/resume problems.
+Default: off
 .TP
 .BI "Option \*qColorKey\*q \*q" integer \*q
 Set the colormap index used for the transparency key for the depth 8 plane
-when operating in 8+16 overlay mode.  The value must be in the range
+when operating in 8+16 overlay mode.
-2\-255.  Default: 255.
+The value must be in the range 2\-255.
+Default: 255.
 .TP
 .BI "Option \*qVideoKey\*q \*q" integer \*q
 This sets the default pixel value for the YUV video overlay key.
 Default: undefined.
 .TP
 .BI "Option \*qShadowFB\*q \*q" boolean \*q
-Enable or disable use of the shadow framebuffer layer.  Default: off.
+Enable or disable use of the shadow framebuffer layer.
+Default: off.
 .TP
 .BI "Option \*qSyncOnGreen\*q \*q" boolean \*q
 Enable or disable combining the sync signals with the green signal.
 Default: off.
 .TP
 .BI "Option \*qShowCache\*q \*q" boolean \*q
-Enable or disable viewing offscreen memory. Used for debugging only
+Enable or disable viewing offscreen memory.
+Used for debugging only.
 Default: off.
 .TP
 .BI "Option \*q18bitBus\*q \*q" boolean \*q
@@ -191,35 +209,42 @@ Default: off.
 .TP
 .BI "Option \*qCrt2Memory\*q \*q" integer \*q
 In a dual-head mode (69030 only) this option selects the amount of memory
-to set aside for the second head. If not specified, half the memory is used.
+to set aside for the second head.
+If not specified, half the memory is used.
 Default: off.
 .TP
 .BI "Option \*qDualRefresh\*q \*q" integer \*q
 The 69030 supports independent refresh rates on its two display channels.
 This mode of operations uses additional memory bandwidth and thus limits
 the maximum colour depth and refresh rate that can be achieved, and so is
-off by default.  Using this option forces the use of an independent refresh
+off by default.
+Using this option forces the use of an independent refresh
 rate on the two screens.
 Default: off.
 .TP
 .BI "Option \*qFpMode\*q \*q" boolean \*q
 The driver probes the chip to find out if a flat panel (LCD) is connected
-and active. If this is true it limits the possible screen size to the maximum
+and active.
-resolution of the panel. The chips is initialized by the BIOS which may
+If this is true it limits the possible screen size to the maximum
-set the chip to 'dual' mode even if no panel is connected. In this case
+resolution of the panel.
-the available resolution on the CRT is limited to the panel size
+The chips is initialized by the BIOS which may
-the BIOS has set. To tell the driver that no panel is connected despite
+set the chip to 'dual' mode even if no panel is connected.
-of what the BIOS is saying set this option to off. Don't set it to off
+In this case the available resolution on the CRT is limited to the panel size
-if a panel is connected.
+the BIOS has set.
+To tell the driver that no panel is connected despite
+of what the BIOS is saying set this option to off.
+Don't set it to off if a panel is connected.
 Default: value probed by BIOS.
 .SH "SEE ALSO"
-__xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), Xserver(__appmansuffix__), X(__miscmansuffix__)
+.BR Xorg (__appmansuffix__),
+.BR xorg.conf (__filemansuffix__),
+.BR Xserver (__appmansuffix__),
+.BR X (__miscmansuffix__)
 .PP
-You are also recommended to read the README.chips file that comes with all
+You are also recommended to read the README file that comes with the driver
-__xservername__ distributions, which discusses the
+source, which discusses the
 .B chips
 driver in more detail.
 .SH AUTHORS
 Authors include: Jon Block, Mike Hollick, Regis Cridlig, Nozomi Ytow,
 Egbert Eich, David Bateman and Xavier Ducoin
-