[src/trunk]: src/share/man/man4 Sort SEE ALSO, sort sections, drop some .Pp, ...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/956cc5eed0d4
branches:  trunk
changeset: 515342:956cc5eed0d4
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sat Sep 22 15:58:13 2001 +0000

description:
Sort SEE ALSO, sort sections, drop some .Pp, misc. markup improvements.

diffstat:

 share/man/man4/pas.4       |    3 +-
 share/man/man4/pcdisplay.4 |    8 +-
 share/man/man4/pci.4       |   16 +----
 share/man/man4/pcic.4      |    4 +-
 share/man/man4/pciide.4    |   16 +++---
 share/man/man4/pckbc.4     |    6 +-
 share/man/man4/pckbd.4     |  116 +++++++++++++++++++-------------------------
 share/man/man4/pcmcia.4    |   14 +---
 share/man/man4/pcmcom.4    |    4 +-
 share/man/man4/pcppi.4     |    6 +-
 share/man/man4/pcscp.4     |   20 +++---
 share/man/man4/pms.4       |    8 +-
 share/man/man4/ppp.4       |   14 ++--
 share/man/man4/px.4        |   21 +++----
 share/man/man4/pxg.4       |   23 ++++----
 15 files changed, 124 insertions(+), 155 deletions(-)

diffs (truncated from 677 to 300 lines):

diff -r b2497476a5ab -r 956cc5eed0d4 share/man/man4/pas.4
--- a/share/man/man4/pas.4      Sat Sep 22 15:33:53 2001 +0000
+++ b/share/man/man4/pas.4      Sat Sep 22 15:58:13 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pas.4,v 1.2 2001/04/01 20:17:03 nathanw Exp $
+.\" $NetBSD: pas.4,v 1.3 2001/09/22 15:58:13 wiz Exp $
 .\"
 .\" Copyright (c) 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -43,7 +43,6 @@
 .Sh SYNOPSIS
 .Cd "pas0   at isa? port 0x220 irq 7 drq 1"
 .Cd "audio* at pas?"
-.Pp
 .Sh DESCRIPTION
 The
 .Nm
diff -r b2497476a5ab -r 956cc5eed0d4 share/man/man4/pcdisplay.4
--- a/share/man/man4/pcdisplay.4        Sat Sep 22 15:33:53 2001 +0000
+++ b/share/man/man4/pcdisplay.4        Sat Sep 22 15:58:13 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pcdisplay.4,v 1.4 2001/06/12 11:26:21 wiz Exp $
+.\" $NetBSD: pcdisplay.4,v 1.5 2001/09/22 15:58:13 wiz Exp $
 .Dd March 20, 1999
 .Os
 .Dt PCDISPLAY 4
@@ -7,7 +7,7 @@
 .Nd PC display adapter driver for wscons
 .Sh SYNOPSIS
 .Cd options PCDISPLAY_SOFTCURSOR
-
+.Pp
 .Cd "pcdisplay0 at isa?"
 .Cd "wsdisplay* at pcdisplay? console ?"
 .Sh DESCRIPTION
@@ -38,5 +38,5 @@
 .El
 .Sh SEE ALSO
 .Xr isa 4 ,
-.Xr wscons 4 ,
-.Xr vga 4
+.Xr vga 4 ,
+.Xr wscons 4
diff -r b2497476a5ab -r 956cc5eed0d4 share/man/man4/pci.4
--- a/share/man/man4/pci.4      Sat Sep 22 15:33:53 2001 +0000
+++ b/share/man/man4/pci.4      Sat Sep 22 15:58:13 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pci.4,v 1.55 2001/09/17 19:23:40 jdolecek Exp $
+.\"    $NetBSD: pci.4,v 1.56 2001/09/22 15:58:13 wiz Exp $
 .\"
 .\" Copyright (c) 1997 Jason R. Thorpe.  All rights reserved.
 .\" Copyright (c) 1997 Jonathan Stone
@@ -36,7 +36,6 @@
 .Nm pci
 .Nd introduction to machine-independent PCI bus support and drivers
 .Sh SYNOPSIS
-.Pp
 .Cd "pci* at mainbus? bus ?"
 .Cd "pci* at pchb? bus ?"
 .Cd "pci* at ppb? bus ?"
