From 700ec23bd465fa74828ffd6dfbc42dfc81731510 Mon Sep 17 00:00:00 2001 From: Jules Aguillon Date: Sun, 29 Sep 2024 22:05:54 +0200 Subject: Improve Ctrl key labels for Serbian Cyrillic layout Add the ':char' syntax for defining character keys with a different symbol. This new kind of keys is used to implement Ctrl combinations in the Serbian Cyrillic layout without showing latin letters while the Ctrl modifier is activated. --- doc/Possible-key-values.md | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/Possible-key-values.md b/doc/Possible-key-values.md index c420f8d..e6a1ddd 100644 --- a/doc/Possible-key-values.md +++ b/doc/Possible-key-values.md @@ -161,8 +161,8 @@ Where `` is one of the kinds documented below and `` is a space separated list of attributes. `` depends on the ``. Attributes are: -- `symbol='Sym'` is the symbol to be shown on the keyboard. -- `flags=''` is a collection of flags that change the behavior of the key. +- `symbol='Sym'` specifies the symbol to be shown on the keyboard. +- `flags=''` changes the behavior of the key. `` is a coma separated list of: + `dim`: Make the symbol dimmer. + `small`: Make the symbol smaller. @@ -172,4 +172,18 @@ Attributes are: Defines a key that outputs an arbitrary string. `` is a string wrapped in single-quotes (`'`), escaping of other single quotes is allowed with `\'`. -For example: `:str symbol='Sym':'Output string'` +For example: +- `:str:'Arbitrary string with a \' inside'` +- `:str symbol='Symbol':'Output string'` + +### Kind `char` + +Defines a key that outputs a single character. `` is the character to +output, unquoted. +This kind of key can be used to define a character key with a different symbol +on it. `char` keys can be modified by `ctrl` and other modifiers, unlike `str` +keys. + +For example: +- `:char symbol='q':љ`, which is used to implement `ctrl` shortcuts in cyrillic + layouts. -- cgit v1.2.3