[src/trunk]: src/share/man/man4 Add a full list of config(8) lines from sys/a...

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

details:   https://anonhg.NetBSD.org/src/rev/3a2f6cf5ad8e
branches:  trunk
changeset: 546578:3a2f6cf5ad8e
user:      fair <fair%NetBSD.org@localhost>
date:      Fri May 02 00:42:40 2003 +0000

description:
Add a full list of config(8) lines from sys/arch/*/conf/GENERIC
Add ms(4) and kbd(4) to SEE ALSO.
Correct Ud -> Ux in HISTORY.
Add links to zs.4 and zsc.4 to make this easier to find.
Mention "Zilog 8530" in the Nd so that the permuted index will find
this driver.

diffstat:

 share/man/man4/Makefile |    3 +-
 share/man/man4/zstty.4  |  126 ++++++++++++++++++++++++++++++++++++++++++-----
 2 files changed, 114 insertions(+), 15 deletions(-)

diffs (189 lines):

diff -r 5ad993a6b860 -r 3a2f6cf5ad8e share/man/man4/Makefile
--- a/share/man/man4/Makefile   Thu May 01 23:25:52 2003 +0000
+++ b/share/man/man4/Makefile   Fri May 02 00:42:40 2003 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.284 2003/05/01 08:36:50 gmcgarry Exp $
+#      $NetBSD: Makefile,v 1.285 2003/05/02 00:42:40 fair Exp $
 #      @(#)Makefile    8.1 (Berkeley) 6/18/93
 
 MAN=   aac.4 acphy.4 adv.4 adw.4 agp.4 ahb.4 ahc.4 amdpm.4 \
@@ -117,6 +117,7 @@
 MLINKS+=rcons.4 rasterconsole.4
 MLINKS+=irframe.4 irda.4
 MLINKS+=icp.4 icpsp.4
+MLINKS+=zstty.4 zs.4 zstty.4 zsc.4
 
 # This is a hack
 MLINKS+=edc.4 i386/ed.4
diff -r 5ad993a6b860 -r 3a2f6cf5ad8e share/man/man4/zstty.4
--- a/share/man/man4/zstty.4    Thu May 01 23:25:52 2003 +0000
+++ b/share/man/man4/zstty.4    Fri May 02 00:42:40 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: zstty.4,v 1.5 2003/03/31 03:44:32 perry Exp $
+.\"    $NetBSD: zstty.4,v 1.6 2003/05/02 00:42:40 fair Exp $
 .\"
 .\" Copyright (c) 1997 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -34,20 +34,113 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd October 23, 1997
+.Dd May 1, 2003
 .Dt ZSTTY 4
 .Os
 .Sh NAME
-.Nm zstty
+.Nm zstty ,
+.Nm zsc ,
+.Nm zs
 .Nd
-serial communications interface
+.Tn Zilog 8530 serial communications interface
 .Sh SYNOPSIS
-.Cd "zstty* at zs0"  Pq sparc
-.Cd "zstty* at zsc1" Pq others
+.Ss alpha
+.Cd "zsc0      at ioasic? offset 0x100000"
+.Cd "zsc1      at ioasic? offset 0x180000"
+.Cd "zstty*    at zsc? channel ?       # serial ports on B channels"
+.Cd "lkkbd0    at zsc1 channel ?       # keyboard port on A channels"
+.Cd "vsms0     at zsc0 channel ?       # mouse port on A channels"
+.Ss cesfic
+.Cd "zsc*      at mainbus0"
+.Cd "zstty*    at zsc? channel ?"
+.Ss mac68k and macppc
+.Cd "zsc0      at obio?"
+.Cd "zstty*    at zsc? channel ?"
+.Ss mipsco
+.Cd "zsc0      at obio0 addr 0xbb000000"
+.Cd "zstty0    at zsc0 channel 0"
+.Cd "zstty1    at zsc0 channel 1"
+.Ss mvme68k
+.Cd "zsc*      at pcc? ipl 4"
+.Cd "zsc*      at pcctwo? ipl 4"
+.Cd "zstty*    at zsc? channel ?"
+.Ss news68k
+.Cd "zsc0      at hb0 addr 0xe0d40000 ipl 5 vect 64 flags 0x0  # news1700"
+.Cd "zsc0      at hb1 addr 0xe1780000 ipl 5 vect 64 flags 0x1  # news1200"
+.Cd "zstty0    at zsc0 channel 0"
+.Cd "zstty1    at zsc0 channel 1"
+.Ss newsmips
+.Cd "zsc0      at hb0 addr 0xbfec0000 level 1 flags 0x0        # on-board"
+.Cd "zsc1      at hb0 addr 0xb8c40100 level 1 flags 0x1        # expansion board"
+.Cd "zsc2      at hb0 addr 0xb8c40104 level 1 flags 0x1"
+.Cd "zsc0      at ap?"
+.Cd "zstty0    at zsc0 channel 0"
+.Cd "zstty1    at zsc0 channel 1"
+.Cd "zstty2    at zsc1 channel 0"
+.Cd "zstty3    at zsc1 channel 1"
+.Cd "zstty4    at zsc2 channel 0"
+.Cd "zstty5    at zsc2 channel 1"
+.Ss next68k
+.Cd "zsc0      at intio? ipl 5"
+.Cd "#zsc1     at intio? ipl 5"
+.Cd "zstty0    at zsc0 channel 0       # ttya"
+.Cd "zstty1    at zsc0 channel 1       # ttyb"
+.Ss sgimips
+.Cd "zsc*      at hpc0 offset ?"
+.Cd "zstty*    at zsc? channel ?"
+.Ss sparc
+.Cd "zs0       at mainbus0                             # sun4c"
+.Cd "zs0       at obio0                                # sun4m"
+.Cd "zs0       at obio0 addr 0xf1000000 level 12       # sun4/200 and sun4/300"
+.Cd "zs0       at obio0 addr 0x01000000 level 12       # sun4/100"
+.Cd "zstty0    at zs0 channel 0                        # ttya"
+.Cd "zstty1    at zs0 channel 1                        # ttyb"
+.Cd "zs1       at mainbus0                             # sun4c"
+.Cd "zs1       at obio0                                # sun4m"
+.Cd "zs1       at obio0 addr 0xf0000000 level 12       # sun4/200 and sun4/300"
+.Cd "zs1       at obio0 addr 0x00000000 level 12       # sun4/100"
+.Cd "kbd0      at zs1 channel 0                        # keyboard"
+.Cd "ms0       at zs1 channel 1                        # mouse"
+.Cd "zs2       at obio0 addr 0xe0000000 level 12       # sun4/300"
+.Cd "zstty2    at zs2 channel 0                        # ttyc"
+.Cd "zstty3    at zs2 channel 1                        # ttyd"
+.Ss sun2
+.Cd "zs0       at obio0 addr 0x002000  # 2/120, 2/170"
+.Cd "zs1       at obmem0 addr 0x780000 # 2/120, 2/170"
+.Cd "zs0       at obio0 addr 0x7f2000  # 2/50"
+.Cd "zs1       at obio0 addr 0x7f1800  # 2/50"
+.Cd "zs2       at mbmem0 addr 0x080800 # 2/120, 2/170 (first sc SCSI)"
+.Cd "zs3       at mbmem0 addr 0x081000 # 2/120, 2/170 (first sc SCSI)"
+.Cd "zs4       at mbmem0 addr 0x084800 # 2/120, 2/170 (second sc SCSI)"
+.Cd "zs5       at mbmem0 addr 0x085000 # 2/120, 2/170 (second sc SCSI)"
+.Cd "zstty*    at zs? channel ?        # ttya"
+.Cd "kbd0      at zstty?               # keyboard"
+.Cd "ms0       at zstty?               # mouse"
+.Ss sun3
+.Cd "zstty0    at zsc1 channel 0       # ttya"
+.Cd "zstty1    at zsc1 channel 1       # ttyb"
+.Cd "kbd0      at zsc0 channel 0       # keyboard"
+.Cd "ms0       at zsc0 channel 1       # mouse"
+.Ss x68k
+.Cd "zsc0      at intio0 addr 0xe98000 intr 112"
+.Cd "zstty0    at zsc0 channel 0               # built-in RS-232C"
+.Cd "ms0       at zsc0 channel 1               # standard mouse"
+.Cd "#zsc1     at intio0 addr 0xeafc00 intr 113"
+.Cd "#zstty2   at zsc1 channel 0"
+.Cd "#zstty3   at zsc1 channel 1"
+.Cd "#zsc2     at intio0 addr 0xeafc10 intr 114"
+.Cd "#zstty4   at zsc2 channel 0"
+.Cd "#zstty5   at zsc2 channel 1"
 .Sh DESCRIPTION
 The
 .Nm
-driver provides TTY support for Zilog 8530 Dual UARTs.
+driver provides
+.Tn TTY
+support for
+.Tn Zilog
+8530 Dual
+.Tn UART
+chips.
 .Pp
 Input and output for each line may set to any baud rate in the
 range 50 to 38400 (and higher on some machines).
@@ -57,7 +150,7 @@
 .It Pa /dev/ttyb
 .El
 .Sh DIAGNOSTICS
-.Bl -tag -width indent -compact
+.Bl -tag -width indent
 .It zs0*: fifo overflow
 .br
 The on-chip
@@ -69,11 +162,14 @@
 .It zs0*: ring overflow
 .br
 The software input
-.Dq ring
-has overflowed.  This usually means input flow-control
-is not configured correctly (i.e. incorrect cable wiring).
+.Qq ring
+has overflowed.
+This usually means input flow-control is not configured correctly
+.Pq i.e. incorrect cable wiring .
 .El
 .Sh SEE ALSO
+.Xr kbd 4 ,
+.Xr ms 4 ,
 .Xr scc 4 ,
 .Xr tty 4
 .Sh HISTORY
@@ -83,10 +179,12 @@
 .Nm sparc
 .Nm zs
 driver supplied with
-.Bx 4.4 .
-.Ud
+.Bx 4.4
+.Ux .
 .Sh BUGS
-The old Zilog 8530 chip has a very small fifo (3 bytes?) and
+The old
+.Tn Zilog
+8530 chip has a very small fifo (3 bytes?) and
 therefore has very strict latency requirements for the
 interrupt service routine.
 This limits the usable baud rates on many machines.