From: "Omar Polo" <op@omarpolo.com>
Subject: Re: kbd(8): man page improvement
To: Helg <helg-openbsd@gmx.de>
Cc: tech@openbsd.org
Date: Tue, 30 Dec 2025 09:51:11 +0100

Helg <helg-openbsd@gmx.de> wrote:
> Here's an updated diff.
> 
> 
> Index: kbd.8
> ===================================================================
> RCS file: /cvs/src/sbin/kbd/kbd.8,v
> diff -u -p -r1.13 kbd.8
> --- kbd.8	27 Jul 2015 17:28:39 -0000	1.13
> +++ kbd.8	29 Dec 2025 21:46:29 -0000
> @@ -64,8 +64,18 @@ List all available keyboard encodings.
>  Quiet mode.
>  No message is printed unless an error occurs.
>  .El
> +.Pp
> +The
> +.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.)
>  .Sh FILES
>  .Bl -tag -width "/etc/kbdtypeXXX"
>  .It Pa /etc/kbdtype
>  Default national encoding.
>  .El
> +.Sh SEE ALSO
> +.Xr wsconsctl 8 ,
> +.Xr wskbd 4

nit: these are sort by section first, and then alphabetically, so wskbd
should come first.

other than that, this reads ok to me (and that doubles as in "ok op@" to
commit ;-), but maybe it's better to wait for an ok from someone that's
more comfortable with this area as a second confirmation ^^"


Thanks!
Omar Polo