keysymdef.h: Improve doc on deprecated keysyms

The documentation on deprecated keysyms lacks precision for two cases,
which are fixed by this commit:

- Explicit aliases (comment: “alias for XXX”) are not deprecated.
- A keysym can be explicitly deprecated by starting its comment with
  “deprecated”.
This commit is contained in:
Pierre Le Marre 2023-07-19 18:50:20 +02:00
parent 4b673589d6
commit 7bc5178139
No known key found for this signature in database
GPG key ID: 3BFB00E5C59E818E

View file

@ -81,8 +81,15 @@ SOFTWARE.
* existing legacy keysym values in the range 0x0100 to 0x20ff.
*
* Where several mnemonic names are defined for the same keysym in this
* file, all but the first one listed should be considered deprecated.
* file, all but the first one listed should be considered deprecated,
* unless the comment explicitly states the alias, e.g.:
*
* #define XK_dead_tilde 0xfe53
* #define XK_dead_perispomeni 0xfe53 // alias for dead_tilde
*
* Additionally, a keysym can be explicitly deprecated by starting the
* comment with "deprecated".
*
* Mnemonic names for keysyms are defined in this file with lines
* that match one of these Perl regular expressions:
*