Manual pages for the new hil(4) and hilkbd(4) drivers.

4 files changed, 150 insertions, 4 deletions

diff --git a/share/man/man4/hil.4 b/share/man/man4/hil.4
new file mode 100644
index 00000000000..a20da944bf1
--- /dev/null
+++ b/share/man/man4/hil.4
@@ -0,0 +1,54 @@
+.\"	$OpenBSD: hil.4,v 1.1 2003/02/11 20:10:33 miod Exp $
+.\"
+.\" Copyright (c) 2003 Miodrag Vallat.
+.\" 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. Redistribution 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 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.
+.\"
+.\"
+.Dd February 11, 2003
+.Dt HIL 4
+.Os
+.Sh NAME
+.Nm hil
+.Nd HP-HIL loop driver
+.Sh SYNOPSIS
+.Cd "hil* at gsc? irq 1"
+.Cd "hilkbd* at hil?"
+.\" .Cd "hilms* at hil?"
+.\" .Cd "hilid* at hil?"
+.Sh DESCRIPTION
+The
+.Nm
+interface provides access to the
+.Dq Human Interface Loop
+controller found on many
+.Tn HP
+workstations.
+.Pp
+It provides generic HIL loop management and interfaces for child devices,
+such as keyboards, button boxes, mice, graphics tablet, and ID modules.
+.Sh SEE ALSO
+.Xr gsc 4 ,
+.\" .Xr hilid 4 ,
+.Xr hilkbd 4 ,
+.\" .Xr hilms 4 ,
+.Xr intro 4
diff --git a/share/man/man4/hilkbd.4 b/share/man/man4/hilkbd.4
new file mode 100644
index 00000000000..efce2cfcbdf
--- /dev/null
+++ b/share/man/man4/hilkbd.4
@@ -0,0 +1,89 @@
+.\"	$OpenBSD: hilkbd.4,v 1.1 2003/02/11 20:10:33 miod Exp $
+.\"
+.\" Copyright (c) 2003 Miodrag Vallat.
+.\" 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. Redistribution 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 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.
+.\"
+.\"
+.Dd February 11, 2003
+.Dt HILKBD 4
+.Os
+.Sh NAME
+.Nm hilkbd
+.Nd HIL keyboard driver
+.Sh SYNOPSIS
+.Cd "hilkbd* at hil?"
+.Cd "wskbd* at hilkbd? console ?"
+.Cd "option HILKBD_LAYOUT=XXX"
+.Sh DESCRIPTION
+This driver supports HIL keyboards within the
+.Xr wscons 4
+framework.
+It doesn't prowide direct device driver entry points, but makes its
+functions available through the internal
+.Xr wskbd 4
+interface.
+.Pp
+The
+.Nm
+driver supports a number of different key mappings.
+By default, the layout corresponding to the keyboard model as probed
+by the
+.Nm
+driver will be used.
+A different layout can be chosen either with the kernel option
+.Dq HILKBD_LAYOUT
+at compile time, or with the
+.Xr wsconsctl 8
+utility (variable:
+.Dq keyboard.encoding
+) at runtime.
+.Pp
+The supported key mappings are at this time:
+.Bl -hang
+.It KB_SV
+(
+.Dq sv
+) Swedish.
+.It KB_UK
+(
+.Dq uk
+) British.
+.It KB_US
+(
+.Dq us
+) English / US keyboard mapping.
+.El
+.Sh EXAMPLES
+To set a swedish keyboard mapping, use
+.Ic wsconsctl -w keyboard.encoding=sv .
+To set it at kernel build time, regardless of what keyboard is plugged, add
+.Em option HILKBD_LAYOUT="KB_SV"
+to the kernel configuration file.
+.Sh SEE ALSO
+.Xr hil 4 ,
+.Xr intro 4 ,
+.Xr wskbd 4 ,
+.Xr wsconsctl 8
+.Sh BUGS
+The list of built-in mappings doesn't follow any logics.
+It grew as people submitted what they needed.
diff --git a/share/man/man4/man4.hppa/Makefile b/share/man/man4/man4.hppa/Makefile
index a7a2cc8f09e..6ebfb631d55 100644
--- a/share/man/man4/man4.hppa/Makefile
+++ b/share/man/man4/man4.hppa/Makefile
@@ -1,8 +1,8 @@
-#	$OpenBSD: Makefile,v 1.10 2003/02/01 03:51:24 deraadt Exp $
+#	$OpenBSD: Makefile,v 1.11 2003/02/11 20:10:34 miod Exp $
 
 MAN=	asp.4 cpu.4tbl gsc.4 gsckbc.4 gsckbd.4 harmony.4 ie.4 
 MAN+=	intro.4tbl io.4tbl lasi.4 phantomas.4
-# mongoose.4 hil.4 aone.4 wax.4 dino.4 tir.4 xbar.4 mcx.4
+# mongoose.4 aone.4 wax.4 dino.4 tir.4 xbar.4 mcx.4
 MANSUBDIR=hppa
 
 .include <bsd.prog.mk>
diff --git a/share/man/man4/wskbd.4 b/share/man/man4/wskbd.4
index 055a433dd0c..9a2b45d618e 100644
--- a/share/man/man4/wskbd.4
+++ b/share/man/man4/wskbd.4
@@ -1,7 +1,7 @@
-.\" $OpenBSD: wskbd.4,v 1.7 2002/09/26 22:09:53 miod Exp $
+.\" $OpenBSD: wskbd.4,v 1.8 2003/02/11 20:10:33 miod Exp $
 .\" $NetBSD: wskbd.4,v 1.5 2000/03/20 11:51:59 pk Exp $
 .\"
-.Dd March 20, 1999
+.Dd February 11, 2003
 .Dt WSKBD 4
 .Os
 .Sh NAME
@@ -17,6 +17,8 @@
 .Cd wskbd* at comkbd? console ? mux 1
 .Cd wskbd* at zskbd? console ? mux 1
 (Sun serial keyboard)
+.Cd wskbd* at hilkbd? console ? mux 1
+(HIL keyboard)
 .Sh DESCRIPTION
 The
 .Nm
@@ -116,6 +118,7 @@ driver supports it.
 .Sh SEE ALSO
 .Xr akbd 4 ,
 .Xr comkbd 4 ,
+.Xr hilkbd 4 ,
 .Xr intro 4 ,
 .Xr wscons 4 ,
 .Xr wsmux 4 ,