doc: add some disclaimer regarding user-specific key types and compat entries

It's a niche use-case but basically the same as adding symbols, so let's go with
a general handwavy explanation.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
master
Peter Hutterer 2020-08-26 15:47:51 +10:00 committed by Ran Benita
parent d00cf64dbc
commit ae90a6a0a9
1 changed files with 9 additions and 0 deletions

View File

@ -31,6 +31,15 @@ Each directory should have one or more of the following subdirectories:
- `symbols` - `symbols`
- `types` - `types`
The majority of user-specific configuration involve modifying key symbols and
this is what this document focuses on. For use-cases where a user may need to
add new key types or compat entries the general approach remains the same. A
detailed description for how to add those types or compat entries is out of
scope for this document.
You should never need to add user-specific keycodes. Where a keycode is missing,
the addition should be filed in the upstream xkeyboard-config project.
## RMLVO vs KcCGST ## RMLVO vs KcCGST
Due to how XKB is configured, there is no such thing as a "layout" in XKB Due to how XKB is configured, there is no such thing as a "layout" in XKB