Signed-off-by: Ran Benita <ran@unusedvar.com>

Prepare for 1.7.0

Signed-off-by: Ran Benita <ran@unusedvar.com>

We accidentally ignored the variant index and used the layout index instead.
In realistic rules they are always the same but don't have to be.

- Add a diagram to illustrate how key types work.
- Add examples to explain the key types mappings.
- Add note for using `preserve` to tweak shortcuts.
- Improve the key statement section.

Straight apostrophe `'` and straight quotations marks `"` are typewriter
legacy and should only be used in programming.

apostrophe

On macOS, it seems to be responsible for the following error in the CI:

```
_XSERVTransmkdir: ERROR: euid != 0,directory /tmp/.X11-unix will not be created.
```

Xvfb wrapper: adapt ELF custom section to macOS.

With the current setup, the tests passes even if there is an issue with
the setup. X11 tests are already guarded with `enable-x11=true`, so
there is no reason to skip these tests if we built the X11 support.

Meson supports the GNU convention for exit code in tests:

- 77: test skipped; already used in xkbcommon: `SKIP_TEST`.
- 99: hard error/setup failure; introduced in this commit:
  `TEST_SETUP_FAILURE`.

Meson reports setup failure as `ERROR`, while a test failure is reported
as `FAIL`. In both cases it will make the CI fail, allowing us to
correctly detect any errors.

Fixed:
- Use `TEST_SETUP_FAILURE` instead of `SKIP_TEST` for X11 setup
  failures.
- Xvfb wrapper: Add verbosity for debugging.

It requires to install `xkeyboardconfig` and `xorg-server`.

XQuartz cask was tested but did not work.

Install meson and pyyaml via brew, as this the standard way on macOS.

Remove Doxygen and Graphviz dependencies, as we do not build
documentation by default anymore.

Signed-off-by: Rui Chen <rui@chenrui.dev>

Signed-off-by: Rui Chen <rui@chenrui.dev>

Signed-off-by: Rui Chen <rui@chenrui.dev>

The only docs we build is the doxygen API and I reckon there's a near-zero
amount of users who actually want these built locally instead of just browsing
the online doc.

Let's not build this by default, dropping the requirement on doxygen and
speeding up the build by quite a fair bit.

Towncrier is a utility to produce useful, summarized news files.

See:
- https://pypi.org/project/towncrier/
- https://towncrier.readthedocs.io

Custom configuration for xkbcommon:
- New fragments are located in the `changes` directory.
- 3 sections:
  - API: `changes/api`
  - Tools: `changes/tools`
  - Build System: `changes/build`
- 3 news fragments:
  - Breaking changes: `.breaking`
  - New: `.feature`
  - Fixes: `.bugfix`

`NEWS` is renamed to `NEWS.md` because the tool requires `.md`
extension to write in markdown format.

`xkb_keysym_from_name` has inconsistent behavior when used with the flag
`XKB_KEYSYM_CASE_INSENSITIVE`:

```c
xkb_keysym_from_name("a", XKB_KEYSYM_CASE_INSENSITIVE) == XKB_KEY_a;
xkb_keysym_from_name("A", XKB_KEYSYM_CASE_INSENSITIVE) == XKB_KEY_a;
xkb_keysym_from_name("dead_a", XKB_KEYSYM_CASE_INSENSITIVE) == XKB_KEY_dead_A;
xkb_keysym_from_name("dead_A", XKB_KEYSYM_CASE_INSENSITIVE) == XKB_KEY_dead_A;
xkb_keysym_from_name("dead_o", XKB_KEYSYM_CASE_INSENSITIVE) == XKB_KEY_dead_o;
xkb_keysym_from_name("dead_O", XKB_KEYSYM_CASE_INSENSITIVE) == XKB_KEY_dead_o;
xkb_keysym_from_name("KANA_tsu", XKB_KEYSYM_CASE_INSENSITIVE) == XKB_KEY_kana_tsu;
xkb_keysym_from_name("KANA_TSU", XKB_KEYSYM_CASE_INSENSITIVE) == XKB_KEY_kana_tsu;
xkb_keysym_from_name("KANA_ya", XKB_KEYSYM_CASE_INSENSITIVE) == XKB_KEY_kana_YA;
xkb_keysym_from_name("KANA_YA", XKB_KEYSYM_CASE_INSENSITIVE) == XKB_KEY_kana_YA;
xkb_keysym_from_name("XF86Screensaver", XKB_KEYSYM_CASE_INSENSITIVE) == X...

We avoid this header due to its locale dependence. This include seems
like a leftover in 44029221.

Signed-off-by: Ran Benita <ran@unusedvar.com>

Do not accept statements like garbage.level_name in types files

Fix parser accepting clearly nonsensical type definitions like

type "ONE_LEVEL" {
    garbage.modifiers = None;
    garbage.map[None] = Level1;
    garbage.level_name[Level1] = "Any";
};

and ignoring the garbage part.

Co-authored-by: Mikhail Gusarov <dottedmag@dottedmag.net>
Co-authored-by: Pierre Le Marre <dev@wismill.eu>

- Simplify error handling.
- Improve error message: add message ID and relevant
  quotes and try to standardize a bit.
- Add proper doc for in the message registry.

Note: Instead of testing the value of `expr.op`, we test if the argument
`elem` of `ExprResolveLhs` is set: this allows us to catch also the
error with `x.y[z]` rather than just `x.y` as previously.

It seems an error originating from 00e3058e.
Probably an unfortunate Git rebase or so.

- Add introduction to keymap and its components
- Add a diagram to explain the relationships between RMLVO and KcCGST.
- Add keywords & comments sections.
- Improve Quick guide section in the index page.
- Add links to User-configuration page.
- Fix typos.

with lld 1.17, linking with a symbol map which contains symbols which actually do not exists now result in an error, which means the test in meson.build to check if -Wl,--version-script works always fails. because it tries to use the general map file with "int main(void) {}".

Fixes #424 

Currently it only ensure we do not buffer `stdout`.

Hook this into test_create_context() so all the test immediately use it.

Makes it easier to debug modifier bugs.

Print the op too to make it easier to find which part in a long test_key_seq
triggered an assertion and add some whitespace for nicer debugging output.