Move description of keyboard layouts to wskbd.4, add newer layouts Previously, the best reference was pckbd.4. This does not make much sense to read if you are on, say, an evbarm device with only USB. wsconsctl.8 contained a vaguer description of supported language names, which isn't very useful because you can't pass full language names to the command. Point readers to wskbd.4 instead. Note in the wskbd.4 page that while all layouts are generally supported by pckbd(4) and ukbd(4), older keyboard interfaces might only support a subset.

(nia)

 @@ -1,14 +1,14 @@
-.\" $NetBSD: wsconsctl.8,v 1.29 2020/07/12 03:37:06 nia Exp $
+.\" $NetBSD: wsconsctl.8,v 1.30 2020/07/13 11:14:12 nia Exp $
 .\"
 .\" Copyright (c) 1998, 2004 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" This code is derived from software contributed to The NetBSD Foundation
 .\" by Juergen Hannken-Illjes.
 .\"
 .\" 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
 @@ -17,27 +17,27 @@
 .\"
 .\" 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 July 12, 2020
+.Dd July 13, 2020
 .Dt WSCONSCTL 8
 .Os
 .Sh NAME
 .Nm wsconsctl
 .Nd get or set wscons state
 .Sh SYNOPSIS
 .Nm
 .Op Fl dkmn
 .Op Fl f Ar file
 .Fl a
 .Nm
 .Op Fl dkmn
 .Op Fl f Ar file
 @@ -104,50 +104,45 @@ can all be found in the
 file.
 .Pp
 The mouse types are defined in the
 .Pa /usr/include/dev/wscons/wsconsio.h
 file.
 .Pp
 The display types, height, width, depth (bits per pixel), color
 map size, and color map are defined in the
 .Pa /usr/include/dev/wscons/wsconsio.h
 file.
 There are also definitions relating to video control and cursor
 control, which are not applicable to all display types, and to text
 emulation and graphics (mapped) modes.
 .Pp
 In addition to British, US, and US-Dvorak keyboard encodings,
 support currently exists for the following languages: Belgian,
 Brazilian, Danish, Finnish, French, German, Greek, Hungarian,
 Italian, Japanese, Norwegian, Polish, Portuguese, Russian, Spanish,
 Swedish, Swiss, Turkish, and Ukrainian.
 Additionally, a user-defined encoding is supported.
 .Sh FILES
 .Bl -tag -width /dev/wsmouse
 .It Pa /dev/wskbd
 keyboard control device
 .It Pa /dev/wsmouse
 mouse control device
 .It Pa /dev/ttyE0
 display control device
 .El
 .Sh EXAMPLES
 The following are just a few examples of
 .Nm
 and its functionality.
 .Pp
 .Dl wsconsctl -w encoding=uk
 .Pp
 Set a UK keyboard encoding.
 For a full list of supported keyboard encodings, see
 .Xr wskbd 4 .
 .Pp
 .Dl wsconsctl -w map+="keysym Caps_Lock = Control_L"
 .Pp
 Modify the current keyboard encoding so that when the
 .Ar Caps Lock
 key is pressed, the same encoding sequence as
 .Ar Left Control
 is sent.
 For a full list of keysyms and keycodes, please refer to the
 .Pa /usr/include/dev/wscons/wsksymdef.h
 file.
 .Pp
 .Dl wsconsctl -w encoding=us.swapctrlcaps
 @@ -191,23 +186,23 @@ Turn off auto repeat.
 If scroll support is enabled in the kernel, set the number of lines
 used in the fast scroll function to 50.
 .Pp
 .Dl wsconsctl -d -w scroll.slowlines=2
 .Pp
 If scroll support is enabled in the kernel, set the number of lines
 used in the slow scroll function to 2.
 In order to use this function, you have to have
 .Dv Cmd_ScrollSlowDown
 and
 .Dv Cmd_ScrollSlowUp
 defined in your keyboard map.
 .Sh SEE ALSO
 .Xr pckbd 4 ,
 .Xr wscons 4 ,
 .Xr wskbd 4 ,
 .Xr wscons.conf 5 ,
 .Xr wsconscfg 8 ,
 .Xr wsfontload 8
 .Sh HISTORY
 The
 .Nm
 command first appeared in
 .Nx 1.4 .

 @@ -1,40 +1,40 @@
-.\" $NetBSD: pckbd.4,v 1.24 2020/07/13 08:59:34 wiz Exp $
+.\" $NetBSD: pckbd.4,v 1.25 2020/07/13 11:14:12 nia Exp $
 .\"
 .\" Copyright (c) 1999
 .\" 	Matthias Drochner.  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.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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 July 12, 2020
