From 7fc040300305704ad7f6ceba2163f08981811152 Mon Sep 17 00:00:00 2001
From: Alexander Ziaee <concussious@runbox.com>
Date: Tue, 4 Jun 2024 07:03:10 -0400
Subject: [PATCH] doc (manuals): clean and expand apropos results

Previously on FreeBSD/mandoc (probably affecting others), everything
except xkbcli was being listed twice and wrapping in apropos because
mdoc(7) names should not have spaces or be different than the title.

Further, xkb is already parsed in search results by being in the name,
so expand xkb to "X keyboard" so that they match for apropos keyboard.
We did this already in xkbutils, which matches setxkbmap.

These don't need to be quoted literals, and - doesn't need to be escaped,
but I left them because there may be environments which are not to spec,
but I'm happy to ammend this commit if that cleanup seems desirable.
---
 tools/xkbcli-compile-compose.1     | 6 +++---
 tools/xkbcli-compile-keymap.1      | 6 +++---
 tools/xkbcli-how-to-type.1         | 4 ++--
 tools/xkbcli-interactive-evdev.1   | 6 +++---
 tools/xkbcli-interactive-wayland.1 | 6 +++---
 tools/xkbcli-interactive-x11.1     | 6 +++---
 tools/xkbcli-list.1                | 6 +++---
 tools/xkbcli.1                     | 4 ++--
 8 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/tools/xkbcli-compile-compose.1 b/tools/xkbcli-compile-compose.1
index 1d86a3cd2..7229249d9 100644
--- a/tools/xkbcli-compile-compose.1
+++ b/tools/xkbcli-compile-compose.1
@@ -1,10 +1,10 @@
-.Dd November 7, 2023
+.Dd June 4, 2024
 .Dt XKBCLI\-COMPILE\-COMPOSE 1
 .Os
 .
 .Sh NAME
-.Nm "xkbcli compile-compose"
-.Nd compile a Compose file
+.Nm "xkbcli\-compile\-compose"
+.Nd compile a X Keyboard Compose file
 .
 .Sh SYNOPSIS
 .Nm
diff --git a/tools/xkbcli-compile-keymap.1 b/tools/xkbcli-compile-keymap.1
index 424651225..74c08826e 100644
--- a/tools/xkbcli-compile-keymap.1
+++ b/tools/xkbcli-compile-keymap.1
@@ -1,10 +1,10 @@
-.Dd July 27, 2020
+.Dd June 4, 2024
 .Dt XKBCLI\-COMPILE\-KEYMAP 1
 .Os
 .
 .Sh NAME
-.Nm "xkbcli compile\-keymap"
-.Nd compile an XKB keymap
+.Nm "xkbcli\-compile\-keymap"
+.Nd compile an X Keyboard keymap
 .
 .Sh SYNOPSIS
 .Nm
diff --git a/tools/xkbcli-how-to-type.1 b/tools/xkbcli-how-to-type.1
index 720d8b89f..be927d886 100644
--- a/tools/xkbcli-how-to-type.1
+++ b/tools/xkbcli-how-to-type.1
@@ -1,9 +1,9 @@
-.Dd July 27, 2020
+.Dd June 4, 2024
 .Dt XKBCLI\-HOW\-TO\-TYPE 1
 .Os
 .
 .Sh NAME
-.Nm "xkbcli how\-to\-type"
+.Nm "xkbcli\-how\-to\-type"
 .Nd query how to type a given Unicode codepoint
 .
 .Sh SYNOPSIS
diff --git a/tools/xkbcli-interactive-evdev.1 b/tools/xkbcli-interactive-evdev.1
index 167e3ec65..25d698e0a 100644
--- a/tools/xkbcli-interactive-evdev.1
+++ b/tools/xkbcli-interactive-evdev.1
@@ -1,10 +1,10 @@
-.Dd July 27, 2020
+.Dd June 4, 2024
 .Dt XKBCLI\-INTERACTIVE\-EVDEV 1
 .Os
 .
 .Sh NAME
-.Nm "xkbcli interactive\-evdev"
-.Nd interactive debugger for XKB keymaps
+.Nm "xkbcli\-interactive\-evdev"
+.Nd interactive debugger for X Keyboard keymaps
 .
 .Sh SYNOPSIS
 .Nm
diff --git a/tools/xkbcli-interactive-wayland.1 b/tools/xkbcli-interactive-wayland.1
index 0542e07d8..9035d392a 100644
--- a/tools/xkbcli-interactive-wayland.1
+++ b/tools/xkbcli-interactive-wayland.1
@@ -1,10 +1,10 @@
-.Dd July 27, 2020
+.Dd June 4, 2024
 .Dt XKBCLI\-INTERACTIVE\-WAYLAND 1
 .Os
 .
 .Sh NAME
-.Nm "xkbcli interactive\-wayland"
-.Nd interactive debugger for XKB keymaps
+.Nm "xkbcli\-interactive\-wayland"
+.Nd interactive debugger for X Keyboard keymaps
 .
 .Sh SYNOPSIS
 .Nm
diff --git a/tools/xkbcli-interactive-x11.1 b/tools/xkbcli-interactive-x11.1
index dbbd25b34..9359d6c03 100644
--- a/tools/xkbcli-interactive-x11.1
+++ b/tools/xkbcli-interactive-x11.1
@@ -1,10 +1,10 @@
-.Dd July 27, 2020
+.Dd June 4, 2024
 .Dt XKBCLI\-INTERACTIVE\-X11 1
 .Os
 .
 .Sh NAME
-.Nm "xkbcli interactive\-x11"
-.Nd interactive debugger for XKB keymaps
+.Nm "xkbcli\-interactive\-x11"
+.Nd interactive debugger for X Keyboard keymaps
 .
 .Sh SYNOPSIS
 .Nm
diff --git a/tools/xkbcli-list.1 b/tools/xkbcli-list.1
index 66ea09b33..470484d6a 100644
--- a/tools/xkbcli-list.1
+++ b/tools/xkbcli-list.1
@@ -1,10 +1,10 @@
-.Dd November 1, 2021
+.Dd June 04, 2024
 .Dt XKBCLI\-LIST 1
 .Os
 .
 .Sh NAME
-.Nm "xkbcli list"
-.Nd list available XKB models, layouts, variants and options
+.Nm "xkbcli\-list"
+.Nd list available X Keyboard models, layouts, variants and options
 .
 .Sh SYNOPSIS
 .Nm
diff --git a/tools/xkbcli.1 b/tools/xkbcli.1
index 285f46389..737bee6c2 100644
--- a/tools/xkbcli.1
+++ b/tools/xkbcli.1
@@ -1,10 +1,10 @@
-.Dd July 27, 2020
+.Dd June 4, 2024
 .Dt XKBCLI 1
 .Os
 .
 .Sh NAME
 .Nm xkbcli
-.Nd tool to interact with XKB keymaps
+.Nd tool to interact with X Keyboard keymaps
 .
 .Sh SYNOPSIS
 .Nm