New keyboard man pages; from NetBSD.

3 files changed, 172 insertions, 6 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 65d23545aa1..bfca7b216d1 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.135 2000/11/15 21:03:00 aaron Exp $
+#	$OpenBSD: Makefile,v 1.136 2000/11/15 21:20:52 aaron Exp $
 
 MAN=	aac.4 ac97.4 adv.4 aha.4 ahb.4 ahc.4 aic.4 amphy.4 an.4 aria.4 ast.4 \
 	atalk.4 atapiscsi.4 audio.4 aue.4 auvia.4 awi.4 bpf.4 bridge.4 \
@@ -9,11 +9,11 @@ MAN=	aac.4 ac97.4 adv.4 aha.4 ahb.4 ahc.4 aic.4 amphy.4 an.4 aria.4 ast.4 \
 	inet.4 inphy.4 iophy.4 ip.4 ipl.4 ipsec.4 isa.4 isapnp.4 iso.4 isp.4 \
 	ksyms.4 kue.4 lkm.4 lmc.4 lo.4 lxtphy.4 midi.4 mii.4 mtdphy.4 \
 	mtio.4 ncr.4 ne.4 neo.4 netintro.4 ns.4 nsip.4 nsphy.4 nsphyter.4 \
-	null.4 ohci.4 opl.4 options.4 pchb.4 pci.4 pciide.4 pcmcia.4 pty.4 \
-	puc.4 qsphy.4 raid.4 random.4 ray.4 rl.4 rln.4 rlphy.4 route.4 scsi.4 \
-	sd.4 ses.4 sf.4 sis.4 sk.4 sl.4 sm.4 spp.4 sppp.4 sqphy.4 ss.4 st.4 \
-	ste.4 sv.4 tb.4 tcic.4 tcp.4 termios.4 ti.4 tl.4 tlphy.4 tp.4 tqphy.4 \
-	tty.4 tun.4 twe.4 tx.4 txphy.4 \
+	null.4 ohci.4 opl.4 options.4 pchb.4 pckbc.4 pckbd.4 pci.4 pciide.4 \
+	pcmcia.4 pty.4 puc.4 qsphy.4 raid.4 random.4 ray.4 rl.4 rln.4 \
+	rlphy.4 route.4 scsi.4 sd.4 ses.4 sf.4 sis.4 sk.4 sl.4 sm.4 spp.4 \
+	sppp.4 sqphy.4 ss.4 st.4 ste.4 sv.4 tb.4 tcic.4 tcp.4 termios.4 ti.4 \
+	tl.4 tlphy.4 tp.4 tqphy.4 tty.4 tun.4 twe.4 tx.4 txphy.4 \
 	uaudio.4 ubsec.4 ucom.4 udp.4 ugen.4 uhci.4 uhid.4 \
 	uk.4 ukbd.4 ukphy.4 ulpt.4 umodem.4 ums.4 umass.4 unix.4 urio.4 usb.4 \
 	uvisor.4 vga.4 vlan.4 vnd.4 vr.4 \
