[src/trunk]: src/share/man/man4 Garbage collect !NetBSD documentation.

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

details:   https://anonhg.NetBSD.org/src/rev/c2331d0d3095
branches:  trunk
changeset: 748147:c2331d0d3095
user:      joerg <joerg%NetBSD.org@localhost>
date:      Wed Oct 14 23:32:42 2009 +0000

description:
Garbage collect !NetBSD documentation.

diffstat:

 share/man/man4/lmc.4 |  686 +-------------------------------------------------
 1 files changed, 18 insertions(+), 668 deletions(-)

diffs (truncated from 839 to 300 lines):

diff -r c3a48aeb05bd -r c2331d0d3095 share/man/man4/lmc.4
--- a/share/man/man4/lmc.4      Wed Oct 14 23:29:42 2009 +0000
+++ b/share/man/man4/lmc.4      Wed Oct 14 23:32:42 2009 +0000
@@ -53,224 +53,34 @@
 .\"           *  PLEASE DO NOT "UN-IFDEF" THIS FILE!  *
 .\"           * * * * * * * * * * * * * * * * * * * * *
 .\"
-.\" $NetBSD: lmc.4,v 1.16 2009/05/27 19:23:59 snj Exp $
+.\" $NetBSD: lmc.4,v 1.17 2009/10/14 23:32:42 joerg Exp $
 .\"
 .Dd April 11, 2006
 .Dt LMC 4
 .Os