@@ -49,7 +48,7 @@
 See
 .Xr intro 4
 for your system for details.
-.Sh INTRODUCTION
+.Sh DESCRIPTION
 .Nx
 includes a machine-independent
 .Tn PCI
@@ -67,12 +66,11 @@
 Consult your system's
 .Xr intro 4
 for additional information.
-.Sh SUPPORTED DEVICES
+.Sh HARDWARE
 .Nx
 includes machine-independent
 .Tn PCI
 drivers, sorted by device type and driver name:
-.Pp
 .Ss SCSI interfaces
 .Bl -tag -width pcdisplay -offset indent
 .It ahc
@@ -116,7 +114,6 @@
 .Tn SCSI
 interfaces.
 .El
-.Pp
 .Ss Disk and tape controllers
 .Bl -tag -width pcdisplay -offset indent
 .It cac
@@ -128,7 +125,6 @@
 .It twe
 3Ware Escalade RAID controllers.
 .El
-.Pp
 .Ss Network interfaces
 .Bl -tag -width pcdisplay -offset indent
 .It an
@@ -230,7 +226,6 @@
 .Tn Ethernet
 interfaces.
 .El
-.Pp
 .Ss Serial interfaces
 .Bl -tag -width pcdisplay -offset indent
 .It cy
@@ -238,7 +233,6 @@
 .It cz
 Cyclades-Z series multi-port serial interfaces.
 .El
-.Pp
 .Ss Audio devices
 .Bl -tag -width pcdisplay -offset indent
 .It auich
@@ -266,7 +260,6 @@
 .It yds
 Yamaha YMF724/740/744/754-based audio device.
 .El
-.Pp
 .Ss Bridges
 .Bl -tag -width pcdisplay -offset indent
 .It cbb
@@ -308,9 +301,7 @@
 .It vga
 VGA graphics boards.
 .El
-.Pp
 .Sh SEE ALSO
-.Xr intro 4 ,
 .Xr adv 4 ,
 .Xr adw 4 ,
 .Xr agp 4 ,
@@ -342,6 +333,7 @@
 .Xr gsip 4 ,
 .Xr hme 4 ,
 .Xr iha 4 ,
+.Xr intro 4 ,
 .Xr iop 4 ,
 .Xr isp 4 ,
 .Xr le 4 ,
diff -r b2497476a5ab -r 956cc5eed0d4 share/man/man4/pcic.4
--- a/share/man/man4/pcic.4     Sat Sep 22 15:33:53 2001 +0000
+++ b/share/man/man4/pcic.4     Sat Sep 22 15:58:13 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pcic.4,v 1.3 2001/06/12 11:26:21 wiz Exp $
+.\" $NetBSD: pcic.4,v 1.4 2001/09/22 15:58:13 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -73,10 +73,10 @@
 .Nm
 devices in the kernel config file to accommodate these cards.
 .Sh SEE ALSO
-.Xr pcmcia 4 ,
 .Xr isa 4 ,
 .Xr isapnp 4 ,
 .Xr pci 4 ,
+.Xr pcmcia 4 ,
 .Xr tcic 4
 .Pp
 .Pa http://www.intel.com/
diff -r b2497476a5ab -r 956cc5eed0d4 share/man/man4/pciide.4
--- a/share/man/man4/pciide.4   Sat Sep 22 15:33:53 2001 +0000
+++ b/share/man/man4/pciide.4   Sat Sep 22 15:58:13 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pciide.4,v 1.32 2001/08/23 10:05:51 tsutsui Exp $
+.\"    $NetBSD: pciide.4,v 1.33 2001/09/22 15:58:13 wiz Exp $
 .\"
 .\" Copyright (c) 1998 Manuel Bouyer.
 .\"
@@ -86,6 +86,13 @@
 driver to use DMA when there is no explicit DMA mode setting support for
 the controller but DMA is present. If the BIOS didn't set up the controller
 properly, this can cause a machine hang.
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr pci 4 ,
+.Xr pnpbios 4 ,
+.Xr scsi 4 ,
+.Xr wd 4 ,
+.Xr wdc 4
 .Sh BUGS
 There's no way to reliably know if a PCI064x controller is enabled or not.
 If the driver finds a PCI064x, it will assume it is enabled unless the
