[src/trunk]: src/share/man/man4/man4.amiga Add man pages for the new clockpor...

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

details:   https://anonhg.NetBSD.org/src/rev/b448730260bd
branches:  trunk
changeset: 778857:b448730260bd
user:      rkujawa <rkujawa%NetBSD.org@localhost>
date:      Tue Apr 17 10:12:35 2012 +0000

description:
Add man pages for the new clockport(4) and a1k2cp(4).

diffstat:

 share/man/man4/man4.amiga/Makefile    |   6 +-
 share/man/man4/man4.amiga/a1k2cp.4    |  73 +++++++++++++++++++++++++++++++++++
 share/man/man4/man4.amiga/clockport.4 |  67 ++++++++++++++++++++++++++++++++
 3 files changed, 143 insertions(+), 3 deletions(-)

diffs (163 lines):

diff -r b1bf5305392c -r b448730260bd share/man/man4/man4.amiga/Makefile
--- a/share/man/man4/man4.amiga/Makefile        Tue Apr 17 10:08:07 2012 +0000
+++ b/share/man/man4/man4.amiga/Makefile        Tue Apr 17 10:12:35 2012 +0000
@@ -1,8 +1,8 @@
 #      from: @(#)Makefile      8.2 (Berkeley) 2/16/94
-#      $NetBSD: Makefile,v 1.23 2012/01/11 17:25:19 rkujawa Exp $
+#      $NetBSD: Makefile,v 1.24 2012/04/17 10:12:35 rkujawa Exp $
 
-MAN=   afsc.4 ahsc.4 amidisplaycc.4 atzsc.4 autoconf.4 console.4 bah.4 \
-       bppcsc.4 cv3dpb.4 ed.4 efa.4 es.4 fdc.4 grf.4 \
+MAN=   a1k2cp.4 afsc.4 ahsc.4 amidisplaycc.4 atzsc.4 autoconf.4 console.4 \
+       bah.4 bppcsc.4 clockport.4 cv3dpb.4 ed.4 efa.4 es.4 fdc.4 grf.4 \
        grfcl.4 grfcv.4 grfcv3d.4 grfet.4 grfrh.4 grfrt.4 grful.4 \
        gtsc.4 intro.4 ite.4 mem.4 mfcs.4 mgnsc.4 mppb.4 p5membar.4 p5pb.4 \
        qn.4 ser.4 wesc.4 zssc.4
diff -r b1bf5305392c -r b448730260bd share/man/man4/man4.amiga/a1k2cp.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/man4.amiga/a1k2cp.4        Tue Apr 17 10:12:35 2012 +0000
@@ -0,0 +1,73 @@
+.\" $NetBSD: a1k2cp.4,v 1.1 2012/04/17 10:12:35 rkujawa Exp $
+.\"
+.\" Copyright (c) 2012 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Radoslaw Kujawa.
+.\"
+.\" 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.
+.\"
+.\" 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 April 16, 2012
+.Dt A1K2CP 4 amiga
+.Os
+.Sh NAME
+.Nm a1k2cp 
+.Nd Amiga 1200 on-board clockport driver
+.Sh SYNOPSIS
+.Cd "a1k2cp0 at mainbus0"
+.Cd "clockport* at a1k2cp0"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the spare I/O pins present on Amiga 1200 on-board
+clockport.
+.Sh HARDWARE
+The
+.Nm
+driver supports the following clockports:
+.Bl -tag -offset indent
+.It Amiga 1200 on-board clockport header (0xD90001)
+.El
+.Sh SEE ALSO
+.Xr clockport 4
+.Sh HISTORY
+The
+.Nm
+device first appeared in
+.Nx 7.0 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+driver was written by
+.An Radoslaw Kujawa Aq radoslaw.kujawa%gmail.com@localhost .
+.Sh CAVEATS
+Even if connected to clockport header, Real Time Clock modules are
+supported by the
+.Xr a2kbbc
+and
+.Xr a34kbbc 
+drivers.
+.Pp
+Only one clockport is supported, even if clockport expander is present. This is
+a driver limitation.
diff -r b1bf5305392c -r b448730260bd share/man/man4/man4.amiga/clockport.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/man4.amiga/clockport.4     Tue Apr 17 10:12:35 2012 +0000
@@ -0,0 +1,67 @@
+.\" $NetBSD: clockport.4,v 1.1 2012/04/17 10:12:35 rkujawa Exp $
+.\"
+.\" Copyright (c) 2012 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Radoslaw Kujawa.
+.\"
+.\" 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.
+.\"
+.\" 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 April 16, 2012
+.Dt CLOCKPORT 4 amiga
+.Os
+.Sh NAME
+.Nm clockport 
+.Nd introduction to clockport bus support and drivers 
+.Sh SYNOPSIS
+.Cd "clockport* at a1k2cp0"
+.Sh DESCRIPTION
+Clockport is a general purpose non-autoconfiguring expansion bus, originally 
+present on the Amiga 1200, as a part of P9 memory connector. 
+.Sh SUPPORTED DEVICES 
+The
+.Nx
+includes following clockport drivers:
+
+.Bl -tag -offset indent
+.It 
+.Xr com 4
+Individual Computers SilverSurfer 16C550-based serial port.
+.El
+.Sh SEE ALSO
+.Xr a1k2cp 4
+.Sh HISTORY
+The
+.Nm
+subsystem appeared in
+.Nx 7.0 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+subsystem was written by
+.An Radoslaw Kujawa Aq radoslaw.kujawa%gmail.com@localhost .
+.Sh CAVEATS
+Clockport performance is very low, even by Amiga standards.
+.Pp
+Probing the hardware on clockport might be unreliable.