+libxkbcommon 1.5.0 - 2023-01-02
+==================
+
+- Add `xkb_context` flag `XKB_CONTEXT_NO_SECURE_GETENV` and `rxkb_context` flag
+ `RXKB_CONTEXT_NO_SECURE_GETENV`.
+
+ xkbcommon uses `getenv_secure()` to obtain environment variables. This flag
+ makes xkbcommon use `getenv()` instead.
+
+ This is useful for some clients that have relatively benign capabilities set,
+ like CAP_SYS_NICE, that also want to use e.g. the XKB configuration from the
+ environment and user configs in XDG_CONFIG_HOME.
+
+ Contributed by Ronan Pigott.
+
+- Fix crash in `xkbcli interactive-wayland` under a compositor which supports
+ new versions of the xdg-shell protocol.
+
+ Contributed by Jan Alexander Steffens (heftig).
+
+- Fix some MSVC build issues.
+
+- Fix some issues when including xkbcommon as a meson subproject.
+
+- meson>=0.51 is now required.
+
+- New API:
+ XKB_CONTEXT_NO_SECURE_GETENV
+ RXKB_CONTEXT_NO_SECURE_GETENV
+
+libxkbcommon 1.4.1 - 2022-05-21
+==================
+
+- Fix compose sequence overriding (common prefix) not working correctly.
+ Regressed in 1.2.0.
+
+ Contributed by Weng Xuetian.
+
+- Remove various bogus currency sign (particulary Euro and Korean Won) entries
+ from the keysym <-> Unicode mappings. They prevented the real
+ keysyms/codepoints for these from mapping correctly.
+
+ Contributed by Sam Lantinga and Simon Ser.
+
+libxkbcommon 1.4.0 - 2022-02-04
+==================
+
+- Add `enable-tools` option to Meson build (on by default) to allow disabling
+ the `xkbcli` tools.
+
+ Contributed by Alex Xu (Hello71).
+
+- In `xkbcli list`, fix "YAML Norway problem" in output.
+
+ Contributed by Peter Hutterer.
+
+- In libxkbregistry, variants now inherit iso639, iso3166 and brief from parent
+ layout if omitted.
+
+ Contributed by M Hickford.
+
+- In libxkbregistry, don't call `xmlCleanupParser()` - it's not supposed to
+ be called by libraries.
+
+ Contributed by Peter Hutterer.
+
+- In libxkbregistry, skip over invalid ISO-639 or ISO-3166 entries.
+
+ Contributed by Peter Hutterer.
+
+libxkbcommon 1.3.1 - 2021-09-10
+==================
+
+- In `xkbcli interactive-x11`, use the Esc keysym instead of the Esc keycode
+ for quitting.
+
+ Contributed by Simon Ser.
+
+- In `xkbcli how-to-type`, add `--keysym` argugment for how to type a keysym
+ instead of a Unicode codepoint.
+
+- Fix a crash in `xkb_x11_keymap_new_from_device` error handling given some
+ invalid keymaps. Regressed in 1.2.0.
+
+ Reported by Zack Weinberg. Tested by Uli Schlachter.
+
+libxkbcommon 1.3.0 - 2021-05-01
+==================
+
+- Change `xkbcli list` to output YAML, instead of the previous ad-hoc format.
+
+ This allows to more easily process the information in a programmetic way, for
+ example
+
+ xkbcli list | yq -r ".layouts[].layout"
+
+ Contributed by Peter Hutterer.
+
+- Optimize a certain part of keymap compilation (atom interning).
+
+- Fix segmentation fault in case-insensitive `xkb_keysym_from_name` for certain
+ values like the empty string.
+
+ Contributed by Isaac Freund.
+
+- Support building libxkbcommon as a meson subproject.
+
+ Contributed by Adrian Perez de Castro.
+
+- Add `ftruncate` fallback for `posix_fallocate` in `xkbcli interactive-wayland`
+ for FreeBSD.
+
+ Contributed by Evgeniy Khramtsov.
+
+- Properly export library symbols in MSVC.
+
+ Contributed by Adrian Perez de Castro.
+
+libxkbcommon 1.2.1 - 2021-04-07
+==================
+
+- Fix `xkb_x11_keymap_new_from_device()` failing when the keymap contains key
+ types with missing level names, like the one used by the `numpad:mac` option
+ in xkeyboard-config. Regressed in 1.2.0.
+
+libxkbcommon 1.2.0 - 2021-04-03
+==================
+
+- `xkb_x11_keymap_new_from_device()` is much faster. It now performs only 2
+ roundtrips to the X server, instead of dozens (in first-time calls).
+
+ Contributed by Uli Schlachter.
+
+- Case-sensitive `xkb_keysym_from_name()` is much faster.
+
+- Keysym names of the form `0x12AB` and `U12AB` are parsed more strictly.
+ Previously the hexadecimal part was parsed with `strtoul()`, now only up
+ to 8 hexadecimal digits (0-9A-Fa-f) are allowed.
+
+- Compose files now have a size limit (65535 internal nodes). Further sequences
+ are discared and a warning is issued.
+
+- Compose table loading (`xkb_compose_table_new_from_locale()` and similar) is
+ much faster.
+
+- Use `poll()` instead of `epoll()` for `xlbcli interactive-evdev`, making it
+ portable to FreeBSD which provides evdev but not epoll. On FreeBSD, remember
+ to install the `evdev-proto` package to get the evdev headers.
+
+- The build now requires a C11 compiler (uses anonymous structs/unions).
+
+libxkbcommon 1.1.0 - 2021-02-27
+==================
+
+- Publish the `xkb-format-text-v1.md` file in the HTML documentation. This file
+ existed for a long time but only in the Git repository.
+ Link: https://xkbcommon.org/doc/current/md_doc_keymap_format_text_v1.html
+
+- Add partial documentation for xkb_symbols to xkb-format-text-v1.md.
+
+ Contributed by Simon Zeni.
+
+- Update keysym definitions to latest xorgproto. In particular, this adds many
+ special keysyms corresponding to Linux evdev keycodes.
+
+ Contributed by Peter Hutterer <@who-t.net>.
+
+- New API:
+ Too many XKB_KEY_* definitions to list here.
+
+libxkbcommon 1.0.3 - 2020-11-23
+==================
+
+- Fix (hopefully) a segfault in xkb_x11_keymap_new_from_device() in some
+ unclear situation (bug introduced in 1.0.2).
+
+- Fix keymaps created with xkb_x11_keymap_new_from_device() don't have level
+ names (bug introduced in 0.8.0).
+
+libxkbcommon 1.0.2 - 2020-11-20
+==================
+
+- Fix a bug where a keysym that cannot be resolved in a keymap gets compiled to
+ a garbage keysym. Now it is set to XKB_KEY_NoSymbol instead.
+
+- Improve the speed of xkb_x11_keymap_new_from_device() on repeated calls in the
+ same xkb_context().
+
+
+libxkbcommon 1.0.1 - 2020-09-11
+==================
+
+- Fix the tool-option-parsing test failing.
+
+- Remove requirement for pytest in the tool-option-parsing test.
+
+- Make the table output of `xkbcli how-to-type` aligned.
+
+- Some portability and test isolation fixes.
+
+libxkbcommon 1.0.0 - 2020-09-05
+==================
+
+Note: this release is API and ABI compatible with previous releases -- the
+major version bump is only an indication of stability.
+
+- Add libxkbregistry as configure-time optional library. libxkbregistry is a C
+ library that lists available XKB models, layouts and variants for a given
+ ruleset. This is a separate library (libxkbregistry.so, pkgconfig file
+ xkbregistry.pc) and aimed at tools that provide a listing of available
+ keyboard layouts to the user. See the Documentation for details on the API.
+
+ Contributed by Peter Hutterer <@who-t.net>.
+
+- Better support custom user configuration:
+
+ * Allow including XKB files from other paths.
+
+ Previously, a 'symbols/us' file in path A would shadow the same file in
+ path B. This is suboptimal, we rarely need to hide the system files - we
+ care mostly about *extending* them. By continuing to check other lookup
+ paths, we make it possible for a XDG_CONFIG_HOME/xkb/symbols/us file to
+ have sections including those from /usr/share/X11/xkb/symbols/us.
+
+ Note that this is not possible for rules files, which need to be manually
+ controlled to get the right bits resolved.
+
+ * Add /etc/xkb as extra lookup path for system data files.
+
+ This completes the usual triplet of configuration locations available for
+ most processes:
+ - vendor-provided data files in /usr/share/X11/xkb
+ - system-specific data files in /etc/xkb
+ - user-specific data files in $XDG_CONFIG_HOME/xkb
+
+ The default lookup order user, system, vendor, just like everything else
+ that uses these conventions.
+
+ For include directives in rules files, the '%E' resolves to that path.
+
+ * Add a new section to the documentation for custom user configuration.
+
+ Contributed by Peter Hutterer <@who-t.net>.
+
+- Add an `xkbcli` command-line utility.
+
+ This tool offers various subcommands for introspection and debugging.
+ Currently the available subcommands are:
+
+ list
+ List available rules, models, layouts, variants and options
+
+ interactive-wayland
+ Interactive debugger for XKB keymaps for Wayland
+
+ interactive-x11
+ Interactive debugger for XKB keymaps for X11
+
+ interactive-evdev
+ Interactive debugger for XKB keymaps for evdev (Linux)
+
+ compile-keymap
+ Compile an XKB keymap
+
+ how-to-type
+ See separate entry below.
+
+ See the manpages for usage information.
+
+ Contributed by Peter Hutterer <@who-t.net>.
+
+- Add `xkb_utf32_to_keysym()` to translate a Unicode codepoint to a keysym.
+ When a special keysym (`XKB_KEY_` constant) for the codepoint exists, it is
+ returned, otherwise the direct encoding is used, if permissible.
+
+ Contributed by Jaroslaw Kubik <@froglogic.com>.
+
+- Add `xkb_keymap_key_get_mods_for_level()` which retrieves sets of modifiers
+ which produce a given shift level in a given key+layout.
+
+ Contributed by Jaroslaw Kubik <@froglogic.com>.
+
+- Add `xkbcli how-to-type` command, which, using `xkb_utf32_to_keysym()`
+ and `xkb_keymap_key_get_mods_for_level()` and other APIs, prints out all
+ the ways to produce a given keysym.
+
+ For example, how to type `?` (codepoint 63) in a us,de keymap?
+
+ $ xkbcli how-to-type --layout us,de 63 | column -ts $'\t'
+ keysym: question (0x3f)
+ KEYCODE KEY NAME LAYOUT# LAYOUT NAME LEVEL# MODIFIERS
+ 20 AE11 2 German 2 [ Shift ]
+ 20 AE11 2 German 2 [ Shift Lock ]
+ 61 AB10 1 English (US) 2 [ Shift ]
+
+- Add a new section to the documentation describing the format of the XKB
+ rules file.
+
+- Search for Compose in $XDG_CONFIG_HOME/XCompose (fallback to
+ ~/.config/XCompose) before trying $HOME/.XCompose.
+
+ Note that libX11 still only searches in $HOME/.XCompose.
+
+ Contributed by Emmanuel Gil Peyrot <@linkmauve.fr>.
+
+- Bump meson requirement to >= 0.49.0.
+
+- Fix build with byacc.
+
+- Fix building X11 tests on PE targets.
+
+ Contributed by Jon Turney <@dronecode.org.uk>
+
+- The tests no longer rely on bash, only Python (which is already used by
+ meson).
+
+- New API:
+ xkb_utf32_to_keysym
+ xkb_keymap_key_get_mods_for_level
+ XKB_KEY_XF86FullScreen
+
+
+libxkbcommon 0.10.0 - 2020-01-18
+===================
+
+- (security) Fix quadratic complexity in the XKB file parser. See commit
+ message 7c42945e04a2107827a057245298dedc0475cc88 for details.
+
+- Add $XDG_CONFIG_HOME/xkb to the default search path. If $XDG_CONFIG_HOME
+ is not set, $HOME/.config/xkb is used. If $HOME is not set, the path is not
+ added.
+
+ The XDG path is looked up before the existing default search path $HOME/.xkb.
+
+ Contributed by Peter Hutterer <@who-t.net>.
+
+- Add support for include statements in XKB rules files.
+
+ This is a step towards making local XKB customizations more tenable and
+ convenient, without modifying system files.
+
+ You can now include other rules files like this:
+
+ ! include %S/evdev
+
+ Two directives are supported, %H to $HOME and %S for the system-installed
+ rules directory (usually /usr/share/X11/xkb/rules).
+
+ See commit message ca033a29d2ca910fd17b1ae287cb420205bdddc8 and
+ doc/rules-format.txt in the xkbcommon source code for more information.
+
+ Contributed by Peter Hutterer <@who-t.net>.
+
+- Downgrade "Symbol added to modifier map for multiple modifiers" log to a
+ warning.
+
+ This error message was too annoying to be shown by default. When working on
+ keymaps, set `XKB_LOG_LEVEL=debug XKB_LOG_VERBOSITY=10` to see all possible
+ messages.
+
+- Support building on Windows using the meson MSVC backend.
+
+ Contributed by Adrian Perez de Castro <@igalia.com>.
+
+- Fix bug where the merge mode only applied to the first vmod in a
+ `virtual_modifiers` statement. Given
+
+ augment virtual_modifiers NumLock,Alt,LevelThree
+
+ Previously it was incorrectly treated as
+
+ augment virtual_modifiers NumLock;
+ virtual_modifiers Alt;
+ virtual_modifiers LevelThree;
+
+ Now it is treated as
+
+ augment virtual_modifiers NumLock;
+ augment virtual_modifiers Alt;
+ augment virtual_modifiers LevelThree;
+
+- Reject interpret modifier predicate with more than one value. Given
+
+ interpret ISO_Level3_Shift+AnyOf(all,extraneous) { ... };
+
+ Previously, extraneous (and further) was ignored. Now it's rejected.
+
+- Correctly handle capitalization of the ssharp keysym.
+
+- Speed up and improve the internal `xkeyboard-config` tool. This tool
+ compiles all layout/variant combinations in the xkeyboard-config dataset
+ and reports any issues it finds.
+
+ Contributed by Peter Hutterer <@who-t.net>.
+
+- Speed up "atoms" (string interning). This code goes back at least to X11R1
+ (released 1987).
+
+
+libxkbcommon 0.9.1 - 2019-10-19
+==================
+
+- Fix context creation failing when run in privileged processes as defined by
+ `secure_getenv(3)`, e.g. GDM.
+
+
+libxkbcommon 0.9.0 - 2019-10-19
+==================
+
+- Move ~/.xkb to before XKB_CONFIG_ROOT (the system XKB path, usually
+ /usr/share/X11/xkb) in the default include path. This enables the user
+ to have full control of the keymap definitions, instead of only augmenting
+ them.
+
+- Remove the Autotools build system. Use the meson build system instead.
+
+- Fix invalid names used for levels above 8 when dumping keymaps. Previously,
+ e.g. "Level20" was dumped, but only up to "Level8" is accepted by the
+ parser. Now "20" is dumped.
+
+- Change level references to always be dumped as e.g. "5" instead of "Level5".
+
+ Change group references to always be dumped capitalized e.g. "Group3" instead
+ of "group3". Previously it was inconsistent.
+
+ These changes affect the output of xkb_keymap_get_as_string().
+
+- Fix several build issues on macOS/Darwin, Solaris, NetBSD, cross compilation.
+
+- Port the interactive-wayland test program to the stable version of xdg-shell.
+
+
+libxkbcommon 0.8.4 - 2019-02-22
+==================
+
+- Fix build of xkbcommon-x11 static library with meson.
+
+- Fix building using meson from the tarball generated by autotools.
+
+