Cleanup/addition of manpages for macppc.

Some of these changes from Peter Philipp.
ok millert.
zs was cleaned up based on comments.

7 files changed, 270 insertions, 19 deletions

diff --git a/share/man/man4/man4.macppc/Makefile b/share/man/man4/man4.macppc/Makefile
index 9099eafdd05..dbc0d0348b0 100644
--- a/share/man/man4/man4.macppc/Makefile
+++ b/share/man/man4/man4.macppc/Makefile
@@ -1,8 +1,10 @@
-#	$OpenBSD: Makefile,v 1.2 2001/09/30 05:20:52 drahn Exp $
+#	$OpenBSD: Makefile,v 1.3 2001/10/03 04:32:37 drahn Exp $
 #	from: @(#)Makefile	5.1 (Berkeley) 2/12/91
 #	Id: Makefile,v 1.4 1995/12/14 05:41:38 deraadt Exp $
 
-MAN= abtn.4 adb.4 aed.4 ams.4 autoconf.4 bm.4 gm.4 intro.4 mem.4
+MAN= abtn.4 adb.4 aed.4 akbd.4 ams.4 autoconf.4 awacs.4 bm.4 gm.4 intro.4 mem.4
+MAN+=zs.4
+MLINKS= zs.4 zsc.4 zs.4 zstty.4
 
 MANSUBDIR=macppc
 
diff --git a/share/man/man4/man4.macppc/abtn.4 b/share/man/man4/man4.macppc/abtn.4
index 045ed196376..b7f496a7613 100644
--- a/share/man/man4/man4.macppc/abtn.4
+++ b/share/man/man4/man4.macppc/abtn.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: abtn.4,v 1.2 2001/09/02 19:36:55 miod Exp $
+.\" $OpenBSD: abtn.4,v 1.3 2001/10/03 04:32:37 drahn Exp $
 .\"
 .\" Copyright (c) 2001 Peter Philipp
 .\" All rights reserved.
@@ -41,10 +41,12 @@ driver allows you to dim the brightness of your display.  This driver only
 currently recognizes the dim and brightness button.  Sound, numlock and
 eject buttons are also handled by this driver but are silently ignored.
 .Sh SEE ALSO
-.Xr adb 4, 
+.Xr adb 4 ,
 .Xr aed 4
 .Sh AUTHOR
-abtn was written by Tsubai Masanari for
+The
+.Nm
+driver was written by Tsubai Masanari for
 .Nx .
 .Sh BUGS
 The bright/dim buttons currently don't work on new 2001 iBooks.  It's best
diff --git a/share/man/man4/man4.macppc/adb.4 b/share/man/man4/man4.macppc/adb.4
index 0b871b01ca8..7c05e8e69ac 100644
--- a/share/man/man4/man4.macppc/adb.4
+++ b/share/man/man4/man4.macppc/adb.4
@@ -1,6 +1,7 @@
-.\" $OpenBSD: adb.4,v 1.2 2001/09/02 19:36:55 miod Exp $
+.\" $OpenBSD: adb.4,v 1.3 2001/10/03 04:32:37 drahn Exp $
 .\"
 .\" Copyright (c) 2001 Peter Philipp
+.\" Copyright (c) 1997 Colin Wood
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -11,7 +12,11 @@
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
-.\" 3. The name of the author may not be used to endorse or promote products
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"      This product includes software developed by Colin Wood
+.\"      for the NetBSD Project.
+.\" 4. The name of the author may not be used to endorse or promote products
 .\"    derived from this software without specific prior written permission
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
@@ -28,21 +33,58 @@
 .Dd July 30, 2001
 .Dt ADB 4 macppc
 .Os 
-
 .Sh NAME
 .Nm adb
 .Nd Apple Desktop Bus driver
 .Sh SYNOPSIS
 .Cd "adb at macobio?"
 .Sh DESCRIPTION