@@ -113,10 +120,3 @@
 are for a PCI bus running at 30 or 33 MHz (except the OPTi controller,
 which supports both 25 and 33 MHz PCI bus timings). This driver may not
 work properly on overclocked systems.
-.Sh SEE ALSO
-.Xr intro 4 ,
-.Xr pci 4 ,
-.Xr pnpbios 4 ,
-.Xr scsi 4 ,
-.Xr wd 4 ,
-.Xr wdc 4
diff -r b2497476a5ab -r 956cc5eed0d4 share/man/man4/pckbc.4
--- a/share/man/man4/pckbc.4    Sat Sep 22 15:33:53 2001 +0000
+++ b/share/man/man4/pckbc.4    Sat Sep 22 15:58:13 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pckbc.4,v 1.4 2001/06/12 11:26:21 wiz Exp $
+.\" $NetBSD: pckbc.4,v 1.5 2001/09/22 15:58:14 wiz Exp $
 .Dd April 21, 1999
 .Os
 .Dt PCKBC 4
@@ -30,8 +30,8 @@
 useful in normal operation.
 .Sh SEE ALSO
 .Xr isa 4 ,
+.Xr opms 4 ,
 .Xr pckbd 4 ,
 .Xr pms 4 ,
 .Xr pmsi 4 ,
-.Xr pnpbios 4 ,
-.Xr opms 4
+.Xr pnpbios 4
diff -r b2497476a5ab -r 956cc5eed0d4 share/man/man4/pckbd.4
--- a/share/man/man4/pckbd.4    Sat Sep 22 15:33:53 2001 +0000
+++ b/share/man/man4/pckbd.4    Sat Sep 22 15:58:13 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pckbd.4,v 1.6 2001/06/12 11:26:21 wiz Exp $
+.\" $NetBSD: pckbd.4,v 1.7 2001/09/22 15:58:14 wiz Exp $
 .Dd March 20, 1999
 .Os
 .Dt PCKBD 4
@@ -23,80 +23,65 @@
 .Nm
 driver supports a number of different key mappings which
 can be chosen from with the kernel option
-.Dq PCKBD_LAYOUT
+.Li PCKBD_LAYOUT
 at compile time or with the utility
 .Xr wsconsctl 8
 (variable:
-.Dq encoding
-) at runtime.
+.Dq encoding )
+at runtime.
 Other mappings can be used if the whole keymap is replaced by means of
 .Xr wsconsctl 8 .
 The builtin mappings are at this time:
-.Bl -hang
-.It KB_US
-(for wsconsctl:
-.Dq us
-) English / US keyboard mapping (default).
-.It KB_DE
-(
-.Dq de
-) German with
-.Dq dead accents .
-.It KB_FR
-(
-.Dq fr
-) French.
-.It KB_DK
-(
-.Dq dk
-) Danish with
-.Dq dead accents .
-.It KB_IT
-(
-.Dq it
-) Italian.
-.It KB_UK
-(
-.Dq uk
-) British.
-.It KB_JP
-(
-.Dq jp
-) Japanese.
-.It KB_SV
-(
-.Dq sv
-) Swedish with
-.Dq dead accents .
-.It KB_US | KB_DECLK
-(
-.Dq us.declk
-) English / US mapping for
+.Bl -column " KB_US|KB_DVORAK" "wsconsctl" "language"
+.It Sy "option" Ta Sy "wsconsctl" Ta Sy "language"
+.It Li KB_US Ta us Ta English/US keyboard mapping (default)
+.It Li KB_DE Ta de Ta German with
+.Dq dead accents
+.It Li KB_FR Ta fr Ta French
+.It Li KB_DK Ta dk Ta Danish with
+.Dq dead accents
+.It Li KB_IT Ta it Ta Italian
+.It Li KB_UK Ta uk Ta British
+.It Li KB_JP Ta jp Ta Japanese
+.It Li KB_SV Ta sv Ta Swedish with
+.Dq dead accents
+.It Li "KB_US|KB_DECLK" Ta \&us.declk Ta English/US mapping for
 .Tn DEC
-LK400-style keyboards with PC keyboard interface (eg LK461).
-.It KB_US | KB_DVORAK
-(
-.Dq us.dvorak