On Tue, Dec 30, 2025 at 09:51:11AM +0100, Omar Polo wrote:
> 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 ^^"

Well the described behaviour certainly matches what wskbd.c does with the
KB_METAESC flag - this is one of a few options that are handled directly in
the wskbd.c code so it's not implemented 'per layout', but rather hard-coded
as a conditional in wskbd.c with a fixed behaviour.

That might explain why it wasn't really documented before, but anyway the
suggested man page addition seems ok to me.