-The Apple Desktop Bus driver handles I/O devices such as ADB Keyboard, pointing
-devices such as trackball or mouse, and special function buttons.
+The Apple Desktop Bus
+.Pq Tn ADB
+is the single-master, multiple-slave, low-speed serial bus
+interface used by Macintosh computers to connect input devices
+such as keyboards, mice, trackballs, and graphics tablets
+to the machine.
+.Pp
+Originally developed for the Mac68K port, the 
+.Nm
+driver was heavily modified when it was ported to the PowerPC architecture.  
+During this port it seems that the original 
+.Nm
+event device was split into many smaller subsystems, namely:
+.Pp
+.Bl -enum -compact
+.It
+Apple Event Device driver
+.Xr aed 4 .
+.It
+Apple Keyboard driver
+.Xr akbd 4 .
+.It 
+Apple Mouse Support driver
+.Xr ams 4 .
+.El
+.Pp
+New
+.Nm
+devices such as the Apple Brightness / Volume Control Button
+.Xr abtn 4 
+were added to the PowerPC port later to complement the ADB system.
 .Sh SEE ALSO
-.Xr abtn 4,
-.Xr aed 4,
-.Xr ams 4
+.Xr abtn 4 ,
+.Xr aed 4 ,
+.Xr akbd 4 ,
+.Xr ams 4 
+.Sh HISTORY
+The
+.Nm
+interface first appeared in
+.Nx 0.9 .
+It has been under development ever since.  The original
+.Xr adb 4
+manpage was written by Colin Wood for 
+.Nx 
+/ Mac68K.
 .Sh AUTHORS
-The direct ADB routines were written by
-.Sy John P. Wittkoski.
-The autoconf and attach routines seem to be written by 
-.Sy Bradley A. Grantham.
+Original ADB support was written by Bradley A. Grantham.
+The direct ADB routines were written by John P. Wittkoski.
diff --git a/share/man/man4/man4.macppc/akbd.4 b/share/man/man4/man4.macppc/akbd.4
new file mode 100644
index 00000000000..47c5977c01d
--- /dev/null
+++ b/share/man/man4/man4.macppc/akbd.4
@@ -0,0 +1,74 @@
+.\"
+.\" Copyright (c) 2001 Peter Philipp
+.\" Copyright (c) 1997 Colin Wood
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"      This product includes software developed by Colin Wood
+.\"      for the NetBSD Project.
+.\" 4. The name of the author may not be used to endorse or promote products
+.\"    derived from this software without specific prior written permission
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.\"	$OpenBSD: akbd.4,v 1.1 2001/10/03 04:32:37 drahn Exp $
+.\"	$NetBSD: adb.4,v 1.1 1997/07/18 02:13:42 ender Exp $
+.\"
+.Dd July 17, 1997
+.Dt AKBD 4 macppc
+.Os
+.Sh NAME
+.Nm akbd
+.Nd Apple Keyboard Device
+.Sh SYNOPSIS
+.Cd "akbd* at adb?"
+.Sh DESCRIPTION
+The following is a partial list of supported
+.Tn AKBD
+devices:
+.Bd -filled -offset indent
+.Bl -item -compact
+.It
+Apple Standard Keyboard
+.It
+Apple Extended Keyboard
+.It
+Apple Adjustable Keyboard
+.It
+Apple PowerBook Keyboard
+.It
+Apple iBook Keyboard
+.It
+.El
+.Ed
+.Sh HISTORY
+The
+.Nm
+interface first appeared in
+.Nx 0.9 .
+It has been under development ever since.
+.Sh AUTHORS
+Bradley A. Grantham wrote the original
+.Nm
+driver, including the
+.Tn MRG
+support.
+The hardware direct interface was written by John P. Wittkowski.
diff --git a/share/man/man4/man4.macppc/awacs.4 b/share/man/man4/man4.macppc/awacs.4
new file mode 100644
index 00000000000..7fe19db947c
--- /dev/null
+++ b/share/man/man4/man4.macppc/awacs.4
@@ -0,0 +1,64 @@
+.\" $OpenBSD: awacs.4,v 1.1 2001/10/03 04:32:37 drahn Exp $
+.\" $NetBSD: awacs.4,v 1.2 2001/05/09 22:16:12 he Exp $
+.\"
+.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"        This product includes software developed by the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd May 9, 2001
+.Dt AWACS 4 macppc
+.Os
+.Sh NAME
+.Nm awacs
+.Nd Apple audio device driver
+.Sh SYNOPSIS
+.Cd "awacs* at obio?"
+.Cd "audio* at awacs?"
+.Sh DESCRIPTION
+The
+.Nm
+(audio waveform amplifier and converter for sound)
+driver provides support for the audio hardware found in many Apple
+PowerMacs.
+.Sh BUGS
+This driver needs more testing.
+.Pp
+This manual page needs more precision and detail.
+.Sh AUTHORS
+The
+.Nm
+driver was written by Tsubai Masanari.
+.Sh SEE ALSO
+.Xr audio 4
+.Sh HISTORY
+The
+.Nm
+device driver appeared in
+.Nx 1.5.1 .
diff --git a/share/man/man4/man4.macppc/gm.4 b/share/man/man4/man4.macppc/gm.4
index 0363126b968..2136bf97f62 100644
--- a/share/man/man4/man4.macppc/gm.4
+++ b/share/man/man4/man4.macppc/gm.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: gm.4,v 1.2 2001/09/02 19:36:55 miod Exp $
+.\" $OpenBSD: gm.4,v 1.3 2001/10/03 04:32:37 drahn Exp $
 .\"
 .\" Copyright (c) 2001 Peter Philipp
 .\" All rights reserved.