-.\" Os sets \*(oS or \*[operating-system]
-.\" substring works differently before Groff version 1.19
-.ie (\n(.y < 19) .nr ssfix 1
-.el .nr ssfix 0
-.\" Is the OS name FreeBSD?
-.ie "\*[operating-system]"" .ds aa \*(oS
-.el .ds aa \*[operating-system]
-.substring aa (0+\n[ssfix] (6+\n[ssfix])
-.ie "\*(aa"FreeBSD" .nr fbsd 1
-.el .nr fbsd 0
-.\" Is the OS name NetBSD?
-.ie "\*[operating-system]"" .ds aa \*(oS
-.el .ds aa \*[operating-system]
-.substring aa (0+\n[ssfix]) (5+\n[ssfix])
-.ie "\*(aa"NetBSD" .nr nbsd 1
-.el .nr nbsd 0
-.\" Is the OS name OpenBSD?
-.ie "\*[operating-system]"" .ds aa \*(oS
-.el .ds aa \*[operating-system]
-.substring aa (0+\n[ssfix]) (7+\n[ssfix])
-.ie "\*(aa"OpenBSD" .nr obsd 1
-.el .nr obsd 0
-.\" Is the OS name BSDI?
-.ie "\*[operating-system]"" .ds aa \*(oS
-.el .ds aa \*[operating-system]
-.substring aa (0+\n[ssfix]) (4+\n[ssfix])
-.ie "\*(aa"BSDI" .nr bsdi 1
-.el .nr bsdi 0
-.\" Is the OS name BSD (i.e. Linux)?
-.ie "\*[operating-system]"" .ds aa \*(oS
-.el .ds aa \*[operating-system]
-.ie "\*(aa"BSD" .nr linux 1
-.el .nr linux 0
-.\" If no operating system matched then select all OSs.
-.if !(\n[fbsd] : \n[nbsd] : \n[obsd] : \n[bsdi] : \n[linux]) \{\
-.nr allos 1
-.nr fbsd  1
-.nr nbsd  1
-.nr obsd  1
-.nr bsdi  1
-.nr linux 1 \}
-.\"
 .Sh NAME
-.\"
 .Nm lmc
 .Nd device driver for
 .Tn LMC
 (and some
 .Tn SBE )
 wide-area network interface cards
-.\"
 .Sh SYNOPSIS
-.if \n[allos] .Ss FreeBSD Synopsis
-.if \n[fbsd] \{\
-The driver can be loaded into a kernel at boot-time by adding
-.Bd -unfilled -offset indent -compact
-.Cd if_lmc_load="YES"
-.Ed
-to
-.Pa /boot/loader.conf ;
-see
-.Xr loader.conf 5 .
-.Pp
-The driver can be loaded into a running kernel after boot-time with
-.Xr kldload 8 .
-.Bd -unfilled -offset indent -compact
-.Ic kldload if_lmc
-.Ed
-.Ic securelevel
-must be 0 to load modules after boot-time; see
-.Xr init 8 .
-.Pp
-The driver can be built into a kernel by adding the following to
-.Pa /sys/ARCH/conf/YOURKERNEL :
-.Bd -unfilled -offset indent -compact
-.Cd device     lmc
-.Cd device     sppp
-.Cd device     bpf
-.Cd device     pf      # for altq
-.Cd options    ALTQ
-.Cd options    ALTQ_HFSC # for altq example
-.Cd options    NETGRAPH
-.Cd options    DEVICE_POLLING
-.Ed
-.Pp
-The driver can send and receive raw IP packets even if
-neither SPPP nor Netgraph are configured into the kernel.
-.\} \" FreeBSD Synopsis
-.if \n[allos] .Ss NetBSD & OpenBSD Synopsis
-.if (\n[nbsd] : \n[obsd]) \{\
 This driver is built into the GENERIC kernel so it should "just work".
 .Pp
 The driver can be built into a kernel by adding the following to
 .Pa /sys/arch/ARCH/conf/YOURKERNEL :
 .Bd -unfilled -offset indent -compact
 .Cd lmc*               at pci?
-.if \n[nbsd] \{\
 .Cd options    ALTQ
-.Cd options    ALTQ_HFSC  # for altq example\}
-.if \n[obsd] \{\
-.Cd option     ALTQ
-.Cd option     ALTQ_HFSC  # for altq example\}
+.Cd options    ALTQ_HFSC  # for altq example
 .Cd pseudo-device sppp
 .Cd pseudo-device bpfilter
 .Ed
 .Pp
 The driver can send and receive raw IP packets even if
 SPPP is not configured into the kernel.
-.\} \" NetBSD & OpenBSD Synopsis
-.if \n[allos] .Ss BSD/OS Synopsis
-.if \n[bsdi] \{\
-The driver can be built into a custom kernel by adding the following to
-.Pa /sys/i386/conf/YOURKERNEL :
-.Bd -unfilled -offset indent -compact
-.Cd lmc*       at pci?
-.Cd options    PPP
-.Cd options    FR
-.Cd options    CISCO_HDLC
-.Cd pseudo-device bpfilter 16
-.Ed
-.Pp
-The driver can send and receive raw IP packets even if
-P2P is not configured into the kernel.
-.\} \" BSD/OS Synopsis
-.if \n[allos] .Ss Linux Synopsis
-.if \n[linux] \{\
-Configure the driver and line protocol for your kernel with
-.Bd -unfilled -offset indent -compact
-.Ic make menuconfig
-.Ed
-Navigating through the menus, select this device driver and the
-GenericHDLC layer as loadable kernel modules or built into the kernel:
-.Bd -unfilled -offset indent -compact
-.Ic Device Drivers --->
-.Ic Networking Support --->
-.Ic Wan interfaces --->
-.Ed
-.Pp
-Selecting LanMedia support selects the GenericHDLC and SyncPPP layers:
-.Bd -unfilled -offset indent -compact
-.Ic <M> LanMedia (and some SBE) WAN card support
-.Ic [*] Use NAPI to prevent livelock
-.Ic [*] Use the Generic HDLC layer
-.Ic [*] Use the SyncPPP layer
-.Ed
-.Pp
-Selecting the GenericHDLC layer selects these protocols:
-.Bd -unfilled -offset indent -compact
-.Ic <M> Generic HDLC layer
-.Ic [*]  Synchronous Point-to-Point Protocol (PPP) support
-.Ic [*]  Cisco-HDLC support
-.Ic [*]  Frame Relay support
-.Ic [*]  Raw HDLC support
-.Ic [*]  Raw HDLC Ethernet device support
-.Ed
-.Pp
-Selecting the SyncPPP layer includes support
-for PPP and Cisco-HDLC protocols.
-.Bd -unfilled -offset indent -compact
-.Ic <M> SyncPPP layer
-.Ed
-.Pp
-If configured as above, the kernel will recognize an LMC card
-when it boots and load this driver and the GenericHDLC code.
-Messages similar to the following will appear in
-.Pa /var/log/messages :
-.Bd -unfilled -offset indent -compact
-.Ic Cronyx Ltd, Synchronous PPP and CISCO HDLC (c) 1994
-.Ic Linux port (c) 1998 Building Number Three Ltd & Jan 'Yenya' Kasprzak.
-.Ic HDLC support module revision 1.18
-.Ic LMC Driver version 2006/1/20; Options NAPI GEN_HDLC SYNC_PPP.
-.Ic hdlc0: <LMC T3 card> at pci 0000:00:13.0 irq 11
-.Ed
-.Pp
-The driver can send and receive raw IP packets even if
-neither SyncPPP nor GenericHDLC are configured into the kernel.
-The device name will be
-.Ic hdlc<n>
-if GenericHDLC layer is configured, or
-.Ic lmc<n>
-otherwise.
-.Pp
-The driver accepts two optional parameters:
-.Bl -tag -width "verbose" -offset indent
-.It Va debug
-Sets the driver's
-.Sy debug
-flag at initialization time\[em]earlier
-than it can be set using
-.Ic lmcconfig
-or
-.Ic ifconfig .
-.It Va verbose
-Enables additional log messages describing the
-hardware while booting or module-loading.
-.El
-.Pp
-If the driver is built into the kernel,
-parameters are passed on the kernel command line:
-.Bd -unfilled -offset indent -compact
-.Ic if_lmc.debug=1
-.Ed
-If the driver is loaded into the kernel as a module,
-parameters are passed in the
-.Xr modprobe 8
-command:
-.Bd -unfilled -offset indent -compact
-.Ic modprobe if_lmc debug=1
-.Ed
-.\} \" linux Synopsis
-.\"
 .Sh DESCRIPTION
-.\"
 This is an open-source
 .Tn Unix
 device driver for PCI-bus wide-area network interface cards.
@@ -378,34 +188,9 @@
 higher-level issues like protocol multiplexing and security.
 The driver is compatible with several line protocol stacks:
 .Bl -tag -width "GenericHDLC" -offset indent
-.if \n[fbsd] \{\
-.It Sy Netgraph
-.Xr Netgraph 4
-implements many basic packet-handling functions as kernel loadable modules.
-They can be interconnected in a graph to implement many protocols.
-Configuration is done from userland without rebuilding the kernel.
-ASCII configuration control messages are
-.Em not
-currently supported. \}
-.if \n[fbsd] \{\
 .It Sy SPPP
 .Xr sppp 4
-implements Synchronous-PPP, Cisco-HDLC and Frame-Relay in the kernel. \}
-.if (\n[nbsd] : \n[obsd]) \{\
-.It Sy SPPP
-.Xr sppp 4
-implements Synchronous-PPP and Cisco-HDLC in the kernel. \}
-.if \n[bsdi] \{\
-.It Sy P2P
-.Xr p2p 4
-implements Synchronous-PPP, Cisco-HDLC and Frame-Relay in the kernel. \}
-.if \n[linux] \{\
-.It Sy GenericHDLC
-implements Synchronous-PPP, Cisco-HDLC, Frame-Relay,
-Ether-in-HDLC, IPv4-in-HDLC, and X.25 in the kernel.
-.It Sy SyncPPP
 implements Synchronous-PPP and Cisco-HDLC in the kernel.
-GenericHDLC uses SyncPPP as it's in-kernel PPP implementation. \}
 .It Sy RawIP
 The null line protocol, built into the driver, sends and receives
 raw IPv4 and IPv6 packets in HDLC frames with no extra bytes of
@@ -431,31 +216,10 @@
 .Ic lmcconfig lmc0 -X 1
 .Ed
 selects the built-in RawIP line protocol stack.
-.if (\n[fbsd] : \n[nbsd] : \n[obsd]) \{\
 .Bd -unfilled -offset indent
 .Ic lmcconfig lmc0 -X 2 -x 2
 .Ed
-selects the SPPP stack and the PPP protocol. \}
-.if \n[bsdi] \{\
-.Bd -unfilled -offset indent
-.Ic lmcconfig lmc0 -X 3 -x 2
-.Ed
-selects the P2P stack and the PPP protocol. \}
-.if \n[linux] \{\
-.Bd -unfilled -offset indent
-.Ic lmcconfig lmc0 -X 4 -x 2
-.Ed
-selects the GenericHDLC stack and the PPP protocol.
-.Bd -unfilled -offset indent
-.Ic lmcconfig lmc0 -X 5 -x 2
-.Ed
-selects the SyncPPP stack and the PPP protocol. \}
-.if (\n[fbsd] \{\
-.Bd -unfilled -offset indent
-.Ic lmcconfig lmc0 -X 6
-.Ed
-selects the Netgraph stack. \}
-.if (\n[fbsd] : \n[nbsd] : \n[obsd] : \n[bsdi]) \{\
+selects the SPPP stack and the PPP protocol.
 .Pp
 Some configuration options are available through
 .Ic ifconfig
@@ -474,19 +238,6 @@
 .Ic lmcconfig