+.Dd July 13, 2020
 .Dt PCKBD 4
 .Os
 .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 options PCKBD_LAYOUT=XXX
 .Sh DESCRIPTION
 This driver supports PC/AT keyboards within the
 .Xr wscons 4
 @@ -46,122 +46,38 @@ interface.
 .Pp
 The
 .Nm
 driver supports a number of different key mappings which
 can be chosen from with the kernel option
 .Li 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 builtin mappings are at this time:
 .Bl -column " KB_US|KB_COLEMAK" "wsconsctl" "language"
 .It Sy "option" Ta Sy "wsconsctl" Ta Sy "language"
 .It Li KB_US Ta us Ta English/US keyboard mapping (default)
 .It Li KB_UK Ta uk Ta English/UK keyboard mapping
 .It Li KB_BE Ta be Ta Belgian
 .It Li KB_BR Ta br Ta Brazilian with
 .Dq dead accents
 .It Li KB_CZ Ta cz Ta Czech (QWERTY)
 .It Li KB_DK Ta dk Ta Danish with
 .Dq dead accents
 .It Li KB_NL Ta nl Ta Dutch
 .It Li KB_FI Ta fi Ta Finnish
 .It Li KB_FR Ta fr Ta French
 .It Li KB_DE Ta de Ta German with
 .Dq dead accents
 .It Li KB_GR Ta gr Ta Greek
 .It Li KB_HU Ta hu Ta Hungarian
 .It Li KB_IT Ta it Ta Italian
 .It Li KB_JP Ta jp Ta Japanese
 .It Li KB_NO Ta no Ta Norwegian with
 .Dq dead accents
 .It Li KB_PL Ta pl Ta Polish
 .It Li KB_PT Ta pt Ta Portuguese
 .It Li KB_RU Ta ru Ta Russian
 .It Li KB_ES Ta es Ta Spanish
 .It Li KB_SV Ta sv Ta Swedish with
 .Dq dead accents
 .It Li KB_SF Ta sf Ta Swiss French
 .It Li KB_SG Ta sg Ta Swiss German
 .It Li KB_TR Ta tr Ta Turkish with
 .Dq dead accents
 .It Li KB_UA Ta ua Ta Ukrainian
 .It Li "KB_US|KB_DECLK" Ta \&us.declk Ta English/US mapping for Tn DEC
 .It Ta Ta LK400-style keyboards with PC keyboard
 .It Ta Ta interface (e.g., LK461)
 .It Li "KB_US|KB_DVORAK" Ta us.dvorak Ta English/US keyboard with
 .It Ta Ta Do Dvorak Dc layout
 .It Li "KB_US|KB_COLEMAK" Ta us.colemak Ta English/US keyboard with
 .It Ta Ta Do Colemak Dc layout
 .El
 .Pp
 The
 .Li KB_BR ,
 .Li KB_DE ,
 .Li KB_DK ,
 .Li KB_NO ,
 .Li KB_NL ,
 .Li KB_SF ,
 .Li KB_SG ,
 .Li KB_SV ,
 and
 .Li KB_TR
 mappings can be used in the
 .Li KB_NODEAD (
 .Dq .nodead )
 variant.
 This switches off the
 .Dq dead accents .
 .Pp
 The
 .Li KB_US ,
 .Li KB_UK ,
 .Li KB_FR ,
 .Li KB_JP
 and
 .Li KB_US|KB_DVORAK
 mappings can be modified
 to swap the left CTRL and the CAPS LOCK keys by the
 .Li KB_SWAPCTRLCAPS
 variant bit or the
 .Dq .swapctrlcaps
 suffix.
 .Pp
 The
 .Li 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 the use of the standard ISA speaker for this purpose.
 On acorn32,
 .Xr acorn32/vidcaudio 4
 performs this function.
 .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 simultaneously, use
 .Ic wsconsctl Fl w Ar encoding=de.nodead.metaesc .
 To set it at kernel build time, add
 .D1 Cd options 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 builtin mappings doesn't follow any logic.
 It grew as people submitted what they needed.

 @@ -1,40 +1,40 @@
-.\" $NetBSD: wskbd.4,v 1.17 2019/08/12 11:11:28 nia Exp $
+.\" $NetBSD: wskbd.4,v 1.18 2020/07/13 11:14:12 nia Exp $
 .\"
 .\" Copyright (c) 1999
 .\" 	Matthias Drochner.  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.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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 27, 2012