@@ -30,7 +30,7 @@
 .Os 
 .Sh NAME
 .Nm gm
-.Nd apple GMAC ethernet
+.Nd Apple GMAC ethernet
 .Sh SYNOPSIS
 .Cd "gm* at pci? dev ? function ?"
 .Sh DESCRIPTION
diff --git a/share/man/man4/man4.macppc/zs.4 b/share/man/man4/man4.macppc/zs.4
new file mode 100644
index 00000000000..3349dea76a8
--- /dev/null
+++ b/share/man/man4/man4.macppc/zs.4
@@ -0,0 +1,67 @@
+.\"	$OpenBSD: zs.4,v 1.1 2001/10/03 04:32:37 drahn Exp $
+.\"
+.\" Copyright (c) 1998 The OpenBSD Project
+.\" All rights reserved.
+.\"
+.\"
+.Dd Oct 1, 2001
+.Dt ZS 4 macppc
+.Os
+.Sh NAME
+.Nm zs
+.Nd Zilog 8530 (ZSCC) serial communications driver
+.Sh SYNOPSIS
+.Cd "zsc0 at macobio0 irq X,Y"
+.Cd "zstty0 at zsc0 channel 0"
+.Cd "zstty1 at zsc0 channel 1"
+.Sh DESCRIPTION
+The
+.Nm
+is a Zilog 8530 serial interface chip used in Sun workstations and
+Apple Macintosh systems.
+Most newer Macintosh systems the first port
+tty00
+is connected to the internal modem.
+The second port is either not connected, or may be connected to
+a IRDA device (untested).
+It is possible to replace the internal modem on some system with
+a real serial port using third party hardware adapters.
+.Pp
+The
+.Nm
+driver supports all of the standard
+.Xr tty 4
+ioctl calls.
+The status of the DTR, RTS, CTS, and DCD signals can be queried with
+TIOCMGET command, but, due to limitations in the hardware,
+only the DTR and RTS signals can be modified with TIOCMSET, TIOCMBIC,
+and TIOCMBIS
+.Xr ioctl 2
+commands.
+.Sh BUGS
+The
+.Nm
+driver now supports cua minor devices, but with this known deficiency
+in the simultaneous outgoing/incoming aspect of the driver:
+The first outgoing connection succeeds, but second and subsequent
+connections fail, apparently due to a getty hang. The hung getty apparently
+prevents the cua device from being re-opened.
+.Sh FILES
+.Bl -tag -width Pa -compact
+.It Pa /dev/tty00
+.It Pa /dev/tty01
+.It Pa /dev/cua00
+.It Pa /dev/cua01
+.El
+.Sh SEE ALSO
+.Xr ioctl 2 ,
+.Xr tty 4
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Bx 4.4 .
+Support for the TIOCM*
+.Xr ioctl 2 Ns s
+appeared in
+.Ox 2.3 .