diff options
author | mpp <mpp@FreeBSD.org> | 1997-01-31 00:38:18 +0000 |
---|---|---|
committer | mpp <mpp@FreeBSD.org> | 1997-01-31 00:38:18 +0000 |
commit | 09b7521f96657bc8bdf14a8c3a586488d254c2db (patch) | |
tree | b81fe8dbcffa694d31c08b9fbc8cdbf88245a2d9 | |
parent | 1511fd26d00d731e1cae638fece10bbe433f8d41 (diff) | |
download | FreeBSD-src-09b7521f96657bc8bdf14a8c3a586488d254c2db.zip FreeBSD-src-09b7521f96657bc8bdf14a8c3a586488d254c2db.tar.gz |
Minor mdoc cleanup.
-rw-r--r-- | share/man/man3/queue.3 | 30 | ||||
-rw-r--r-- | share/man/man4/cy.4 | 18 | ||||
-rw-r--r-- | share/man/man4/fdc.4 | 3 | ||||
-rw-r--r-- | share/man/man4/man4.i386/cy.4 | 18 | ||||
-rw-r--r-- | share/man/man4/man4.i386/dgb.4 | 22 | ||||
-rw-r--r-- | share/man/man4/man4.i386/fdc.4 | 3 | ||||
-rw-r--r-- | share/man/man4/man4.i386/gsc.4 | 9 | ||||
-rw-r--r-- | share/man/man4/man4.i386/labpc.4 | 4 | ||||
-rw-r--r-- | share/man/man4/man4.i386/lpt.4 | 10 | ||||
-rw-r--r-- | share/man/man4/man4.i386/matcd.4 | 6 | ||||
-rw-r--r-- | share/man/man4/man4.i386/mcd.4 | 4 | ||||
-rw-r--r-- | share/man/man4/man4.i386/nca.4 | 14 | ||||
-rw-r--r-- | share/man/man4/man4.i386/scd.4 | 2 | ||||
-rw-r--r-- | share/man/man4/man4.i386/sea.4 | 26 | ||||
-rw-r--r-- | share/man/man4/man4.i386/sio.4 | 28 | ||||
-rw-r--r-- | share/man/man4/man4.i386/uha.4 | 11 | ||||
-rw-r--r-- | share/man/man4/man4.i386/wd.4 | 14 | ||||
-rw-r--r-- | share/man/man4/sio.4 | 28 |
18 files changed, 120 insertions, 130 deletions
diff --git a/share/man/man3/queue.3 b/share/man/man3/queue.3 index 23c1431..8dc0d2a 100644 --- a/share/man/man3/queue.3 +++ b/share/man/man3/queue.3 @@ -84,7 +84,7 @@ lists, tail queues, and circular queues .Sh SYNOPSIS .Fd #include <sys/queue.h> -.sp +.\" .Fn SLIST_EMPTY "SLIST_HEAD *head" .Fn SLIST_ENTRY "TYPE" .Fn SLIST_FIRST "SLIST_HEAD *head" @@ -95,7 +95,7 @@ lists, tail queues, and circular queues .Fn SLIST_NEXT "TYPE *elm" "SLIST_ENTRY NAME" .Fn SLIST_REMOVE_HEAD "SLIST_HEAD *head" "SLIST_ENTRY NAME" .Fn SLIST_REMOVE "SLIST_HEAD *head" "TYPE *elm" "TYPE" "SLIST_ENTRY NAME" -.sp +.\" .Fn STAILQ_ENTRY "TYPE" .Fn STAILQ_HEAD "HEADNAME" "TYPE" .Fn STAILQ_INIT "STAILQ_HEAD *head" @@ -104,7 +104,7 @@ lists, tail queues, and circular queues .Fn STAILQ_INSERT_TAIL "STAILQ_HEAD *head" "TYPE *elm" "STAILQ_ENTRY NAME" .Fn STAILQ_REMOVE_HEAD "STAILQ_HEAD *head" "TYPE *elm" "STAILQ_ENTRY NAME" .Fn STAILQ_REMOVE "STAILQ_HEAD *head" "TYPE *elm" "TYPE" "STAILQ_ENTRY NAME" -.sp +.\" .Fn LIST_ENTRY "TYPE" .Fn LIST_HEAD "HEADNAME" "TYPE" .Fn LIST_INIT "LIST_HEAD *head" @@ -112,7 +112,7 @@ lists, tail queues, and circular queues .Fn LIST_INSERT_BEFORE "TYPE *listelm" "TYPE *elm" "LIST_ENTRY NAME" .Fn LIST_INSERT_HEAD "LIST_HEAD *head" "TYPE *elm" "LIST_ENTRY NAME" .Fn LIST_REMOVE "TYPE *elm" "LIST_ENTRY NAME" -.sp +.\" .Fn TAILQ_EMPTY "TAILQ_HEAD *head" .Fn TAILQ_ENTRY "TYPE" .Fn TAILQ_FIRST "TAILQ_HEAD *head" @@ -125,7 +125,7 @@ lists, tail queues, and circular queues .Fn TAILQ_LAST "TAILQ_HEAD *head" .Fn TAILQ_NEXT "TYPE *elm" "TAILQ_ENTRY NAME" .Fn TAILQ_REMOVE "TAILQ_HEAD *head" "TYPE *elm" "TAILQ_ENTRY NAME" -.sp +.\" .Fn CIRCLEQ_ENTRY "TYPE" .Fn CIRCLEQ_HEAD "HEADNAME" "TYPE" .Fn CIRCLEQ_INIT "CIRCLEQ_HEAD *head" @@ -274,7 +274,7 @@ structure is declared as follows: .Bd -literal -offset indent SLIST_HEAD(HEADNAME, TYPE) head; .Ed -.sp +.Pp where .Fa HEADNAME is the name of the structure to be defined, and @@ -284,7 +284,7 @@ A pointer to the head of the list can later be declared as: .Bd -literal -offset indent struct HEADNAME *headp; .Ed -.sp +.Pp (The names .Li head and @@ -383,7 +383,7 @@ structure is declared as follows: .Bd -literal -offset indent STAILQ_HEAD(HEADNAME, TYPE) head; .Ed -.sp +.Pp where .Li HEADNAME is the name of the structure to be defined, and @@ -393,7 +393,7 @@ A pointer to the head of the tail queue can later be declared as: .Bd -literal -offset indent struct HEADNAME *headp; .Ed -.sp +.Pp (The names .Li head and @@ -509,7 +509,7 @@ structure is declared as follows: .Bd -literal -offset indent LIST_HEAD(HEADNAME, TYPE) head; .Ed -.sp +.Pp where .Fa HEADNAME is the name of the structure to be defined, and @@ -519,7 +519,7 @@ A pointer to the head of the list can later be declared as: .Bd -literal -offset indent struct HEADNAME *headp; .Ed -.sp +.Pp (The names .Li head and @@ -622,7 +622,7 @@ structure is declared as follows: .Bd -literal -offset indent TAILQ_HEAD(HEADNAME, TYPE) head; .Ed -.sp +.Pp where .Li HEADNAME is the name of the structure to be defined, and @@ -632,7 +632,7 @@ A pointer to the head of the tail queue can later be declared as: .Bd -literal -offset indent struct HEADNAME *headp; .Ed -.sp +.Pp (The names .Li head and @@ -761,7 +761,7 @@ structure is declared as follows: .Bd -literal -offset indent CIRCLEQ_HEAD(HEADNAME, TYPE) head; .Ed -.sp +.Pp where .Li HEADNAME is the name of the structure to be defined, and @@ -771,7 +771,7 @@ A pointer to the head of the circular queue can later be declared as: .Bd -literal -offset indent struct HEADNAME *headp; .Ed -.sp +.Pp (The names .Li head and diff --git a/share/man/man4/cy.4 b/share/man/man4/cy.4 index 8d32768..f1b438c 100644 --- a/share/man/man4/cy.4 +++ b/share/man/man4/cy.4 @@ -47,18 +47,16 @@ Cyclades Cyclom-8Y and Cyclom-16Y serial driver .Sh SYNOPSIS .Cd "device cy0 at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000 vector cyintr .Cd "device cy1 at isa? tty irq 11 iomem 0xd6000 iosiz 0x2000 vector cyintr -.sp +.Pp Minor numbering: -.br +..Pp +.Bd -literal 0b\fIOLIMMMMM\fR -.br call\fBO\fRut -.br \fBL\fRock -.br \fBI\fRnitial -.br \fBMMMMMM\fRinor +.Ed .Sh DESCRIPTION The .Nm cy @@ -120,7 +118,7 @@ Use .Xr stty 1 in the normal way on the initial-state devices to program initial termios states suitable for your setup. -.sp +.Pp The lock termios state acts as flags to disable changing the termios state. E.g., to lock a flag variable such as CRTSCTS, use @@ -128,7 +126,7 @@ CRTSCTS, use on the lock-state device. Speeds and special characters may be locked by setting the corresponding value in the lock-state device to any nonzero value. -.sp +.Pp Correct programs talking to correctly wired external devices work with almost arbitrary initial states and almost no locking, but other setups may benefit from changing some of the default @@ -154,7 +152,7 @@ for callin ports .It Pa /dev/ttyic? .It Pa /dev/ttylc? corresponding callin initial-state and lock-state devices -.sp +.Pp .\" XXX more cloning: s/a/c/g. No consistency :-(. .It Pa /dev/cuac? for callout ports @@ -162,7 +160,7 @@ for callout ports .It Pa /dev/cualc? corresponding callout initial-state and lock-state devices .El -.sp +.Pp .Bl -tag -width /etc/rc.serial -compact .It Pa /etc/rc.serial examples of setting the initial-state and lock-state devices diff --git a/share/man/man4/fdc.4 b/share/man/man4/fdc.4 index 30e2317..0ea766a 100644 --- a/share/man/man4/fdc.4 +++ b/share/man/man4/fdc.4 @@ -34,11 +34,10 @@ .Nd PC architecture floppy disk controller driver .Sh SYNOPSIS -.sp .Cd "controller fdc0 at isa? port" \&"IO_FD1\&" bio irq 6 drq 2 vector fdintr .Cd "disk fd0 at fdc0 drive 0 .Cd "disk fd1 at fdc0 drive 1 -.sp +.Pp For QIC40 and QIC80 tapedrives controlled by the floppy controller: .Cd "tape ft0 at fdc0 drive 2 .Sh DESCRIPTION diff --git a/share/man/man4/man4.i386/cy.4 b/share/man/man4/man4.i386/cy.4 index 8d32768..f1b438c 100644 --- a/share/man/man4/man4.i386/cy.4 +++ b/share/man/man4/man4.i386/cy.4 @@ -47,18 +47,16 @@ Cyclades Cyclom-8Y and Cyclom-16Y serial driver .Sh SYNOPSIS .Cd "device cy0 at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000 vector cyintr .Cd "device cy1 at isa? tty irq 11 iomem 0xd6000 iosiz 0x2000 vector cyintr -.sp +.Pp Minor numbering: -.br +..Pp +.Bd -literal 0b\fIOLIMMMMM\fR -.br call\fBO\fRut -.br \fBL\fRock -.br \fBI\fRnitial -.br \fBMMMMMM\fRinor +.Ed .Sh DESCRIPTION The .Nm cy @@ -120,7 +118,7 @@ Use .Xr stty 1 in the normal way on the initial-state devices to program initial termios states suitable for your setup. -.sp +.Pp The lock termios state acts as flags to disable changing the termios state. E.g., to lock a flag variable such as CRTSCTS, use @@ -128,7 +126,7 @@ CRTSCTS, use on the lock-state device. Speeds and special characters may be locked by setting the corresponding value in the lock-state device to any nonzero value. -.sp +.Pp Correct programs talking to correctly wired external devices work with almost arbitrary initial states and almost no locking, but other setups may benefit from changing some of the default @@ -154,7 +152,7 @@ for callin ports .It Pa /dev/ttyic? .It Pa /dev/ttylc? corresponding callin initial-state and lock-state devices -.sp +.Pp .\" XXX more cloning: s/a/c/g. No consistency :-(. .It Pa /dev/cuac? for callout ports @@ -162,7 +160,7 @@ for callout ports .It Pa /dev/cualc? corresponding callout initial-state and lock-state devices .El -.sp +.Pp .Bl -tag -width /etc/rc.serial -compact .It Pa /etc/rc.serial examples of setting the initial-state and lock-state devices diff --git a/share/man/man4/man4.i386/dgb.4 b/share/man/man4/man4.i386/dgb.4 index 3e1bc9e..f8a4753 100644 --- a/share/man/man4/man4.i386/dgb.4 +++ b/share/man/man4/man4.i386/dgb.4 @@ -48,7 +48,7 @@ DigiBoard intelligent serial cards driver .Cd "options" \&"NDGBPORTS=8\&" .Cd "device dgb0 at isa? tty port 0x220 iomem 0xfc0000 iosiz ? flags 0x0 All values are just examples. -.sp +.Pp The \fBNDGBPORTS\fR option defines the total number of ports on all cards installed in the system. When not defined the number is computed: @@ -59,13 +59,13 @@ If it is less than the actual number of ports the system will be able to use only the first \fBNDGBPORTS\fR ports. If it is greater then all ports will be usable but some memory will be wasted. -.sp +.Pp Meaning of \fBflags\fR: .br \fB0x0001\fR use alternate pinout (exchange DCD and DSR lines) .br \fB0x0002\fR don't use 8K window mode of PC/Xe -.sp +.Pp Device numbering: .br 0b\fICC\fRmmmmmmmm\fIOLIPPPPP\fR @@ -103,12 +103,12 @@ DigiBoard cards have large input and output buffers (more than 1Kbyte per port) and hardware that allows efficiently finding the port that needs attention. The only problem seen with this policy is slower SLIP and PPP response. -.sp +.Pp Each line in the kernel configuration file describes one card, not one port as in the .Nm sio driver. -.sp +.Pp The .Nm flags keyword may be used on each @@ -120,7 +120,7 @@ which can work with an 8K memory window in compatibility mode that using 8K memory window doesn't mean shorter input/output buffers, it means only that all buffers will be mapped to the same memory address and switched as needed. -.sp +.Pp The .Nm port value must be the same @@ -140,7 +140,7 @@ write the address you want as the .Nm iomem value in kernel config file and the card will be programmed to use this address. -.sp +.Pp The same range of memory addresses may be used for all the DigiBoards installed (but not for any other card or real memory). DigiBoards @@ -192,7 +192,7 @@ Use .Xr stty 1 in the normal way on the initial-state devices to program initial termios states suitable for your setup. -.sp +.Pp The lock termios state acts as flags to disable changing the termios state. E.g., to lock a flag variable such as CRTSCTS, use @@ -200,7 +200,7 @@ CRTSCTS, use on the lock-state device. Speeds and special characters may be locked by setting the corresponding value in the lock-state device to any nonzero value. -.sp +.Pp Correct programs talking to correctly wired external devices .\" XXX change next line in other man pages too, and rewrite this paragraph. work with almost arbitrary initial states and no locking, @@ -226,14 +226,14 @@ for callin ports .It Pa /dev/ttyiD?? .It Pa /dev/ttylD?? corresponding callin initial-state and lock-state devices -.sp +.Pp .It Pa /dev/cuaD?? for callout ports .It Pa /dev/cuaiD?? .It Pa /dev/cualD?? corresponding callout initial-state and lock-state devices .El -.sp +.Pp .Bl -tag -width /etc/rc.serial -compact .It Pa /etc/rc.serial examples of setting the initial-state and lock-state devices diff --git a/share/man/man4/man4.i386/fdc.4 b/share/man/man4/man4.i386/fdc.4 index 30e2317..0ea766a 100644 --- a/share/man/man4/man4.i386/fdc.4 +++ b/share/man/man4/man4.i386/fdc.4 @@ -34,11 +34,10 @@ .Nd PC architecture floppy disk controller driver .Sh SYNOPSIS -.sp .Cd "controller fdc0 at isa? port" \&"IO_FD1\&" bio irq 6 drq 2 vector fdintr .Cd "disk fd0 at fdc0 drive 0 .Cd "disk fd1 at fdc0 drive 1 -.sp +.Pp For QIC40 and QIC80 tapedrives controlled by the floppy controller: .Cd "tape ft0 at fdc0 drive 2 .Sh DESCRIPTION diff --git a/share/man/man4/man4.i386/gsc.4 b/share/man/man4/man4.i386/gsc.4 index 6f0da4e..8d0b665 100644 --- a/share/man/man4/man4.i386/gsc.4 +++ b/share/man/man4/man4.i386/gsc.4 @@ -38,7 +38,7 @@ .Nd a device driver for a handy scanner .Sh SYNOPSIS .Fd #include <machine/gsc.h> -.sp +.Pp .Cd Minor number bits: Ar uu d g p ... .Bl -tag -width "uu " -compact -offset indent .It Ar uu @@ -60,7 +60,7 @@ vs. portable .Em pnm output .El -.sp +.Pp .Sh DESCRIPTION The .Nm gsc @@ -164,8 +164,9 @@ width Values which are not reported in the above table will cause the ioctl call to fail with .Xr errno 2 -set to EINVAL. -.sp +set to +.Er EINVAL . +.Pp As you can see, there are width values > 1696. This does, however, not mean that you can obtain scanned lines longer than the width of your scanner or by higher resolutions. Actually, the resolution is selected diff --git a/share/man/man4/man4.i386/labpc.4 b/share/man/man4/man4.i386/labpc.4 index 5091368..a7358fc 100644 --- a/share/man/man4/man4.i386/labpc.4 +++ b/share/man/man4/man4.i386/labpc.4 @@ -51,7 +51,7 @@ National Instruments LABPC and LABPC+ driver .Sh DESCRIPTION This supports the National Instruments LABPC and LABPC+ \fILow-Cost Multifunction I/O Board\fP. -.sp +.Pp This board provides 8 12 bit A-D input channels, 2 12 bit D-A output channels, and 3 8 bit digital I/O ports. It also supports setting up the National Instruments SCXI bus off the digital I/O ports, @@ -120,7 +120,7 @@ integers and returns the cuurrent board gains. .Sh BUGS In general, only those capabilities that I needed are present. In particular the following notable restrictions are present. -.sp +.Pp The analog input is only supported in a clocked conversion mode. .Pp You can only set the sample clock down to 15 Hz. Anything slower diff --git a/share/man/man4/man4.i386/lpt.4 b/share/man/man4/man4.i386/lpt.4 index 0242431..b84f1e9 100644 --- a/share/man/man4/man4.i386/lpt.4 +++ b/share/man/man4/man4.i386/lpt.4 @@ -42,22 +42,22 @@ For interrupt-driven ports: .Cd "device lpt0 at isa? port" \&"IO_LPT1\&" tty irq 7 vector lptintr .Cd "device lpt1 at isa? port" \&"IO_LPT2\&" tty irq 7 vector lptintr .Cd "device lpt2 at isa? port" \&"IO_LPT3\&" tty irq 7 vector lptintr -.sp +.Pp For BIOS-probed ports: .Cd "device lpt0 at isa? port? tty irq 7 vector lptintr" -.sp +.Pp For polled ports: .Cd "device lpt0 at isa? port? tty" .Cd "device lpt1 at isa? port" \&"IO_LPT2\&" tty .Sh DESCRIPTION This driver provides access to parallel ports. -.sp +.Pp The driver can be configured either to be either interrupt-driven, or to poll the printer. Ports that are configured to be interrupt-driven can be switched to polled mode by using the .Xr lptcontrol 8 command. -.sp +.Pp This driver replaces the functionality of the .Xr lpa 4 driver, which is now defunct. @@ -70,7 +70,7 @@ first parallel port driver .Xr lptcontrol 8 .Sh BUGS There are lots of them, especially in cheap parallel port implementations. -.sp +.Pp It is only possible to open a lpt port when a printer is connected and on-line, making it impossible to run .Xr lptcontrol 8 diff --git a/share/man/man4/man4.i386/matcd.4 b/share/man/man4/man4.i386/matcd.4 index e9c8009..772e324 100644 --- a/share/man/man4/man4.i386/matcd.4 +++ b/share/man/man4/man4.i386/matcd.4 @@ -89,13 +89,13 @@ .Nm matcd .Nd Matsushita (Panasonic) CD-ROM driver .Sh SYNOPSIS -.sp +.Pp .Cd "controller matcd[0-4] at isa? port [?| addr]" .br .Cd "/dev/[r]matcd[0-15][a|c] .br .Cd "/dev/[r]matcdl[0-15][a|c] -.sp +.Pp .Sh DESCRIPTION The .Nm matcd @@ -286,7 +286,7 @@ accepts numerous .Fn ioctl commands, including disk and functions related to CD-ROM audio and tray control features. The commands are: -.sp +.Pp .Bl -tag -width CDIOCREADSUBCHANNELXXX -compact -offset indent .It DIOCGDINFO get disklabel. diff --git a/share/man/man4/man4.i386/mcd.4 b/share/man/man4/man4.i386/mcd.4 index 17fce6f..cfb3298 100644 --- a/share/man/man4/man4.i386/mcd.4 +++ b/share/man/man4/man4.i386/mcd.4 @@ -32,9 +32,7 @@ .Nm mcd .Nd Mitsumi CD-ROM driver .Sh SYNOPSIS -.sp .Cd "device mcd0 at isa? port 0x300 bio irq 10 vector mcdintr" -.sp .Sh DESCRIPTION The .Nm mcd @@ -66,7 +64,7 @@ driver also responds to special CD-ROM commands. These commands control the CD-ROM player's audio features. The commands are: -.sp +.Pp .Bl -tag -width CDIOCREADSUBCHANNEL -compact -offset indent .It CDIOCREADSUBCHANNEL get sub-channel information on current status of disc playing diff --git a/share/man/man4/man4.i386/nca.4 b/share/man/man4/man4.i386/nca.4 index fef37fe..9d0e900 100644 --- a/share/man/man4/man4.i386/nca.4 +++ b/share/man/man4/man4.i386/nca.4 @@ -17,16 +17,16 @@ Generic NCR-5380/NCR-53C400 SCSI adapter driver .Sh SYNOPSIS Trantor 130, with IRQ: .Cd "controller nca0 at isa? port 0x350 bio irq 5 vector ncaintr -.sp +.Pp Trantor 130, without IRQ: .Cd "controller nca0 at isa? port 0x350 -.sp +.Pp ProAudioSpectrum-16, with IRQ: .Cd "controller nca0 at isa? port 0x1f88 bio irq 5 vector ncaintr .Cd "controller nca1 at isa? port 0x1f84 bio irq 5 vector ncaintr .Cd "controller nca2 at isa? port 0x1f8c bio irq 5 vector ncaintr .Cd "controller nca3 at isa? port 0x1e88 bio irq 5 vector ncaintr -.sp +.Pp ProAudioSpectrum-16, without IRQ: .Cd "controller nca0 at isa? port 0x1f88 .Cd "controller nca1 at isa? port 0x1f84 @@ -35,19 +35,19 @@ ProAudioSpectrum-16, without IRQ: .Sh DESCRIPTION This driver provides access to SCSI devices connected to NCR-5380/NCR-53C400 SCSI adapter. -.sp +.Pp It's possible to use the adapter without IRQ line. The data rate then slightly decreases (by 20-30%). -.sp +.Pp The \fBflags\fP keyword in the configuration file can be used to set some adapter driver parameters: -.sp +.Pp Bits Description .br ------------------------------------------ .br 0x01 Disable SCSI bus parity check. -.sp +.Pp Tested on the following hardware: .br Adapter: Trantor T130 diff --git a/share/man/man4/man4.i386/scd.4 b/share/man/man4/man4.i386/scd.4 index 2b53810..f62a911 100644 --- a/share/man/man4/man4.i386/scd.4 +++ b/share/man/man4/man4.i386/scd.4 @@ -32,9 +32,7 @@ .Nm scd .Nd Sony CDU31/33 CD-ROM driver .Sh SYNOPSIS -.sp .Cd "device scd0 at isa? port 0x230 bio" -.sp .Sh DESCRIPTION The .Nm scd diff --git a/share/man/man4/man4.i386/sea.4 b/share/man/man4/man4.i386/sea.4 index e53059f..dcd7351 100644 --- a/share/man/man4/man4.i386/sea.4 +++ b/share/man/man4/man4.i386/sea.4 @@ -18,55 +18,55 @@ Seagate ST01/ST02, Future Domain TMC-885, TMC-950 SCSI adapter driver .Sh SYNOPSIS With explicit memory and IRQ parameters: .Cd "controller sea0 at isa? bio irq 5 iomem 0xc8000 vector seaintr -.sp +.Pp With automatic memory address detection and no IRQ: .Cd "controller sea0 at isa? -.sp +.Pp .Cd "controller scbus0 -.sp +.Pp For each connected disk: .Cd "device sd0 -.sp +.Pp For each connected tape device: .Cd "device st0 -.sp +.Pp For one or more cdroms: .Cd "device cd0 .Sh DESCRIPTION This driver provides access to SCSI devices connected to Seagate ST01/ST02 or Future Domain TMC-885, TMC-950 SCSI adapter. -.sp +.Pp It's possible to use the Seagate ST01/ST02 adapter without IRQ line. The data rate then slightly decreases (by 20-30%). -.sp +.Pp The \fBflags\fP keyword in the configuration file can be used to set some adapter driver parameters: -.sp +.Pp Bits Description .br ------------------------------------------ .br 0x01 Disable SCSI bus parity check. -.sp +.Pp The original Seagate ST02 BIOS cannot coexist with IDE or any other disk controller because it does not share BIOS disk drive numbers (80h, 81h) with others. The probing code of the driver allows using ST02 controller without BIOS: just unplug the ST02 BIOS chip from the board. -.sp +.Pp Another problem is the floppy adapter on ST02 which could not be disabled by jumpers. The ST02 adapter it the best as a cheap solution for atttaching the tape and CD-ROM drives, and an extra floppy controller is just a headache. There exist a simple workaround: cutting off the AEN signal (A11 contact on ISA connector). AEN then goes high and disables the floppy adapter port address decoder. -.sp +.Pp Some motherboards also have a problem with ST02 conflicting with IDE during IDE data write phase. It seems than ST02 makes some noise on /IOW line. The /IOW line is used only for floppy controller part of ST02, and because it's rarely needed, cutting off the /IOW (contact B13) will help. -.sp +.Pp Tested on the following hardware: .br Adapter: Seagate ST02 @@ -76,7 +76,7 @@ Tested on the following hardware: Streamers: Archive Viper 150, Wangtek 5525 .br CD-ROMs: Toshiba XM-3401, NEC CDR-25 -.sp +.Pp Maximum data rate is about 270-280 kbytes/sec (on 386DX/40). .Sh FILES .Bl -tag -width Pa -compact diff --git a/share/man/man4/man4.i386/sio.4 b/share/man/man4/man4.i386/sio.4 index 2ce4437..b9001d3 100644 --- a/share/man/man4/man4.i386/sio.4 +++ b/share/man/man4/man4.i386/sio.4 @@ -49,24 +49,24 @@ For standard ports: .Cd "device sio1 at isa? port" \&"IO_COM2\&" tty irq 3 vector siointr .Cd "device sio2 at isa? port" \&"IO_COM3\&" tty irq 5 vector siointr .Cd "device sio3 at isa? port" \&"IO_COM4\&" tty irq 9 vector siointr -.sp +.Pp For AST compatible multiport cards with 4 ports: .Cd "options" \&"COM_MULTIPORT\&" .Cd "device sio4 at isa? port 0x2a0 tty flags 0x701" .Cd "device sio5 at isa? port 0x2a8 tty flags 0x701" .Cd "device sio6 at isa? port 0x2b0 tty flags 0x701" .Cd "device sio7 at isa? port 0x2b8 tty flags 0x701 irq 12 vector siointr" -.sp +.Pp For Boca Board compatible multiport cards with 8 ports: .Cd "options" \&"COM_MULTIPORT\&" .Cd "device sio4 at isa? port 0x100 tty flags 0xb05" .Cd "..." .Cd "device sio11 at isa? port 0x138 tty flags 0xb05 irq 12 vector siointr" -.sp +.Pp For Hayes ESP cards: .Cd "options" \&"COM_ESP\&" .Cd "..." -.sp +.Pp Meaning of \fBflags\fR: .br \fB0x0001\fR shared IRQs @@ -80,7 +80,7 @@ Meaning of \fBflags\fR: \fB0x0080\fR enable diagnostics in probe .br \fB0x\fI??\fB00\fR minor number of master port -.sp +.Pp Minor numbering: .br 0b\fIOLIMMMMM\fR @@ -116,7 +116,7 @@ Frequently 4 ports share 1 IRQ; some 8 port cards have 2 groups of 4 ports, thus using 2 IRQs. Some cards allow the first 2 serial ports to have seperate IRQs per port (as per DOS PC standard). -.sp +.Pp Some cards have an IRQ control register for each group. Some cards require special initialization related to such registers. Only AST/4 compatible IRQ control registers are supported. @@ -128,7 +128,7 @@ of a port in the group. Such a port is called a .Nm master port. -.sp +.Pp The .Nm flags keyword may be used on each @@ -140,7 +140,7 @@ or to disable the FIFO on 16550A UARTs Disabling the FIFO should rarely be necessary since the driver automatically adjusts the receiver FIFO trigger level for low latency and high efficiency. -.sp +.Pp The .Nm flags keyword @@ -152,7 +152,7 @@ require AST/4 compatible initialization. The minor number of the device corresponding a master port for the group is encoded as a bitfield in the high byte. The same master port must be specified for all ports in a group. -.sp +.Pp The .Nm irq and @@ -166,7 +166,7 @@ In the synopsis, means that the 8th port (sio7) is the master port, and that the port is on a multiport card with shared IRQs and an AST/4 compatible IRQ control register. -.sp +.Pp .Nm flags 0xb05 means that the 12th port (sio11) is the master port, and that the port is on a multiport card with shared IRQs @@ -214,7 +214,7 @@ Use .Xr stty 1 in the normal way on the initial-state devices to program initial termios states suitable for your setup. -.sp +.Pp The lock termios state acts as flags to disable changing the termios state. E.g., to lock a flag variable such as CRTSCTS, use @@ -222,7 +222,7 @@ CRTSCTS, use on the lock-state device. Speeds and special characters may be locked by setting the corresponding value in the lock-state device to any nonzero value. -.sp +.Pp Correct programs talking to correctly wired external devices work with almost arbitrary initial states and almost no locking, but other setups may benefit from changing some of the default @@ -247,14 +247,14 @@ for callin ports .It Pa /dev/ttyid? .It Pa /dev/ttyld? corresponding callin initial-state and lock-state devices -.sp +.Pp .It Pa /dev/cuaa? for callout ports .It Pa /dev/cuaia? .It Pa /dev/cuala? corresponding callout initial-state and lock-state devices .El -.sp +.Pp .Bl -tag -width /etc/rc.serial -compact .It Pa /etc/rc.serial examples of setting the initial-state and lock-state devices diff --git a/share/man/man4/man4.i386/uha.4 b/share/man/man4/man4.i386/uha.4 index d35b487..d6a509e 100644 --- a/share/man/man4/man4.i386/uha.4 +++ b/share/man/man4/man4.i386/uha.4 @@ -33,27 +33,26 @@ .Nd Ultrastore SCSI host adapter driver .Sh SYNOPSIS -.sp For Ultrastore 24f controllers in EISA mode: .Cd "controller uha0 at isa? bio irq ? vector uhaintr .Cd "controller scbus0 -.sp +.Pp For Ultrastore 14f and 34f controllers: .Cd "controller uha0 at isa? port" \&"IO_UHA0\&" bio irq ? drq 5 vector uhaintr .Cd "controller scbus0 -.sp +.Pp For each disk: .Cd "device sd0 -.sp +.Pp For each tape device: .Cd "device st0 -.sp +.Pp For one or more cdroms: .Cd "device cd0 .Sh DESCRIPTION This driver provides access to SCSI devices connected to an Ultrastore Ultrastore 14f, Ultrastore 24f or Ultrastore 34f hostadapter. -.sp +.Pp Note that for an Ultrastore 24f in EISA mode no I/O addresses or DMA channels are required in the kernel config file. If they are present, the driver will correctly find the Ultrastore 24f, but you tie up precious DMA channels diff --git a/share/man/man4/man4.i386/wd.4 b/share/man/man4/man4.i386/wd.4 index 423f3be..cb1e774 100644 --- a/share/man/man4/man4.i386/wd.4 +++ b/share/man/man4/man4.i386/wd.4 @@ -33,25 +33,23 @@ .Nd Generic WD100x/IDE diskcontroller driver .Sh SYNOPSIS -.sp .Cd "controller wdc0 at isa? port" \&"IO_WD1\&" bio irq 14 vector wdintr .Cd "disk wd0 at wdc0 drive 0 .Cd "disk wd1 at wdc0 drive 1 -.sp .Sh DESCRIPTION This driver provides access to disks connected to controllers that emulate the Western Digital WD100x series. This range of controllers includes WD1003 type ST412 controllers, WD1007 ESDI controllers and also the generic IDE controllers found on most motherboards. -.sp +.Pp Your controller documentation is usually quick to point out any WD100x compatibility. -.sp +.Pp You can convey a number of hints and instructions to the driver using the .Ar flags parameter. -.sp +.Pp For each drive there are four bit-fields encoded in a 16 bit integer: .Bl -tag -width 0x0000 -offset 1c .It 0x8000 @@ -66,7 +64,7 @@ of cylinders to match. Test and use multi-sector transfer mode of this drive, max number of sectors attempted is (flags & 0x00ff). .El -.sp +.Pp The flags can be specified on the line for the drive as a 16 bit int, or on the controller line as a 32 bit int, where the top 16 bit is relevant to the highest numbered drive. @@ -85,4 +83,6 @@ driver source .Xr bad144 8 .Sh NOTES This controller/disk combo has no provisions for automatic bad block handling. -You need to run bad144(8) to check for bad blocks. +You need to run +.Xr bad144 8 +to check for bad blocks. diff --git a/share/man/man4/sio.4 b/share/man/man4/sio.4 index 2ce4437..b9001d3 100644 --- a/share/man/man4/sio.4 +++ b/share/man/man4/sio.4 @@ -49,24 +49,24 @@ For standard ports: .Cd "device sio1 at isa? port" \&"IO_COM2\&" tty irq 3 vector siointr .Cd "device sio2 at isa? port" \&"IO_COM3\&" tty irq 5 vector siointr .Cd "device sio3 at isa? port" \&"IO_COM4\&" tty irq 9 vector siointr -.sp +.Pp For AST compatible multiport cards with 4 ports: .Cd "options" \&"COM_MULTIPORT\&" .Cd "device sio4 at isa? port 0x2a0 tty flags 0x701" .Cd "device sio5 at isa? port 0x2a8 tty flags 0x701" .Cd "device sio6 at isa? port 0x2b0 tty flags 0x701" .Cd "device sio7 at isa? port 0x2b8 tty flags 0x701 irq 12 vector siointr" -.sp +.Pp For Boca Board compatible multiport cards with 8 ports: .Cd "options" \&"COM_MULTIPORT\&" .Cd "device sio4 at isa? port 0x100 tty flags 0xb05" .Cd "..." .Cd "device sio11 at isa? port 0x138 tty flags 0xb05 irq 12 vector siointr" -.sp +.Pp For Hayes ESP cards: .Cd "options" \&"COM_ESP\&" .Cd "..." -.sp +.Pp Meaning of \fBflags\fR: .br \fB0x0001\fR shared IRQs @@ -80,7 +80,7 @@ Meaning of \fBflags\fR: \fB0x0080\fR enable diagnostics in probe .br \fB0x\fI??\fB00\fR minor number of master port -.sp +.Pp Minor numbering: .br 0b\fIOLIMMMMM\fR @@ -116,7 +116,7 @@ Frequently 4 ports share 1 IRQ; some 8 port cards have 2 groups of 4 ports, thus using 2 IRQs. Some cards allow the first 2 serial ports to have seperate IRQs per port (as per DOS PC standard). -.sp +.Pp Some cards have an IRQ control register for each group. Some cards require special initialization related to such registers. Only AST/4 compatible IRQ control registers are supported. @@ -128,7 +128,7 @@ of a port in the group. Such a port is called a .Nm master port. -.sp +.Pp The .Nm flags keyword may be used on each @@ -140,7 +140,7 @@ or to disable the FIFO on 16550A UARTs Disabling the FIFO should rarely be necessary since the driver automatically adjusts the receiver FIFO trigger level for low latency and high efficiency. -.sp +.Pp The .Nm flags keyword @@ -152,7 +152,7 @@ require AST/4 compatible initialization. The minor number of the device corresponding a master port for the group is encoded as a bitfield in the high byte. The same master port must be specified for all ports in a group. -.sp +.Pp The .Nm irq and @@ -166,7 +166,7 @@ In the synopsis, means that the 8th port (sio7) is the master port, and that the port is on a multiport card with shared IRQs and an AST/4 compatible IRQ control register. -.sp +.Pp .Nm flags 0xb05 means that the 12th port (sio11) is the master port, and that the port is on a multiport card with shared IRQs @@ -214,7 +214,7 @@ Use .Xr stty 1 in the normal way on the initial-state devices to program initial termios states suitable for your setup. -.sp +.Pp The lock termios state acts as flags to disable changing the termios state. E.g., to lock a flag variable such as CRTSCTS, use @@ -222,7 +222,7 @@ CRTSCTS, use on the lock-state device. Speeds and special characters may be locked by setting the corresponding value in the lock-state device to any nonzero value. -.sp +.Pp Correct programs talking to correctly wired external devices work with almost arbitrary initial states and almost no locking, but other setups may benefit from changing some of the default @@ -247,14 +247,14 @@ for callin ports .It Pa /dev/ttyid? .It Pa /dev/ttyld? corresponding callin initial-state and lock-state devices -.sp +.Pp .It Pa /dev/cuaa? for callout ports .It Pa /dev/cuaia? .It Pa /dev/cuala? corresponding callout initial-state and lock-state devices .El -.sp +.Pp .Bl -tag -width /etc/rc.serial -compact .It Pa /etc/rc.serial examples of setting the initial-state and lock-state devices |