[src/trunk]: src/share/man/man4 update: new maps and options, sort differentl...

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

details:   https://anonhg.NetBSD.org/src/rev/b21cbf4f3526
branches:  trunk
changeset: 479788:b21cbf4f3526
user:      drochner <drochner%NetBSD.org@localhost>
date:      Tue Dec 21 11:31:07 1999 +0000

description:
update: new maps and options, sort differently to avoid duplication,
add example for map setting

diffstat:

 share/man/man4/pckbd.4 |  63 +++++++++++++++++++++++++++++--------------------
 1 files changed, 37 insertions(+), 26 deletions(-)

diffs (106 lines):

diff -r f34f63a5842b -r b21cbf4f3526 share/man/man4/pckbd.4
--- a/share/man/man4/pckbd.4    Tue Dec 21 11:29:21 1999 +0000
+++ b/share/man/man4/pckbd.4    Tue Dec 21 11:31:07 1999 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pckbd.4,v 1.2 1999/04/21 18:42:04 drochner Exp $
+.\" $NetBSD: pckbd.4,v 1.3 1999/12/21 11:31:07 drochner Exp $
 .Dd March 20, 1999
 .Os
 .Dt PCKBD 4
@@ -42,11 +42,6 @@
 .Dq de
 ) German with
 .Dq dead accents .
-.It KB_DE | KB_NODEAD
-(
-.Dq de.nodead
-) German without
-.Dq dead accents .
 .It KB_FR
 (
 .Dq fr
@@ -56,11 +51,6 @@
 .Dq dk
 ) Danish with
 .Dq dead accents .
-.It KB_DK | KB_NODEAD
-(
-.Dq dk.nodead
-) Danish without
-.Dq dead accents .
 .It KB_IT
 (
 .Dq it
@@ -73,36 +63,57 @@
 (
 .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_SWAPCTRLCAPS
+.It KB_US | KB_DVORAK
 (
-.Dq us.swapctrlcaps
-) English / US mapping with swapped
-.Dq Control
-and
-.Dq Caps Lock
-keys.
-.It KB_JP | KB_SWAPCTRLCAPS
-(
-.Dq jp.swapctrlcaps
-) Japanese mapping with swapped
-.Dq Control
-and
-.Dq Caps Lock
-keys.
+.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
+.Cd options PCKBD_LAYOUT="(KB_DE | KB_NODEAD | KB_METAESC)"
+to the kernel configuration file.
 .Sh BUGS
 The list of builtin mappings doesn't follow any logics.
 It grew as people submitted what they needed.