diff options
| author | Sheldon Hearn <sheldonh@FreeBSD.org> | 2000-03-03 11:43:25 +0000 |
|---|---|---|
| committer | Sheldon Hearn <sheldonh@FreeBSD.org> | 2000-03-03 11:43:25 +0000 |
| commit | 94af75cb0760d75074cba43b6fe8eb2d0d880a44 (patch) | |
| tree | 9180adfd031215a666535c85fc0a7511826a32da | |
| parent | 66d4e0a3373e983b085560f1784f083a28ae05ac (diff) | |
Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.
This is not a merge from current because these files are in the Attic
there.
Notes
svn path=/stable/3/; revision=57721
| -rw-r--r-- | lib/libcurses/PSD.doc/intro.2 | 4 | ||||
| -rw-r--r-- | sbin/i386/mount_msdos/mount_msdos.8 | 12 | ||||
| -rw-r--r-- | sbin/modload/modload.8 | 3 | ||||
| -rw-r--r-- | share/man/man4/al.4 | 27 | ||||
| -rw-r--r-- | share/man/man4/ax.4 | 27 | ||||
| -rw-r--r-- | share/man/man4/imm.4 | 3 | ||||
| -rw-r--r-- | share/man/man4/mx.4 | 48 | ||||
| -rw-r--r-- | share/man/man4/nlpt.4 | 12 | ||||
| -rw-r--r-- | share/man/man4/pn.4 | 42 | ||||
| -rw-r--r-- | share/man/man4/su.4 | 15 | ||||
| -rw-r--r-- | share/man/man4/uk.4 | 3 | ||||
| -rw-r--r-- | share/man/man9/ppbconf.9 | 7 | ||||
| -rw-r--r-- | usr.bin/fpr/fpr.1 | 10 |
13 files changed, 143 insertions, 70 deletions
diff --git a/lib/libcurses/PSD.doc/intro.2 b/lib/libcurses/PSD.doc/intro.2 index d98c0c761982..bd0aa35515c3 100644 --- a/lib/libcurses/PSD.doc/intro.2 +++ b/lib/libcurses/PSD.doc/intro.2 @@ -30,11 +30,13 @@ .\" SUCH DAMAGE. .\" .\" @(#)intro.2 8.1 (Berkeley) 6/4/93 +.\" $FreeBSD$ .\" .sh 1 Variables .pp Many variables which are used to describe the terminal environment -are available to the programmer. They are: +are available to the programmer. +They are: .(b .TS expand; diff --git a/sbin/i386/mount_msdos/mount_msdos.8 b/sbin/i386/mount_msdos/mount_msdos.8 index e3922c206e59..acb473e9318e 100644 --- a/sbin/i386/mount_msdos/mount_msdos.8 +++ b/sbin/i386/mount_msdos/mount_msdos.8 @@ -128,12 +128,14 @@ searches the root directory of the filesystem to be mounted for any existing Win'95 long filenames. If no such entries are found, but short DOS filenames are found, .Fl s -is the default. Otherwise +is the default. +Otherwise .Fl l is assumed. .It Fl 9 Ignore the special Win'95 directory entries even -if deleting or renaming a file. This forces +if deleting or renaming a file. +This forces .Fl s . .\".It Fl G .\"This option causes the filesystem to be interpreted as an Atari-Gemdos @@ -154,10 +156,12 @@ If some code not present in Unicode, use 0x003F code ('?') as replacement. .It DOS to local character set conversion table (upper half) for DOS names, -128 character codes. Code 0x3F ('?') used for impossible translations. +128 character codes. +Code 0x3F ('?') used for impossible translations. .It Local character set to DOS conversion table (upper half) for DOS names, -128 character codes. Some codes have special meaning: +128 character codes. +Some codes have special meaning: .Bl -hang .It 0x00 character disallowed in DOS file name; diff --git a/sbin/modload/modload.8 b/sbin/modload/modload.8 index 7ffc85fd61ed..4dfd22a24d20 100644 --- a/sbin/modload/modload.8 +++ b/sbin/modload/modload.8 @@ -77,7 +77,8 @@ when the module is linked. The default module entry point name is the module name with `_mod' appended. .It Fl p Ar postinstall Specify the name of a shell script or program that will -be executed if the module is successfully loaded. It +be executed if the module is successfully loaded. +It is always passed the module id (in decimal) and module type (in hexadecimal) as the first two arguments. For loadable drivers, the third argument is diff --git a/share/man/man4/al.4 b/share/man/man4/al.4 index f2094db63421..becf64043b9d 100644 --- a/share/man/man4/al.4 +++ b/share/man/man4/al.4 @@ -46,14 +46,16 @@ controllers based on the ADMtek Inc. AL981 Comet and AN 985 Centaur fast ethernet controller chips. .Pp The ADMtek chip uses bus master DMA and is designed to be a -DEC 21x4x workalike. The only major difference between the DEC +DEC 21x4x workalike. +The only major difference between the DEC and ADMtek parts is that the ADMtek receiver filter is programmed using two special registers where as the DEC chip is programmed by uploading a special setup frame via the transmit DMA engine. The AL981 and AN985 can only be programmed with a single perfect filter entry for the local station address and a 64-bit multicast hash table; the DEC filter supports several other -options. The ADMtek fast ethernet controllers support both +options. +The ADMtek fast ethernet controllers support both 10 and 100Mbps speeds in either full or half duplex using an internal MII transceiver. .Pp @@ -69,14 +71,16 @@ the autoselected mode by adding media options to the .Pa /etc/rc.conf fine. .It 10baseT/UTP -Set 10Mbps operation. The +Set 10Mbps operation. +The .Ar mediaopt option can also be used to select either .Ar full-duplex or .Ar half-duplex modes. .It 100baseTX -Set 100Mbps (fast ethernet) operation. The +Set 100Mbps (fast ethernet) operation. +The .Ar mediaopt option can also be used to select either .Ar full-duplex @@ -114,20 +118,25 @@ The driver failed to allocate an mbuf for the transmitter ring when allocating a pad buffer or collapsing an mbuf chain into a cluster. .It "ax%d: chip is in D3 power state -- setting to D0" This message applies only to adapters which support power -management. Some operating systems place the controller in low power +management. +Some operating systems place the controller in low power mode when shutting down, and some PCI BIOSes fail to bring the chip -out of this state before configuring it. The controller loses all of +out of this state before configuring it. +The controller loses all of its PCI configuration in the D3 state, so if the BIOS does not set it back to full power mode in time, it won't be able to configure it -correctly. The driver tries to detect this condition and bring +correctly. +The driver tries to detect this condition and bring the adapter back to the D0 (full power) state, but this may not be -enough to return the driver to a fully operational condition. If +enough to return the driver to a fully operational condition. +If you see this message at boot time and the driver fails to attach the device as a network interface, you will have to perform second warm boot to have the device properly configured. .Pp Note that this condition only occurs when warm booting from another -operating system. If you power down your system prior to booting +operating system. +If you power down your system prior to booting .Fx , the card should be configured correctly. .El diff --git a/share/man/man4/ax.4 b/share/man/man4/ax.4 index 6056f1a374f4..895b8703ddc9 100644 --- a/share/man/man4/ax.4 +++ b/share/man/man4/ax.4 @@ -49,14 +49,16 @@ The AX88141 is a new version of the AX88140A with power management and magic packet support. .Pp The ASIX chip uses bus master DMA and is designed to be a -DEC 21x4x workalike. The only major difference between the DEC +DEC 21x4x workalike. +The only major difference between the DEC and ASIX parts is that the ASIX receiver filter is programmed using two special registers where as the DEC chip is programmed by uploading a special setup frame via the transmit DMA engine. The ASIX receive filter can only be programmed with a single perfect filter entry for the local station address and a 64-bit multicast hash table; the DEC filter supports several other -options. The ASIX fast ethernet controller supports both +options. +The ASIX fast ethernet controller supports both 10 and 100Mbps speeds in either full or half duplex using an external MII transceiver. .Pp @@ -72,7 +74,8 @@ the autoselected mode by adding media options to the .Pa /etc/rc.conf file. .It 10baseT/UTP -Set 10Mbps operation. The +Set 10Mbps operation. +The .Ar mediaopt option can also be used to select either .Ar full-duplex @@ -80,7 +83,8 @@ or .Ar half-duplex modes. .It 100baseTX -Set 100Mbps (fast ethernet) operation. The +Set 100Mbps (fast ethernet) operation. +The .Ar mediaopt option can also be used to select either .Ar full-duplex @@ -118,20 +122,25 @@ The driver failed to allocate an mbuf for the transmitter ring when allocating a pad buffer or collapsing an mbuf chain into a cluster. .It "ax%d: chip is in D3 power state -- setting to D0" This message applies only to adapters which support power -management. Some operating systems place the controller in low power +management. +Some operating systems place the controller in low power mode when shutting down, and some PCI BIOSes fail to bring the chip -out of this state before configuring it. The controller loses all of +out of this state before configuring it. +The controller loses all of its PCI configuration in the D3 state, so if the BIOS does not set it back to full power mode in time, it won't be able to configure it -correctly. The driver tries to detect this condition and bring +correctly. +The driver tries to detect this condition and bring the adapter back to the D0 (full power) state, but this may not be -enough to return the driver to a fully operational condition. If +enough to return the driver to a fully operational condition. +If you see this message at boot time and the driver fails to attach the device as a network interface, you will have to perform second warm boot to have the device properly configured. .Pp Note that this condition only occurs when warm booting from another -operating system. If you power down your system prior to booting +operating system. +If you power down your system prior to booting .Fx , the card should be configured correctly. .El diff --git a/share/man/man4/imm.4 b/share/man/man4/imm.4 index e4135c90ca5c..21d2b7c956e8 100644 --- a/share/man/man4/imm.4 +++ b/share/man/man4/imm.4 @@ -39,7 +39,8 @@ For one or more SCSI busses: .Sh DESCRIPTION The imm driver is an extension of the .Xr vpo 4 -driver for the Iomega Matchmaker Parallel to SCSI interface. This driver +driver for the Iomega Matchmaker Parallel to SCSI interface. +This driver is mostly written with the .Xr microseq 9 mechanism. diff --git a/share/man/man4/mx.4 b/share/man/man4/mx.4 index 23668b10b3e7..87dddaf97c0b 100644 --- a/share/man/man4/mx.4 +++ b/share/man/man4/mx.4 @@ -44,21 +44,27 @@ The .Nm driver provides support for PCI ethernet adapters and embedded controllers based on the Macronix 98713, 98713A, 98715, 98715A and -98725 fast ethernet controller chips. This includes the NDC +98725 fast ethernet controller chips. +This includes the NDC Communications SOHOware SFA110, the SVEC PN102-TX -fast ethernet card, and various other adapters. The +fast ethernet card, and various other adapters. +The .Nm driver also supports the Lite-On 82c115 PNIC II chip, which is actually similar in design to the Macronix 98715A with the addition -of wake on LAN support. Supported PNIC II cards include the +of wake on LAN support. +Supported PNIC II cards include the LinkSys LNE100TX Version 2. .Pp The Macronix chips use bus master DMA and are designed to be -DEC 'tulip' workalikes. The original 98713 had an MII bus for +DEC 'tulip' workalikes. +The original 98713 had an MII bus for controlling an external PHY, however the 98713A and up use an -internal transceiver with NWAY support. The Macronix parts are +internal transceiver with NWAY support. +The Macronix parts are advertised as being register compatible with the DEC 21x4x -controllers. All of the Macronix controllers support both +controllers. +All of the Macronix controllers support both 10 and 100Mbps speeds in either full or half duplex. .Pp The @@ -73,14 +79,16 @@ the autoselected mode by adding media options to the .Pa /etc/rc.conf file. .It 10baseT/UTP -Set 10Mbps operation. The +Set 10Mbps operation. +The .Ar mediaopt option can also be used to select either .Ar full-duplex or .Ar half-duplex modes. .It 100baseTX -Set 100Mbps (fast ethernet) operation. The +Set 100Mbps (fast ethernet) operation. +The .Ar mediaopt option can also be used to select either .Ar full-duplex @@ -120,20 +128,25 @@ The driver failed to allocate an mbuf for the transmitter ring when allocating a pad buffer or collapsing an mbuf chain into a cluster. .It "mx%d: chip is in D3 power state -- setting to D0" This message applies only to adapters which support power -management. Some operating systems place the controller in low power +management. +Some operating systems place the controller in low power mode when shutting down, and some PCI BIOSes fail to bring the chip -out of this state before configuring it. The controller loses all of +out of this state before configuring it. +The controller loses all of its PCI configuration in the D3 state, so if the BIOS does not set it back to full power mode in time, it won't be able to configure it -correctly. The driver tries to detect this condition and bring +correctly. +The driver tries to detect this condition and bring the adapter back to the D0 (full power) state, but this may not be -enough to return the driver to a fully operational condition. If +enough to return the driver to a fully operational condition. +If you see this message at boot time and the driver fails to attach the device as a network interface, you will have to perform second warm boot to have the device properly configured. .Pp Note that this condition only occurs when warm booting from another -operating system. If you power down your system prior to booting +operating system. +If you power down your system prior to booting .Fx , the card should be configured correctly. .El @@ -162,11 +175,14 @@ driver was written by .Sh BUGS The Macronix application notes claim that in order to put the chips in normal operation, the driver must write a certian magic -number into the CSR16 register. The numbers are documented in +number into the CSR16 register. +The numbers are documented in the app notes, but the exact meaning of the bits is not. .Pp The 98713A seems to have a problem with 10Mbps full duplex mode. The transmitter works but the receiver tends to produce many -unexplained errors leading to very poor overall performance. The -98715A does not exhibit this problem. All other modes on the +unexplained errors leading to very poor overall performance. +The +98715A does not exhibit this problem. +All other modes on the 98713A seem to work correctly. diff --git a/share/man/man4/nlpt.4 b/share/man/man4/nlpt.4 index beb5ca8a090b..e842aa223797 100644 --- a/share/man/man4/nlpt.4 +++ b/share/man/man4/nlpt.4 @@ -59,8 +59,10 @@ driver is the port of the original lpt driver to the system. .Pp One purpose of this port was to allow parallel port sharing with other -parallel devices. Secondly, inb()/outb() calls have been replaced by ppbus -function calls. nlpt is now arch-independent thanks to the ppbus interface. See +parallel devices. +Secondly, inb()/outb() calls have been replaced by ppbus +function calls. nlpt is now arch-independent thanks to the ppbus interface. +See .Xr ppbus 4 for more info about the ppbus system. .Pp @@ -76,12 +78,14 @@ command. .Pp Depending on your hardware, extended capabilities may be configured with the .Xr lptcontrol 8 -command. With an ECP/ISA port, you can take advantage +command. +With an ECP/ISA port, you can take advantage of FIFO and DMA. .Pp In order to retrieve printer info from /dev/nlpt0, just apply the .Nm cat -command to the device. If the printer supports IEEE1284 nibble mode and has +command to the device. +If the printer supports IEEE1284 nibble mode and has data to send to the host, you'll get it. .Sh SEE ALSO .Xr ppbus 4 , diff --git a/share/man/man4/pn.4 b/share/man/man4/pn.4 index ba1b5b6d166f..1facd62bcc62 100644 --- a/share/man/man4/pn.4 +++ b/share/man/man4/pn.4 @@ -44,19 +44,24 @@ The .Nm driver provides support for PCI ethernet adapters and embedded controllers based on the Lite-On 82c168 and 82c169 fast ethernet -controller chips. This includes the LinkSys LNE100TX, the +controller chips. +This includes the LinkSys LNE100TX, the Bay Networks Netgear FA310TX revision D1, the Matrox Networks FastNIC 10/100, certain adapters manufactured by D-Link and Trendware, and various other commodity fast ethernet cards. .Pp The Lite-On chips use bus master DMA and are designed to be -DEC 'tulip' workalikes. Many vendors that formerly based their +DEC 'tulip' workalikes. +Many vendors that formerly based their designs around the DEC 21x4x devices are now using the PNIC -instead. The chips support both an internal transceiver -and external transceivers via an MII bus. The Lite-On parts are +instead. +The chips support both an internal transceiver +and external transceivers via an MII bus. +The Lite-On parts are advertised as being register compatible with the DEC 21x4x controllers, however there are some differences in the way the -EEPROM and MII access is done. The PNIC controllers support both +EEPROM and MII access is done. +The PNIC controllers support both 10 and 100Mbps speeds in either full or half duplex. .Pp The @@ -71,14 +76,16 @@ the autoselected mode by adding media options to the .Pa /etc/rc.conf fine. .It 10baseT/UTP -Set 10Mbps operation. The +Set 10Mbps operation. +The .Ar mediaopt option can also be used to select either .Ar full-duplex or .Ar half-duplex modes. .It 100baseTX -Set 100Mbps (fast ethernet) operation. The +Set 100Mbps (fast ethernet) operation. +The .Ar mediaopt option can also be used to select either .Ar full-duplex @@ -118,20 +125,25 @@ The driver failed to allocate an mbuf for the transmitter ring when allocating a pad buffer or collapsing an mbuf chain into a cluster. .It "pn%d: chip is in D3 power state -- setting to D0" This message applies only to adapters which support power -management. Some operating systems place the controller in low power +management. +Some operating systems place the controller in low power mode when shutting down, and some PCI BIOSes fail to bring the chip -out of this state before configuring it. The controller loses all of +out of this state before configuring it. +The controller loses all of its PCI configuration in the D3 state, so if the BIOS does not set it back to full power mode in time, it won't be able to configure it -correctly. The driver tries to detect this condition and bring +correctly. +The driver tries to detect this condition and bring the adapter back to the D0 (full power) state, but this may not be -enough to return the driver to a fully operational condition. If +enough to return the driver to a fully operational condition. +If you see this message at boot time and the driver fails to attach the device as a network interface, you will have to perform second warm boot to have the device properly configured. .Pp Note that this condition only occurs when warm booting from another -operating system. If you power down your system prior to booting +operating system. +If you power down your system prior to booting .Fx , the card should be configured correctly. .El @@ -152,9 +164,11 @@ driver was written by .Sh BUGS The internal NWAY support on the 82c168 chip is horribly broken, which means that autoselection will not work, except maybe for half-duplex -10Mbps links. In order to use other modes (e.g. 100Mbps) it will be +10Mbps links. +In order to use other modes (e.g. 100Mbps) it will be necessary to use .Xr ifconfig 8 -to set the interface manually. Autoselection for 82c169 boards using +to set the interface manually. +Autoselection for 82c169 boards using MII transceivers should work correctly. diff --git a/share/man/man4/su.4 b/share/man/man4/su.4 index 4c636629a7a3..5d9f5f0047e3 100644 --- a/share/man/man4/su.4 +++ b/share/man/man4/su.4 @@ -37,15 +37,19 @@ The .Nm su driver provides support for a -process to address arbitrary locations on the scsi bus. Minor -numbers are mapped 1:1 to bus:target:lun. The lowest three bits being LUN -and the next three bits being TARGET. Remaining bits are the bus number. +process to address arbitrary locations on the scsi bus. +Minor +numbers are mapped 1:1 to bus:target:lun. +The lowest three bits being LUN +and the next three bits being TARGET. +Remaining bits are the bus number. .Pp A scsi adapter must also be separately configured into the system before this driver makes sense. .Pp .Sh KERNEL CONFIGURATION -There are no configuration parameters for the su option. It's either there +There are no configuration parameters for the su option. +It's either there or it's not. .Pp @@ -55,7 +59,8 @@ The driver has no ioctls of it's own but rather acts as a medium for the generic .Xr scsi 4 -ioctls. These are described in +ioctls. +These are described in .Em sys/scsiio.h. diff --git a/share/man/man4/uk.4 b/share/man/man4/uk.4 index e1b81e2f2da0..7cd8f87723a8 100644 --- a/share/man/man4/uk.4 +++ b/share/man/man4/uk.4 @@ -71,7 +71,8 @@ The driver has no ioctls of it's own but rather acts as a medium for the generic .Xr scsi 4 -ioctls. These are described in +ioctls. +These are described in .Em sys/scsiio.h. diff --git a/share/man/man9/ppbconf.9 b/share/man/man9/ppbconf.9 index 9b95e7287593..fc5c56cf45f7 100644 --- a/share/man/man9/ppbconf.9 +++ b/share/man/man9/ppbconf.9 @@ -22,6 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" $FreeBSD$ .\" .Dd April 5, 1998 .Dt PPBCONF 9 @@ -82,12 +83,14 @@ struct ppb_adapter { .Pp This structure is the interface between .Xr ppc 4 -layer and upper ppbus system levels. For each ppc device, this +layer and upper ppbus system levels. +For each ppc device, this structure is filled with generic i/o functions that may be redefined if needed for particular chipsets. .Pp Developers are really encouraged to use the -exec_microseq entry to avoid indirect function call overhead. See +exec_microseq entry to avoid indirect function call overhead. +See .Xr microseq 9 for more info. .Ss The ppbus layer diff --git a/usr.bin/fpr/fpr.1 b/usr.bin/fpr/fpr.1 index 0234c4805f52..1feaa923782a 100644 --- a/usr.bin/fpr/fpr.1 +++ b/usr.bin/fpr/fpr.1 @@ -32,6 +32,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)fpr.1 8.1 (Berkeley) 6/6/93 +.\" $FreeBSD$ .\" .Dd June 6, 1993 .Dt FPR 1 @@ -65,9 +66,12 @@ The first character of each line determines the vertical spacing as follows: .Ed .Pp A blank line is treated as if its first -character is a blank. A blank that appears as a carriage control -character is deleted. A zero is changed to a newline. A one is -changed to a form feed. The effects of a "+" are simulated using +character is a blank. +A blank that appears as a carriage control +character is deleted. +A zero is changed to a newline. A one is +changed to a form feed. +The effects of a "+" are simulated using backspaces. .Sh EXAMPLES .Dl a.out \&| fpr \&| lpr |