+.Dd July 13, 2020
 .Dt WSKBD 4
 .Os
 .Sh NAME
 .Nm wskbd
 .Nd generic keyboard support in wscons
 .Sh SYNOPSIS
 .Cd "wskbd* at pckbd? console ? mux 1"
 (standard PC keyboard)
 .Cd "wskbd* at ukbd? console ? mux 1"
 (USB keyboard)
 .Cd "wskbd* at lkkbd? console ? mux 1"
 (DEC LK200/400 serial keyboard)
 .Cd "wskbd0 at akbd? console ? mux 1"
 @@ -104,26 +104,107 @@ A complete list is in
 The
 .Xr wsconsctl 8
 utility allows to access key maps and other variables.
 .Pp
 The
 .Em console
 locator in the configuration line refers to the device's use as input
 part of the operating system console.
 A device specification containing a positive value here will only
 match if the device is in use as system console.
 (The console device selection in early system startup is not influenced.)
 This way, the console device can be connected to a known
 wskbd device instance.
 .Ss Keyboard encodings
 The following encodings are supported.
 Device drivers for legacy keyboard interfaces may only support a subset
 of these.
 However, generally, all encodings are supported by
 .Xr pckbd 4 and
 .Xr ukbd 4 .
 .Bl -column " us.colemak" " KB_US|KB_COLEMAK" "language"
 .It Sy "wsconsctl" Ta Sy "define" Ta Sy "language"
 .It Li user Ta KB_USER Ta User-defined
 .It Li us Ta KB_US Ta English/US keyboard mapping (default)
 .It Li uk Ta KB_UK Ta English/UK keyboard mapping
 .It Li be Ta KB_BE Ta Belgian
 .It Li br Ta KB_BR Ta Brazilian with
 .Dq dead accents
 .It Li cf Ta KB_CF Ta Canadian French
 .It Li cz Ta KB_CZ Ta Czech (QWERTY)
 .It Li dk Ta KB_DK Ta Danish with
 .Dq dead accents
 .It Li nl Ta KB_NL Ta Dutch
 .It Li ee Ta KB_DK Ta Estonian with
 .Dq dead accents
 .It Li fi Ta KB_FI Ta Finnish
 .It Li fr Ta KB_FR Ta French
 .It Li de Ta KB_DE Ta German with
 .Dq dead accents
 .It Li gr Ta KB_GR Ta Greek
 .It Li hu Ta KB_HU Ta Hungarian
 .It Li is Ta KB_IS Ta Icelandic with
 .Dq dead accents
 .It Li it Ta KB_IT Ta Italian
 .It Li jp Ta KB_JP Ta Japanese
 .It Li no Ta KB_NO Ta Norwegian with
 .Dq dead accents
 .It Li pl Ta KB_PL Ta Polish
 .It Li pt Ta KB_PT Ta Portuguese
 .It Li ru Ta KB_RU Ta Russian
 .It Li es Ta KB_ES Ta Spanish
 .It Li sv Ta KB_SV Ta Swedish with
 .Dq dead accents
 .It Li sf Ta KB_SF Ta Swiss French
 .It Li sg Ta KB_SG Ta Swiss German
 .It Li tr Ta KB_TR Ta Turkish (QWERTY) with
 .Dq dead accents
 .It Li ua Ta KB_UA Ta Ukrainian
 .It Li \&us.declk Ta "KB_US|KB_DECLK" Ta English/US mapping for Tn DEC
 .It Ta Ta LK400-style keyboards with PC keyboard
 .It Ta Ta interface (e.g., LK461)
 .It Li us.dvorak Ta "KB_US|KB_DVORAK" Ta English/US keyboard with
 .It Ta Ta Do Dvorak Dc layout
 .It Li us.colemak Ta "KB_US|KB_COLEMAK" Ta English/US keyboard with
 .It Ta Ta Do Colemak Dc layout
 .El
 .Pp
 .Li KB_NODEAD (
 .Dq .nodead )
 can be applied to layouts with
 .Dq dead accents
 to switch them off.
 .Pp
 The
 .Li KB_US ,
 .Li KB_UK ,
 .Li KB_FR ,
 .Li KB_JP
 and
 .Li KB_US|KB_DVORAK
 mappings can be modified
 to swap the left CTRL and the CAPS LOCK keys by the
 .Li KB_SWAPCTRLCAPS
 variant bit or the
 .Dq .swapctrlcaps
 suffix.
 .Pp
 The
 .Li 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.)
 .Ss Ioctls
 The following
 .Xr ioctl 2
 calls are provided by the
 .Nm
 driver or by devices which use it.
 Their definitions are found in
 .Pa dev/wscons/wsconsio.h .
 .Bl -tag -width Dv
 .It Dv WSKBDIO_GTYPE
 Get the keyboard type.
 .It Dv WSKBDIO_COMPLEXBELL, WSKBDIO_SETBELL, WSKBDIO_GETBELL, WSKBDIO_SETDEFAULTBELL, WSKBDIO_GETDEFAULTBELL Pq Li "struct wsmouse_repeat"
 Get and set keyboard bell settings.
 @@ -159,13 +240,16 @@ if (ioctl(fd, WSKBDIO_SETVERSION, &ver)
 .It
 .Pa /usr/include/dev/wscons/wsksymdef.h
 .It
 .Pa /usr/include/dev/wscons/wsconsio.h .
 .El
 .Sh SEE ALSO
 .Xr btkbd 4 ,
 .Xr pckbd 4 ,
 .Xr ukbd 4 ,
 .Xr wscons 4 ,
 .Xr wsmux 4 ,
 .Xr wsconsctl 8 ,
 .Xr wskbd 9
 .Sh BUGS
 The list of builtin mappings doesn't follow any logic.
 It grew as people submitted what they needed.