| 
              
9cc19e4e
               | 
              
2025-08-04T22:42:34
               | 
              
               | 
              
tools: Fix missing --verbose doc + misc
               | 
            
            
              
   
               | 
              
29579ad4
               | 
              
2025-08-04T12:35:25
               | 
              
               | 
              
tools: Add --verbose to all tools
Added `--verbose` to:
- `xkbcli interactive-wayland`
- `xkbcli interactive-x11`
- `xkbcli compile-compose`
- `xkbcli how-to-type`
               | 
            
            
              
   
               | 
              
f5d079f5
               | 
              
2025-08-04T09:58:42
               | 
              
               | 
              
tools: Improve interactive events output
Improved the output of events for `xkbcli interactive-*` tools:
- Added `--multiline` to enable multiline event output, which provides
  more details and does not have formatting limitations.
- Added `--uniline` to enable uniline event output. While this is the
  current default, future versions may switch to multiline display.
               | 
            
            
              
   
               | 
              
82ea2915
               | 
              
2025-05-06T17:22:22
               | 
              
               | 
              
tools: Add options to use explicit keymap format
The default output keymap format is `XKB_KEYMAP_USE_ORIGINAL_FORMAT`.
               | 
            
            
              
   
               | 
              
5cfd36ab
               | 
              
2025-02-14T10:35:49
               | 
              
               | 
              
tools: Do not load names from the environment by default
Our tools are debugging tools and as such we need to have complete
control to be able to reproduce setups. This is not currently the case,
as we do not use `XKB_CONTEXT_NO_ENVIRONMENT_NAMES` by default nor can
we set it.
So it is very easy to forget about the various `XKB_DEFAULT_*`
environement variables for the default RMLVO values, then to get puzzled
by unexpected results.
Added to that, these environment variables do not work correctly in
`xkbcli-compile-xeymap`: calling the tool without RMLVO values will
use these variables only if the RMLVO values are set explicitly empty or
if the various *constants* `DEFAULT_XKB_*` are empty. This is unexpected,
as the environment variables should *always* be used unless:
- `XKB_CONTEXT_NO_ENVIRONMENT_NAMES` is used (not the case here);
- the variable is empty; in this case the constants `DEFAULT_XKB_*` are
  used.
Fixed by the following *breaking change*: make the tools use
`XKB_CONTEXT_NO_ENVIRONMENT_NAMES` *by default*, unless the new
`--enable-environment-names` option is used.
We also make `rmlvo` incompatible with `--enable-environment-names` for
now in the public tool, as else it requires a private API.
               | 
            
            
              
   
               | 
              
bcb16d29
               | 
              
2025-01-28T13:19:06
               | 
              
               | 
              
tools: Miscellaneous enhancements
               | 
            
            
              
   
               | 
              
b168623c
               | 
              
2025-01-28T13:24:14
               | 
              
               | 
              
tools: Enable using keymap file as a positional argument
               | 
            
            
              
   
               | 
              
a4f62fcd
               | 
              
2024-06-04T07:03:10
               | 
              
               | 
              
doc (manuals): clean and expand apropos results
Previously on FreeBSD/mandoc (probably affecting others), everything
except xkbcli was being listed twice and wrapping on standard console
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.
Co-authored-by: Ran Benita <ran@unusedvar.com>
               | 
            
            
              
   
               | 
              
357c00b3
               | 
              
2023-10-03T10:28:47
               | 
              
               | 
              
Tools: Improve xkbcli help messages and manual pages
Add missing `--help` and `--short` entries.
               | 
            
            
              
   
               | 
              
de9d8207
               | 
              
2023-06-16T09:54:09
               | 
              
               | 
              
interactive-evdev: includes options
Currently there is no interactive tool allowing to set the include
paths of the context, such as in "compile-keymap". Note that only
"interactive-evdev" makes sense, because it does not rely on a
compositor.
Add --include and --include-defaults to "interactive-evdev" tool.
The code is adapted from "compile-keymap".
               | 
            
            
              
   
               | 
              
6b65be4c
               | 
              
2021-03-28T12:55:08
               | 
              
               | 
              
interactive-evdev: switch from epoll(2) to poll(2)
Turns out FreeBSD supports evdev, so this toll can work on it; however
it does not support epoll, so switch to poll, which is portable.
Reported-by: Evgeniy Khramtsov <evgeniy@khramtsov.org>
Signed-off-by: Ran Benita <ran@unusedvar.com>
               | 
            
            
              
   
               | 
              
d5c6b581
               | 
              
2020-07-27T11:24:06
               | 
              
               | 
              
tools: convert man pages from man format to mdoc format
The mdoc is more semantic and consistent.
Signed-off-by: Ran Benita <ran@unusedvar.com>
               | 
            
            
              
   
               | 
              
64bff65a
               | 
              
2020-07-27T11:51:53
               | 
              
               | 
              
tools/interactive-evdev: change --evdev-offset to --without-x11-offset
There is no reason to give full control rather than just enable/disable.
Signed-off-by: Ran Benita <ran@unusedvar.com>
               | 
            
            
              
   
               | 
              
f439ce18
               | 
              
2020-07-25T11:17:11
               | 
              
               | 
              
tools: some minor changes to xkbcli
Signed-off-by: Ran Benita <ran@unusedvar.com>
               | 
            
            
              
   
               | 
              
cd119a28
               | 
              
2020-07-23T09:37:15
               | 
              
               | 
              
Drop use of ronn, switch to raw roff instead
Drop the ronn source files, check in the generated files instead. This gets rid
of the ruby+gem+ronn toolchain requirement at the cost of having to edit raw man
pages.
ronn files are as-generated but with the preamble and generation date removed.
The latter isn't important enough to keep, it'll just go stale for manually
maintained files and it's not worth setting up a configure_file() just for that
date.
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
               |