[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/ac5b5948a136
branches:  trunk
changeset: 515202:ac5b5948a136
user:      wiz <wiz%NetBSD.org@localhost>
date:      Wed Sep 19 01:03:43 2001 +0000

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

diffstat:

 share/man/man4/gif.4    |   4 +---
 share/man/man4/gre.4    |  48 ++++++++++++++++++++++++++----------------------
 share/man/man4/gsip.4   |  16 ++++++++--------
 share/man/man4/gus.4    |  24 ++++++++++++------------
 share/man/man4/guspnp.4 |  31 ++++++++++++++++---------------
 5 files changed, 63 insertions(+), 60 deletions(-)

diffs (271 lines):

diff -r 13e09e4afc25 -r ac5b5948a136 share/man/man4/gif.4
--- a/share/man/man4/gif.4      Wed Sep 19 00:52:12 2001 +0000
+++ b/share/man/man4/gif.4      Wed Sep 19 01:03:43 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: gif.4,v 1.16 2001/05/14 13:35:20 itojun Exp $
+.\"    $NetBSD: gif.4,v 1.17 2001/09/19 01:03:43 wiz Exp $
 .\"    $KAME: gif.4,v 1.24 2001/02/20 12:54:01 itojun Exp $
 .\"
 .\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
@@ -81,7 +81,6 @@
 can be configured to be ECN friendly.
 This can be configured by
 .Dv IFF_LINK1 .
-.Pp
 .Ss ECN friendly behavior
 .Nm
 can be configured to be ECN friendly, as described in
@@ -134,7 +133,6 @@
 .Pp
 Note that the ECN friendly behavior violates RFC2893.
 This should be used in mutual agreement with the peer.
-.Pp
 .Ss Security
 Malicious party may try to circumvent security filters by using
 tunnelled packets.
diff -r 13e09e4afc25 -r ac5b5948a136 share/man/man4/gre.4
--- a/share/man/man4/gre.4      Wed Sep 19 00:52:12 2001 +0000
+++ b/share/man/man4/gre.4      Wed Sep 19 01:03:43 2001 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: gre.4,v 1.15 2001/09/11 00:08:27 wiz Exp $
+.\" $NetBSD: gre.4,v 1.16 2001/09/19 01:03:44 wiz Exp $
 .\"
 .\" Copyright 1998 (c) The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -120,7 +120,6 @@
 .Ic ifconfig
 for the interface (as if IP is encapsulated), but need not be, as e.g. when
 encapsulating AppleTalk.
-.Pp
 .Sh EXAMPLES
 Configuration example:
 .Bd -literal
@@ -128,17 +127,17 @@
           \\                                          |
            \\                                        /
              +------Host B----------Host C----------+
-
 .Ed
-   On host A (NetBSD):
-
+On host A
+.Ns ( Nx ) :
+.Bd -literal
    # route add default B
    # ifconfig greN  A D netmask 0xffffffff linkX up
    # greconfig -i greN -s A -d D
    # route add E D
-
-   On Host D (Cisco):
-
+.Ed
+On Host D (Cisco):
+.Bd -literal
    Interface TunnelX
     ip unnumbered D   ! e.g. address from Ethernet interface
     tunnel source D   ! e.g. address from Ethernet interface
@@ -146,22 +145,27 @@
    ip route C <some interface and mask>
    ip route A mask C
    ip route X mask tunnelX
-
-   OR
-
-   On Host D (NetBSD):
-
+.Ed
+OR
+On Host D
+.Ns ( Nx ) :
+.Bd -literal
    # route add default C
    # ifconfig greN D A
+.Ed
 .Pp
 If all goes well, you should see packets flowing ;-)
 .Pp
 If you want to reach Host A over the tunnel (from the Cisco D), then
 you have to have an alias on Host A for e.g. the Ethernet interface like:
+.Bd -literal
      ifconfig <etherif> alias Y
- and on the cisco
+.Ed
+and on the cisco
+.Bd -literal
      ip route Y mask tunnelX
-.Sh NOTE
+.Ed
+.Sh NOTES
 For correct operation, the
 .Nm
 device needs a route to the destination, that is less specific than the
@@ -171,12 +175,13 @@
 .Pp
 In order to
 .Ic ifconfig
-to actually mark the interface as up, the keyword ``up'' must be given
-last on its command line.
+to actually mark the interface as up, the keyword
+.Dq up
+must be given last on its command line.
 .Pp
 The kernel must be set to forward datagrams by either option
-``GATEWAY'' in the kernel config file or by issuing the appropriate
-option to
+.Dq GATEWAY
+in the kernel config file or by issuing the appropriate option to
 .Xr sysctl 8 .
 .Sh SEE ALSO
 .Xr atalk 4 ,
@@ -192,6 +197,8 @@
 A description of GRE encapsulation can be found in RFC 1701, RFC 1702.
 .Pp
 A description of MOBILE encapsulation can be found in RFC 2004.
+.Sh AUTHORS
+.An Heiko W.Rupp Aq hwr%pilhuhn.de@localhost
 .Sh BUGS
 The compute_route() code in if_gre.c toggles the last bit of the
 IP-address to provoke the search for a less specific route than the