diff --git a/share/man/man4/pckbc.4 b/share/man/man4/pckbc.4
new file mode 100644
index 00000000000..66931801a53
--- /dev/null
+++ b/share/man/man4/pckbc.4
@@ -0,0 +1,39 @@
+.\" $OpenBSD: pckbc.4,v 1.1 2000/11/15 21:20:52 aaron Exp $
+.\" $NetBSD: pckbc.4,v 1.2 2000/06/16 06:42:31 augustss Exp $
+.Dd April 21, 1999
+.Os
+.Dt PCKBC 4
+.Sh NAME
+.Nm pckbc
+.Nd PC (ISA) keyboard controller driver
+.Sh SYNOPSIS
+.Cd "pckbc* at isa?"
+.Cd "pckbc* at pnpbios? index ?"
+.Cd "pckbd* at pckbc? slot ?"
+.Cd "pms*   at pckbc? slot ?"
+.Cd "pmsi*  at pckbc? slot ?"
+.Cd "opms*  at pckbc? slot ?"
+.Sh DESCRIPTION
+The
+.Nm
+driver handles ressource allocation and device attachment for the
+traditional PC/AT keyboard controller.
+It provides two logical connections for child devices, the
+.Dq keyboard
+slot for a keyboard and the
+.Dq auxillary
+slot for mice (the latter might be missing in older keyboard controllers).
+.Pp
+The optional
+.Dq slot
+locator argument can be used to force unusual connections of devices to
+logical slots.
+This feature is for experimentation only, it will not be
+useful in normal operation.
+.Sh SEE ALSO
+.Xr isa 4 ,
+.Xr pckbd 4
+.\" .Xr pms 4 ,
+.\" .Xr pmsi 4 ,
+.\" .Xr pnpbios 4 ,
+.\" .Xr opms 4 .
diff --git a/share/man/man4/pckbd.4 b/share/man/man4/pckbd.4
new file mode 100644
index 00000000000..795ac504042
--- /dev/null
+++ b/share/man/man4/pckbd.4
@@ -0,0 +1,127 @@
+.\" $OpenBSD: pckbd.4,v 1.1 2000/11/15 21:20:52 aaron Exp $
+.\" $NetBSD: pckbd.4,v 1.3 1999/12/21 11:31:07 drochner Exp $
+.Dd March 20, 1999
+.Os
+.Dt PCKBD 4
+.Sh NAME
+.Nm pckbd
+.Nd PC keyboard driver for wscons
+.Sh SYNOPSIS
+.Cd pckbc* at isa?
+.Cd pckbd* at pckbc?
+.Cd wskbd* at pckbd? console ?
+.Cd option PCKBD_LAYOUT=XXX
+.Sh DESCRIPTION
+This driver supports PC/AT keyboards within the
+.Xr wscons 4
+console framework.
+It doesn't provide direct device driver entry points but makes its
+functions available via the internal
+.Xr wskbd 4
+interface.
+.Pp
+The
+.Nm
+driver supports a number of different key mappings which
+can be chosen from with the kernel option
+.Dq PCKBD_LAYOUT
+at compile time or with the utility
+.Xr wsconsctl 8
+(variable:
+.Dq encoding
+) at runtime.
+Other mappings can be used if the whole keymap is replaced by means of
+.Xr wsconsctl 8 .
+The built-in mappings are at this time:
+.Bl -hang
+.It KB_US
+(for wsconsctl:
+.Dq us
+) English / US keyboard mapping (default).
+.It KB_DE
+(
+.Dq de
+) German with
+.Dq dead accents .
+.It KB_FR
+(
+.Dq fr
+) French.
+.It KB_DK
+(
+.Dq dk
+) Danish with
+.Dq dead accents .
+.It KB_IT
+(
+.Dq it
+) Italian.
+.It KB_UK
+(
+.Dq uk
+) British.
+.It KB_JP
+(
+.Dq jp
+) Japanese.
+.It KB_SV
+(
+.Dq sv
+) Swedish with
+.Dq dead accents .
+.It KB_US | KB_DECLK
+(
+.Dq us.declk
+) English / US mapping for
+.Tn DEC
+LK400-style keyboards with PC keyboard interface (eg LK461).
+.It KB_US | KB_DVORAK
+(
+.Dq us.dvorak
+) English / US keyboard with
+.Dq Dvorak
+layout.
+.El
+.Pp
+The KB_DE, KB_DK and KB_SV mappings can be used in the KB_NODEAD (
+.Dq .nodead
+) variant.
+This switches off the
+.Dq dead accents .
+.Pp
+The KB_US, KB_JP and KB_US | KB_DVORAK mappings can be modified
+to swap the left CNTL	and the CAPS LOCK keys by the
+KB_SWAPCTRLCAPS variant bit or the
+.Dq .swapctrlcaps
+suffix.
+.Pp
+The KB_METAESC (
+.Dq .metaesc
+) option can be applied to any layout.
+If set, keys pressed together
+with the ALT modifier are prefixed by an ESC character.
+(Standard behaviour is to add 128 to the ASCII value.)
+.Pp
+Because PC keyboard hardware doesn't contain a beeper, requests for
+.Dq keyboard beeps
+cannot be handled directly.
+On alpha and i386 a helper device attached to the
+.Xr pcppi 4
+driver allows to use the standard ISA speaker for this purpose.
+.Sh EXAMPLES
+To set a german keyboard layout without
+.Dq dead accents
+and sending an ESC character before the key symbol if the ALT
+key is pressed simultanously, use
+.Ic wsconsctl -w encoding=de.nodead.metaesc .
+To set it at kernel build time, add
+.Em option PCKBD_LAYOUT="(KB_DE|KB_NODEAD|KB_METAESC)"
+to the kernel configuration file.
+.Sh SEE ALSO
+.Xr isa 4 ,
+.Xr pcppi 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.