From e71f637d71eab2a4c98b459de4e85db4f27d45dd Mon Sep 17 00:00:00 2001
From: helg <helg@openbsd.org>
Date: Sat, 3 Jan 2026 08:54:25 +0000
Subject: [PATCH] While it's clear from this man page that it's possible to
 list all encoding with the -l flag, there is no mention of the hidden
 .metaesc option. Also add reference to wskbd and wsconsctl, which can also be
 used to change the keyboard.encoding.

ok op@
---
 sbin/kbd/kbd.8 | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/sbin/kbd/kbd.8 b/sbin/kbd/kbd.8
index 7e11a113f21..ae0d4dbe47a 100644
--- a/sbin/kbd/kbd.8
+++ b/sbin/kbd/kbd.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: kbd.8,v 1.13 2015/07/27 17:28:39 sobrado Exp $
+.\"	$OpenBSD: kbd.8,v 1.14 2026/01/03 08:54:25 helg Exp $
 .\"
 .\" Copyright (c) 1996 Juergen Hannken-Illjes
 .\" All rights reserved.
@@ -30,7 +30,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: July 27 2015 $
+.Dd $Mdocdate: January 3 2026 $
 .Dt KBD 8
 .Os
 .Sh NAME
@@ -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 wskbd 4 ,
+.Xr wsconsctl 8