@@ -211,6 +218,3 @@
 .Pp
 BPF does probably not yet work (it might, but last time I looked,
 it bombed, so I #if 0'd it out).
-.Pp
-.Sh AUTHORS
-Heiko W.Rupp <hwr%pilhuhn.de@localhost>
diff -r 13e09e4afc25 -r ac5b5948a136 share/man/man4/gsip.4
--- a/share/man/man4/gsip.4     Wed Sep 19 00:52:12 2001 +0000
+++ b/share/man/man4/gsip.4     Wed Sep 19 01:03:43 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: gsip.4,v 1.6 2001/09/11 00:08:27 wiz Exp $
+.\"    $NetBSD: gsip.4,v 1.7 2001/09/19 01:03:44 wiz Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -80,21 +80,21 @@
 .Xr mii 4 ,
 .Xr netintro 4 ,
 .Xr pci 4 ,
-.Xr ifconfig 8 ,
-.Xr vlan 4
+.Xr vlan 4 ,
+.Xr ifconfig 8
 .Sh HISTORY
 The
 .Nm
 driver first appeared in
 .Nx 1.6 .
-.Sh BUGS
-The
-.Nm
-driver does not support the 10-bit interface, which is required in
-order to support fiber-optic media.
 .Sh AUTHORS
 The
 .Nm
 driver was written by
 .An Jason R. Thorpe
 .Aq thorpej%netbsd.org@localhost .
+.Sh BUGS
+The
+.Nm
+driver does not support the 10-bit interface, which is required in
+order to support fiber-optic media.
diff -r 13e09e4afc25 -r ac5b5948a136 share/man/man4/gus.4
--- a/share/man/man4/gus.4      Wed Sep 19 00:52:12 2001 +0000
+++ b/share/man/man4/gus.4      Wed Sep 19 01:03:43 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: gus.4,v 1.10 2001/09/11 22:52:52 wiz Exp $
+.\"    $NetBSD: gus.4,v 1.11 2001/09/19 01:03:44 wiz Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -46,7 +46,7 @@
 .Cd "audio* at gus?"
 .Sh DESCRIPTION
 The
-.Nm gus
+.Nm
 driver provides support for the Gravis UltraSound (GUS) and GUS MAX
 audio cards.  Both cards have on-board memory which is used for
 seamless playback of samples.  They can play back 8- or 16-bit samples
@@ -68,6 +68,16 @@
 The Gravis UltraSound MAX has an additional CODEC onboard which is
 addressed with four ports at an offset of 0x10C from the base ports
 (0x31C-0x36C).
+.Sh SEE ALSO
+.Xr audio 4
+.Sh REFERENCES
+Gravis UltraSound Low-Level Toolkit, Revision 2.01, 20 May 1993,
+published by Advanced Gravis and Forte Technologies.
+.Sh HISTORY
+The
+.Nm gus
+device driver appeared in
+.Nx 1.1 .
 .Sh BUGS
 The full-duplex features of the GUS MAX have not been fully tested, and
 full-duplex on the original GUS may not be possible at all.
@@ -82,13 +92,3 @@
 probably due to excessive interrupt masking.
 .Pp
 The joystick and MIDI port interfaces are not supported.
-.Sh SEE ALSO
-.Xr audio 4
-.Sh REFERENCES
-Gravis UltraSound Low-Level Toolkit, Revision 2.01, 20 May 1993,
-published by Advanced Gravis and Forte Technologies.
-.Sh HISTORY
-The
-.Nm gus
-device driver appeared in
-.Nx 1.1 .
diff -r 13e09e4afc25 -r ac5b5948a136 share/man/man4/guspnp.4
--- a/share/man/man4/guspnp.4   Wed Sep 19 00:52:12 2001 +0000
+++ b/share/man/man4/guspnp.4   Wed Sep 19 01:03:43 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: guspnp.4,v 1.10 2001/09/11 00:08:27 wiz Exp $
+.\"    $NetBSD: guspnp.4,v 1.11 2001/09/19 01:03:44 wiz Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -77,6 +77,21 @@
 .Tn Gravis
 Ultrasound PNP, and compatibles
 .El
+.Sh SEE ALSO
+.Xr audio 4 ,
+.Xr gus 4 ,
+.Xr isapnp 4
+.Sh REFERENCES
+Interwave(tm) IC Am78C201/202 Programmer's Guide Rev. 2. 1996. Advanced
+Micro Devices.
+.Sh HISTORY
+The
+.Nm guspnp
+driver appeared in
+.Nx 1.3 .
+.Sh AUTHORS
+.An Kari Mettinen Aq Kari.Mettinen%helsinki.fi@localhost ,
+University of Helsinki.
 .Sh BUGS
 Sometimes you can cause a hiss on either left or right channel, or both.
 You can usually make it disappear by playing random data, however this
@@ -100,17 +115,3 @@
 .Pp
 Other architectures than i386 haven't been tested. The bus_space abstraction
 has been used from the beginning, so it should work.
-.Sh SEE ALSO
-.Xr audio 4 ,
-.Xr isapnp 4 ,
-.Xr gus 4
-.Sh AUTHORS
-Kari Mettinen (Kari.Mettinen%helsinki.fi@localhost), University of Helsinki.
-.Sh REFERENCES
-Interwave(tm) IC Am78C201/202 Programmer's Guide Rev. 2. 1996. Advanced
-Micro Devices.
-.Sh HISTORY
-The
-.Nm guspnp
-driver appeared in
-.Nx 1.3 .