From: Pierre Le Marre <dev@wismill.eu>
Date: Tue, 3 Oct 2023 08:28:47 +0000 (+0200)
Subject: Tools: Improve xkbcli help messages and manual pages
X-Git-Tag: accepted/tizen/unified/20240109.155348~58
X-Git-Url: http://review.tizen.org/git/?p=platform%2Fupstream%2Flibxkbcommon.git;a=commitdiff_plain;h=357c00b3a1c28afeb352887397ab9549740f1c85

Tools: Improve xkbcli help messages and manual pages

Add missing `--help` and `--short` entries.
---

diff --git a/tools/interactive-evdev.c b/tools/interactive-evdev.c
index 8da1056..2dece75 100644
--- a/tools/interactive-evdev.c
+++ b/tools/interactive-evdev.c
@@ -391,6 +391,8 @@ usage(FILE *fp, char *progname)
                         "          --enable-compose (enable Compose)\n"
                         "          --consumed-mode={xkb|gtk} (select the consumed modifiers mode, default: xkb)\n"
                         "          --without-x11-offset (don't add X11 keycode offset)\n"
+                    "Other:\n"
+                        "          --help (display this help and exit)\n"
         );
 }
 
diff --git a/tools/registry-list.c b/tools/registry-list.c
index c360da7..994860d 100644
--- a/tools/registry-list.c
+++ b/tools/registry-list.c
@@ -40,6 +40,7 @@ usage(const char *progname, FILE *fp)
             "  --ruleset=foo .......... Load the 'foo' ruleset\n"
             "  --skip-default-paths ... Do not load the default XKB paths\n"
             "  --load-exotic .......... Load the exotic (extra) rulesets\n"
+            "  --help ................. Print this help and exit\n"
             "\n"
             "Trailing arguments are treated as XKB base directory installations.\n",
             progname);
diff --git a/tools/xkbcli-how-to-type.1 b/tools/xkbcli-how-to-type.1
index d5002ae..720d8b8 100644
--- a/tools/xkbcli-how-to-type.1
+++ b/tools/xkbcli-how-to-type.1
@@ -34,6 +34,9 @@ The XKB layout variant
 .
 .It Fl \-options Ar options
 The XKB options
+.
+.It Fl \-help
+Print a help message and exit.
 .El
 .
 .Sh SEE ALSO
diff --git a/tools/xkbcli-interactive-evdev.1 b/tools/xkbcli-interactive-evdev.1
index 13c7b2c..167e3ec 100644
--- a/tools/xkbcli-interactive-evdev.1
+++ b/tools/xkbcli-interactive-evdev.1
@@ -68,6 +68,9 @@ The XKB options
 Specify a keymap path.
 This option is mutually exclusive with the RMLVO options.
 .
+.It Fl \-short
+Do not print layout nor Unicode keysym translation.
+.
 .It Fl \-report\-state\-changes
 Report changes to the keyboard state
 .