diff options
author | Ran Benita <ran@unusedvar.com> | 2021-02-27 22:38:21 +0200 |
---|---|---|
committer | Ran Benita <ran@unusedvar.com> | 2021-02-27 22:38:21 +0200 |
commit | 83e3a53ddc4bb870868c1e1ddaeb2e77d9f2b0b0 (patch) | |
tree | bfb85ced0c8e72bf64a57db88fa3de696db75046 /doc | |
parent | afc5370c8638a3157f05a3cdea8452c545d1f44f (diff) | |
download | xorg-lib-libxkbcommon-83e3a53ddc4bb870868c1e1ddaeb2e77d9f2b0b0.tar.gz |
doc: add keymap-format-text-v1.md to the HTML documentation
It's incomplete but might be helpful for someone.
Signed-off-by: Ran Benita <ran@unusedvar.com>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/keymap-format-text-v1.md | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/doc/keymap-format-text-v1.md b/doc/keymap-format-text-v1.md index 9595cff..8726947 100644 --- a/doc/keymap-format-text-v1.md +++ b/doc/keymap-format-text-v1.md @@ -3,6 +3,12 @@ This document describes the `XKB_KEYMAP_FORMAT_TEXT_V1` keymap format, as implemented by libxkbcommon. +NOTE: This document is ever incomplete. Some additional resources are: + +- [Ivan Pascal's XKB documentation](https://web.archive.org/web/20190724015820/http://pascal.tsu.ru/en/xkb/) +- [An Unreliable Guide to XKB Configuration](https://www.charvolant.org/doug/xkb/html/index.html) +- [ArchWiki XKB page](https://wiki.archlinux.org/index.php/X_keyboard_extension) + A keymap consists of a single top-level `xkb_keymap` block, underwhich are nested the following sections. @@ -26,7 +32,7 @@ assign them the names `TLDE` and `AE01` respectively. The format `<WXYZ>` is always used to refer to a key by name. [The naming convention `<AE01>` just denotes the position of the key -in the main alphanumric section of a standard QWERTY keyboard, with +in the main alphanumeric section of a standard QWERTY keyboard, with the two letters specifying the row and the two digits specifying the column, from the bottom left.] @@ -69,7 +75,7 @@ section and by the user. ## The `xkb_types` section -This section is the second to be processesed, after `xkb_keycodes`. +This section is the second to be processed, after `xkb_keycodes`. However, it is completely independent and could have been the first to be processed (it does not refer to specific keys as specified in the `xkb_keycodes` section). @@ -299,7 +305,7 @@ statements: If the given modifiers are in the required state (see below), the LED is lit. -#### `whichModState` statment +#### `whichModState` statement whichModState = Latched+Locked; |