~ruther/qmk_firmware

435a1202e7575dba61bb9a48070ddc90ccda2993 — fauxpark 7 years ago 3e8f272
More improvements to keycode docs (#3567)

* Reorder keycode list docs according to HID usage

* Add missing keycodes/descriptions/aliases
3 files changed, 324 insertions(+), 288 deletions(-)

M docs/keycodes.md
M docs/keycodes_basic.md
M docs/keycodes_us_ansi_shifted.md
M docs/keycodes.md => docs/keycodes.md +141 -128
@@ 8,40 8,8 @@ This is a reference only. Each group of keys links to the page documenting their

|Key                    |Aliases             |Description                                    |
|-----------------------|--------------------|-----------------------------------------------|
|`KC_1`                 |                    |`1` and `!`                                    |
|`KC_2`                 |                    |`2` and `@`                                    |
|`KC_3`                 |                    |`3` and `#`                                    |
|`KC_4`                 |                    |`4` and `$`                                    |
|`KC_5`                 |                    |`5` and `%`                                    |
|`KC_6`                 |                    |`6` and `^`                                    |
|`KC_7`                 |                    |`7` and `&`                                    |
|`KC_8`                 |                    |`8` and `*`                                    |
|`KC_9`                 |                    |`9` and `(`                                    |
|`KC_0`                 |                    |`0` and `)`                                    |
|`KC_F1`                |                    |                                               |
|`KC_F2`                |                    |                                               |
|`KC_F3`                |                    |                                               |
|`KC_F4`                |                    |                                               |
|`KC_F5`                |                    |                                               |
|`KC_F6`                |                    |                                               |
|`KC_F7`                |                    |                                               |
|`KC_F8`                |                    |                                               |
|`KC_F9`                |                    |                                               |
|`KC_F10`               |                    |                                               |
|`KC_F11`               |                    |                                               |
|`KC_F12`               |                    |                                               |
|`KC_F13`               |                    |                                               |
|`KC_F14`               |                    |                                               |
|`KC_F15`               |                    |                                               |
|`KC_F16`               |                    |                                               |
|`KC_F17`               |                    |                                               |
|`KC_F18`               |                    |                                               |
|`KC_F19`               |                    |                                               |
|`KC_F20`               |                    |                                               |
|`KC_F21`               |                    |                                               |
|`KC_F22`               |                    |                                               |
|`KC_F23`               |                    |                                               |
|`KC_F24`               |                    |                                               |
|`KC_NO`                |`XXXXXXX`           |Ignore this key (NOOP)                         |
|`KC_TRANSPARENT`       |`KC_TRNS`, `_______`|Use the next lowest non-transparent key        |
|`KC_A`                 |                    |`a` and `A`                                    |
|`KC_B`                 |                    |`b` and `B`                                    |
|`KC_C`                 |                    |`c` and `C`                                    |


@@ 68,6 36,16 @@ This is a reference only. Each group of keys links to the page documenting their
|`KC_X`                 |                    |`x` and `X`                                    |
|`KC_Y`                 |                    |`y` and `Y`                                    |
|`KC_Z`                 |                    |`z` and `Z`                                    |
|`KC_1`                 |                    |`1` and `!`                                    |
|`KC_2`                 |                    |`2` and `@`                                    |
|`KC_3`                 |                    |`3` and `#`                                    |
|`KC_4`                 |                    |`4` and `$`                                    |
|`KC_5`                 |                    |`5` and `%`                                    |
|`KC_6`                 |                    |`6` and `^`                                    |
|`KC_7`                 |                    |`7` and `&`                                    |
|`KC_8`                 |                    |`8` and `*`                                    |
|`KC_9`                 |                    |`9` and `(`                                    |
|`KC_0`                 |                    |`0` and `)`                                    |
|`KC_ENTER`             |`KC_ENT`            |Return (Enter)                                 |
|`KC_ESCAPE`            |`KC_ESC`            |Escape                                         |
|`KC_BSPACE`            |`KC_BSPC`           |Delete (Backspace)                             |


@@ 79,33 57,28 @@ This is a reference only. Each group of keys links to the page documenting their
|`KC_RBRACKET`          |`KC_RBRC`           |`]` and `}`                                    |
|`KC_BSLASH`            |`KC_BSLS`           |`\` and <code>&#124;</code>                    |
|`KC_NONUS_HASH`        |`KC_NUHS`           |Non-US `#` and `~`                             |
|`KC_NONUS_BSLASH`      |`KC_NUBS`           |Non-US `\` and <code>&#124;</code>             |
|`KC_INT1`              |`KC_RO`             |JIS `\` and <code>&#124;</code>                |
|`KC_INT2`              |`KC_KANA`           |JIS Katakana/Hiragana                          |
|`KC_INT3`              |`KC_JYEN`           |JIS `¥`                                        |
|`KC_SCOLON`            |`KC_SCLN`           |`;` and `:`                                    |
|`KC_QUOTE`             |`KC_QUOT`           |`'` and `"`                                    |
|`KC_GRAVE`             |`KC_GRV`            |<code>&#96;</code> and `~`                     |
|`KC_GRAVE`             |`KC_GRV`, `KC_ZKHK` |<code>&#96;</code> and `~`, JIS Zenkaku/Hankaku|
|`KC_COMMA`             |`KC_COMM`           |`,` and `<`                                    |
|`KC_DOT`               |                    |`.` and `>`                                    |
|`KC_SLASH`             |`KC_SLSH`           |`/` and `?`                                    |
|`KC_CAPSLOCK`          |`KC_CAPS`           |Caps Lock                                      |
|`KC_LCTRL`             |`KC_LCTL`           |Left Control                                   |
|`KC_LSHIFT`            |`KC_LSFT`           |Left Shift                                     |
|`KC_LALT`              |                    |Left Alt                                       |
|`KC_LGUI`              |`KC_LCMD`, `KC_LWIN`|Left GUI (Windows/Command/Meta key)            |
|`KC_RCTRL`             |`KC_RCTL`           |Right Control                                  |
|`KC_RSHIFT`            |`KC_RSFT`           |Right Shift                                    |
|`KC_RALT`              |                    |Right Alt                                      |
|`KC_RGUI`              |`KC_RCMD`, `KC_RWIN`|Right GUI (Windows/Command/Meta key)           |
|`KC_LOCKING_CAPS`      |`KC_LCAP`           |Locking Caps Lock                              |
|`KC_LOCKING_NUM`       |`KC_LNUM`           |Locking Num Lock                               |
|`KC_LOCKING_SCROLL`    |`KC_LSCR`           |Locking Scroll Lock                            |
|`KC_INT4`              |`KC_HENK`           |JIS Henkan                                     |
|`KC_INT5`              |`KC_MHEN`           |JIS Muhenkan                                   |
|`KC_CAPSLOCK`          |`KC_CLCK`, `KC_CAPS`|Caps Lock                                      |
|`KC_F1`                |                    |F1                                             |
|`KC_F2`                |                    |F2                                             |
|`KC_F3`                |                    |F3                                             |
|`KC_F4`                |                    |F4                                             |
|`KC_F5`                |                    |F5                                             |
|`KC_F6`                |                    |F6                                             |
|`KC_F7`                |                    |F7                                             |
|`KC_F8`                |                    |F8                                             |
|`KC_F9`                |                    |F9                                             |
|`KC_F10`               |                    |F10                                            |
|`KC_F11`               |                    |F11                                            |
|`KC_F12`               |                    |F12                                            |
|`KC_PSCREEN`           |`KC_PSCR`           |Print Screen                                   |
|`KC_SCROLLLOCK`        |`KC_SLCK`           |Scroll Lock                                    |
|`KC_PAUSE`             |`KC_PAUS`           |Pause                                          |
|`KC_PAUSE`             |`KC_PAUS`, `KC_BRK` |Pause                                          |
|`KC_INSERT`            |`KC_INS`            |Insert                                         |
|`KC_HOME`              |                    |Home                                           |
|`KC_PGUP`              |                    |Page Up                                        |


@@ 116,22 89,80 @@ This is a reference only. Each group of keys links to the page documenting their
|`KC_LEFT`              |                    |Left Arrow                                     |
|`KC_DOWN`              |                    |Down Arrow                                     |
|`KC_UP`                |                    |Up Arrow                                       |
|`KC_NUMLOCK`           |`KC_NLCK`           |Keypad Num Lock and Clear                      |
|`KC_KP_SLASH`          |`KC_PSLS`           |Keypad `/`                                     |
|`KC_KP_ASTERISK`       |`KC_PAST`           |Keypad `*`                                     |
|`KC_KP_MINUS`          |`KC_PMNS`           |Keypad `-`                                     |
|`KC_KP_PLUS`           |`KC_PPLS`           |Keypad `+`                                     |
|`KC_KP_ENTER`          |`KC_PENT`           |Keypad Enter                                   |
|`KC_KP_1`              |`KC_P1`             |Keypad `1` and End                             |
|`KC_KP_2`              |`KC_P2`             |Keypad `2` and Down Arrow                      |
|`KC_KP_3`              |`KC_P3`             |Keypad `3` and Page Down                       |
|`KC_KP_4`              |`KC_P4`             |Keypad `4` and Left Arrow                      |
|`KC_KP_5`              |`KC_P5`             |Keypad `5`                                     |
|`KC_KP_6`              |`KC_P6`             |Keypad `6` and Right Arrow                     |
|`KC_KP_7`              |`KC_P7`             |Keypad `7` and Home                            |
|`KC_KP_8`              |`KC_P8`             |Keypad `8` and Up Arrow                        |
|`KC_KP_9`              |`KC_P9`             |Keypad `9` and Page Up                         |
|`KC_KP_0`              |`KC_P0`             |Keypad `0` and Insert                          |
|`KC_KP_DOT`            |`KC_PDOT`           |Keypad `.` and Delete                          |
|`KC_NONUS_BSLASH`      |`KC_NUBS`           |Non-US `\` and <code>&#124;</code>             |
|`KC_APPLICATION`       |`KC_APP`            |Application (Windows Menu Key)                 |
|`KC_POWER`             |                    |Deprecated by MS in favor of `KC_SYSTEM_POWER`.|
|`KC_EXECUTE`           |                    |Execute                                        |
|`KC_POWER`             |                    |System Power (macOS)                           |
|`KC_KP_EQUAL`          |`KC_PEQL`           |Keypad `=`                                     |
|`KC_F13`               |                    |F13                                            |
|`KC_F14`               |                    |F14                                            |
|`KC_F15`               |                    |F15                                            |
|`KC_F16`               |                    |F16                                            |
|`KC_F17`               |                    |F17                                            |
|`KC_F18`               |                    |F18                                            |
|`KC_F19`               |                    |F19                                            |
|`KC_F20`               |                    |F20                                            |
|`KC_F21`               |                    |F21                                            |
|`KC_F22`               |                    |F22                                            |
|`KC_F23`               |                    |F23                                            |
|`KC_F24`               |                    |F24                                            |
|`KC_EXECUTE`           |`KC_EXEC`           |Execute                                        |
|`KC_HELP`              |                    |Help                                           |
|`KC_MENU`              |                    |Menu                                           |
|`KC_SELECT`            |                    |Select                                         |
|`KC_AGAIN`             |                    |Again                                          |
|`KC_SELECT`            |`KC_SLCT`           |Select                                         |
|`KC_STOP`              |                    |Stop                                           |
|`KC_AGAIN`             |`KC_AGIN`           |Again                                          |
|`KC_UNDO`              |                    |Undo                                           |
|`KC_CUT`               |                    |Cut                                            |
|`KC_COPY`              |                    |Copy                                           |
|`KC_PASTE`             |                    |Paste                                          |
|`KC_PASTE`             |`KC_PSTE`           |Paste                                          |
|`KC_FIND`              |                    |Find                                           |
|`KC_ALT_ERASE`         |                    |Alternate Erase                                |
|`KC__MUTE`             |                    |Mute (macOS)                                   |
|`KC__VOLUP`            |                    |Volume Up (macOS)                              |
|`KC__VOLDOWN`          |                    |Volume Down (macOS)                            |
|`KC_LOCKING_CAPS`      |`KC_LCAP`           |Locking Caps Lock                              |
|`KC_LOCKING_NUM`       |`KC_LNUM`           |Locking Num Lock                               |
|`KC_LOCKING_SCROLL`    |`KC_LSCR`           |Locking Scroll Lock                            |
|`KC_KP_COMMA`          |`KC_PCMM`           |Keypad `,`                                     |
|`KC_KP_EQUAL_AS400`    |                    |Keypad `=` on AS/400 keyboards                 |
|`KC_INT1`              |`KC_RO`             |JIS `\` and <code>&#124;</code>                |
|`KC_INT2`              |`KC_KANA`           |JIS Katakana/Hiragana                          |
|`KC_INT3`              |`KC_JYEN`           |JIS `¥`                                        |
|`KC_INT4`              |`KC_HENK`           |JIS Henkan                                     |
|`KC_INT5`              |`KC_MHEN`           |JIS Muhenkan                                   |
|`KC_INT6`              |                    |JIS Numpad `,`                                 |
|`KC_INT7`              |                    |International 7                                |
|`KC_INT8`              |                    |International 8                                |
|`KC_INT9`              |                    |International 9                                |
|`KC_LANG1`             |`KC_HAEN`           |Hangul/English                                 |
|`KC_LANG2`             |`KC_HANJ`           |Hanja                                          |
|`KC_LANG3`             |                    |JIS Katakana                                   |
|`KC_LANG4`             |                    |JIS Hiragana                                   |
|`KC_LANG5`             |                    |JIS Zenkaku/Hankaku                            |
|`KC_LANG6`             |                    |Language 6                                     |
|`KC_LANG7`             |                    |Language 7                                     |
|`KC_LANG8`             |                    |Language 8                                     |
|`KC_LANG9`             |                    |Language 9                                     |
|`KC_ALT_ERASE`         |`KC_ERAS`           |Alternate Erase                                |
|`KC_SYSREQ`            |                    |SysReq/Attention                               |
|`KC_CANCEL`            |                    |Cancel                                         |
|`KC_CLEAR`             |                    |Clear                                          |
|`KC_CLEAR`             |`KC_CLR`            |Clear                                          |
|`KC_PRIOR`             |                    |Prior                                          |
|`KC_RETURN`            |                    |Return                                         |
|`KC_SEPARATOR`         |                    |Separator                                      |


@@ 140,56 171,38 @@ This is a reference only. Each group of keys links to the page documenting their
|`KC_CLEAR_AGAIN`       |                    |Clear/Again                                    |
|`KC_CRSEL`             |                    |CrSel/Props                                    |
|`KC_EXSEL`             |                    |ExSel                                          |
|`KC_SYSTEM_POWER`      |`KC_PWR`            |System Power Down. Recommended over `KC_POWER`.|
|`KC_LCTRL`             |`KC_LCTL`           |Left Control                                   |
|`KC_LSHIFT`            |`KC_LSFT`           |Left Shift                                     |
|`KC_LALT`              |                    |Left Alt                                       |
|`KC_LGUI`              |`KC_LCMD`, `KC_LWIN`|Left GUI (Windows/Command/Meta key)            |
|`KC_RCTRL`             |`KC_RCTL`           |Right Control                                  |
|`KC_RSHIFT`            |`KC_RSFT`           |Right Shift                                    |
|`KC_RALT`              |                    |Right Alt                                      |
|`KC_RGUI`              |`KC_RCMD`, `KC_RWIN`|Right GUI (Windows/Command/Meta key)           |
|`KC_SYSTEM_POWER`      |`KC_PWR`            |System Power Down                              |
|`KC_SYSTEM_SLEEP`      |`KC_SLEP`           |System Sleep                                   |
|`KC_SYSTEM_WAKE`       |`KC_WAKE`           |System Wake                                    |
|`KC_MAIL`              |`KC_MAIL`           |                                               |
|`KC_CALCULATOR`        |`KC_CALC`           |                                               |
|`KC_MY_COMPUTER`       |`KC_MYCM`           |                                               |
|`KC_WWW_SEARCH`        |`KC_WSCH`           |                                               |
|`KC_WWW_HOME`          |`KC_WHOM`           |                                               |
|`KC_WWW_BACK`          |`KC_WBAK`           |                                               |
|`KC_WWW_FORWARD`       |`KC_WFWD`           |                                               |
|`KC_WWW_STOP`          |`KC_WSTP`           |                                               |
|`KC_WWW_REFRESH`       |`KC_WREF`           |                                               |
|`KC_WWW_FAVORITES`     |`KC_WFAV`           |                                               |
|`KC_STOP`              |                    |Stop                                           |
|`KC__MUTE`             |                    |Mute (macOS)                                   |
|`KC__VOLUP`            |                    |Volume Up (macOS)                              |
|`KC__VOLDOWN`          |                    |Volume Down (macOS)                            |
|`KC_AUDIO_MUTE`        |`KC_MUTE`           |Mute (Windows/macOS/Linux)                     |
|`KC_AUDIO_VOL_UP`      |`KC_VOLU`           |Volume Up (Windows/macOS/Linux)                |
|`KC_AUDIO_VOL_DOWN`    |`KC_VOLD`           |Volume Down (Windows/macOS/Linux)              |
|`KC_AUDIO_MUTE`        |`KC_MUTE`           |Mute                                           |
|`KC_AUDIO_VOL_UP`      |`KC_VOLU`           |Volume Up                                      |
|`KC_AUDIO_VOL_DOWN`    |`KC_VOLD`           |Volume Down                                    |
|`KC_MEDIA_NEXT_TRACK`  |`KC_MNXT`           |Next Track (Windows)                           |
|`KC_MEDIA_PREV_TRACK`  |`KC_MPRV`           |Previous Track (Windows)                       |
|`KC_MEDIA_FAST_FORWARD`|`KC_MFFD`           |Next Track (macOS)                             |
|`KC_MEDIA_REWIND`      |`KC_MRWD`           |Previous Track (macOS)                         |
|`KC_MEDIA_STOP`        |`KC_MSTP`           |Stop Track                                     |
|`KC_MEDIA_STOP`        |`KC_MSTP`           |Stop Track (Windows)                           |
|`KC_MEDIA_PLAY_PAUSE`  |`KC_MPLY`           |Play/Pause Track                               |
|`KC_MEDIA_SELECT`      |`KC_MSEL`           |                                               |
|`KC_MEDIA_SELECT`      |`KC_MSEL`           |Launch Media Player (Windows)                  |
|`KC_MEDIA_EJECT`       |`KC_EJCT`           |Eject (macOS)                                  |
|`KC_NUMLOCK`           |`KC_NLCK`           |Keypad Num Lock and Clear                      |
|`KC_KP_SLASH`          |`KC_PSLS`           |Keypad `/`                                     |
|`KC_KP_ASTERISK`       |`KC_PAST`           |Keypad `*`                                     |
|`KC_KP_MINUS`          |`KC_PMNS`           |Keypad `-`                                     |
|`KC_KP_PLUS`           |`KC_PPLS`           |Keypad `+`                                     |
|`KC_KP_ENTER`          |`KC_PENT`           |Keypad Enter                                   |
|`KC_KP_1`              |`KC_P1`             |Keypad `1` and End                             |
|`KC_KP_2`              |`KC_P2`             |Keypad `2` and Down Arrow                      |
|`KC_KP_3`              |`KC_P3`             |Keypad `3` and Page Down                       |
|`KC_KP_4`              |`KC_P4`             |Keypad `4` and Left Arrow                      |
|`KC_KP_5`              |`KC_P5`             |Keypad `5`                                     |
|`KC_KP_6`              |`KC_P6`             |Keypad `6` and Right Arrow                     |
|`KC_KP_7`              |`KC_P7`             |Keypad `7` and Home                            |
|`KC_KP_8`              |`KC_P8`             |Keypad `8` and Up Arrow                        |
|`KC_KP_9`              |`KC_P9`             |Keypad `9` and Page Up                         |
|`KC_KP_0`              |`KC_P0`             |Keypad `0` and Insert                          |
|`KC_KP_DOT`            |`KC_PDOT`           |Keypad `.` and Delete                          |
|`KC_KP_EQUAL`          |`KC_PEQL`           |Keypad `=`                                     |
|`KC_KP_COMMA`          |`KC_PCMM`           |Keypad `,`                                     |
|`KC_KP_EQUAL_AS400`    |                    |Keypad `=` on AS/400 keyboards                 |
|`KC_NO`                |                    |Ignore this key (NOOP)                         |
|`KC_TRANSPARENT`       |`KC_TRNS`           |Use the next lowest non-transparent key        |
|`KC_MAIL`              |                    |Launch Mail (Windows)                          |
|`KC_CALCULATOR`        |`KC_CALC`           |Launch Calculator (Windows)                    |
|`KC_MY_COMPUTER`       |`KC_MYCM`           |Launch My Computer (Windows)                   |
|`KC_WWW_SEARCH`        |`KC_WSCH`           |Browser Search (Windows)                       |
|`KC_WWW_HOME`          |`KC_WHOM`           |Browser Home (Windows)                         |
|`KC_WWW_BACK`          |`KC_WBAK`           |Browser Back (Windows)                         |
|`KC_WWW_FORWARD`       |`KC_WFWD`           |Browser Forward (Windows)                      |
|`KC_WWW_STOP`          |`KC_WSTP`           |Browser Stop (Windows)                         |
|`KC_WWW_REFRESH`       |`KC_WREF`           |Browser Refresh (Windows)                      |
|`KC_WWW_FAVORITES`     |`KC_WFAV`           |Browser Favorites (Windows)                    |
|`KC_MEDIA_FAST_FORWARD`|`KC_MFFD`           |Next Track (macOS)                             |
|`KC_MEDIA_REWIND`      |`KC_MRWD`           |Previous Track (macOS)                         |

## [Quantum Keycodes](quantum_keycodes.md#qmk-keycodes)



@@ 391,29 404,29 @@ This is a reference only. Each group of keys links to the page documenting their

## [US ANSI Shifted Keys](keycodes_us_ansi_shifted.md)

|Key                     |Aliases           |Description        |
|------------------------|------------------|-------------------|
|`KC_TILDE`              |`KC_TILD`         |`~`                |
|`KC_EXCLAIM`            |`KC_EXLM`         |`!`                |
|`KC_AT`                 |                  |`@`                |
|`KC_HASH`               |                  |`#`                |
|`KC_DOLLAR`             |`KC_DLR`          |`$`                |
|`KC_PERCENT`            |`KC_PERC`         |`%`                |
|`KC_CIRCUMFLEX`         |`KC_CIRC`         |`^`                |
|`KC_AMPERSAND`          |`KC_AMPR`         |`&`                |
|`KC_ASTERISK`           |`KC_ASTR`         |`*`                |
|`KC_LEFT_PAREN`         |`KC_LPRN`         |`(`                |
|`KC_RIGHT_PAREN`        |`KC_RPRN`         |`)`                |
|`KC_UNDERSCORE`         |`KC_UNDS`         |`_`                |
|`KC_PLUS`               |                  |`+`                |
|`KC_LEFT_CURLY_BRACE`   |`KC_LCBR`         |`{`                |
|`KC_RIGHT_CURLY_BRACE`  |`KC_RCBR`         |`}`                |
|`KC_PIPE`               |                  |<code>&#124;</code>|
|`KC_COLON`              |`KC_COLN`         |`:`                |
|`KC_DOUBLE_QUOTE`       |`KC_DQT`/`KC_DQUO`|`"`                |
|`KC_LEFT_ANGLE_BRACKET` |`KC_LT`/`KC_LABK` |`<`                |
|`KC_RIGHT_ANGLE_BRACKET`|`KC_GT`/`KC_RABK` |`>`                |
|`KC_QUESTION`           |`KC_QUES`         |`?`                |
|Key                     |Aliases            |Description        |
|------------------------|-------------------|-------------------|
|`KC_TILDE`              |`KC_TILD`          |`~`                |
|`KC_EXCLAIM`            |`KC_EXLM`          |`!`                |
|`KC_AT`                 |                   |`@`                |
|`KC_HASH`               |                   |`#`                |
|`KC_DOLLAR`             |`KC_DLR`           |`$`                |
|`KC_PERCENT`            |`KC_PERC`          |`%`                |
|`KC_CIRCUMFLEX`         |`KC_CIRC`          |`^`                |
|`KC_AMPERSAND`          |`KC_AMPR`          |`&`                |
|`KC_ASTERISK`           |`KC_ASTR`          |`*`                |
|`KC_LEFT_PAREN`         |`KC_LPRN`          |`(`                |
|`KC_RIGHT_PAREN`        |`KC_RPRN`          |`)`                |
|`KC_UNDERSCORE`         |`KC_UNDS`          |`_`                |
|`KC_PLUS`               |                   |`+`                |
|`KC_LEFT_CURLY_BRACE`   |`KC_LCBR`          |`{`                |
|`KC_RIGHT_CURLY_BRACE`  |`KC_RCBR`          |`}`                |
|`KC_PIPE`               |                   |<code>&#124;</code>|
|`KC_COLON`              |`KC_COLN`          |`:`                |
|`KC_DOUBLE_QUOTE`       |`KC_DQUO`, `KC_DQT`|`"`                |
|`KC_LEFT_ANGLE_BRACKET` |`KC_LABK`, `KC_LT` |`<`                |
|`KC_RIGHT_ANGLE_BRACKET`|`KC_RABK`, `KC_GT` |`>`                |
|`KC_QUESTION`           |`KC_QUES`          |`?`                |

## [Switching and Toggling Layers](feature_advanced_keycodes.md#switching-and-toggling-layers)


M docs/keycodes_basic.md => docs/keycodes_basic.md +160 -137
@@ 47,117 47,145 @@ The basic set of keycodes are based on the [HID Keyboard/Keypad Usage Page (0x07

|Key     |Description|
|--------|-----------|
|`KC_F1` |           |
|`KC_F2` |           |
|`KC_F3` |           |
|`KC_F4` |           |
|`KC_F5` |           |
|`KC_F6` |           |
|`KC_F7` |           |
|`KC_F8` |           |
|`KC_F9` |           |
|`KC_F10`|           |
|`KC_F11`|           |
|`KC_F12`|           |
|`KC_F13`|           |
|`KC_F14`|           |
|`KC_F15`|           |
|`KC_F16`|           |
|`KC_F17`|           |
|`KC_F18`|           |
|`KC_F19`|           |
|`KC_F20`|           |
|`KC_F21`|           |
|`KC_F22`|           |
|`KC_F23`|           |
|`KC_F24`|           |
|`KC_F1` |F1         |
|`KC_F2` |F2         |
|`KC_F3` |F3         |
|`KC_F4` |F4         |
|`KC_F5` |F5         |
|`KC_F6` |F6         |
|`KC_F7` |F7         |
|`KC_F8` |F8         |
|`KC_F9` |F9         |
|`KC_F10`|F10        |
|`KC_F11`|F11        |
|`KC_F12`|F12        |
|`KC_F13`|F13        |
|`KC_F14`|F14        |
|`KC_F15`|F15        |
|`KC_F16`|F16        |
|`KC_F17`|F17        |
|`KC_F18`|F18        |
|`KC_F19`|F19        |
|`KC_F20`|F20        |
|`KC_F21`|F21        |
|`KC_F22`|F22        |
|`KC_F23`|F23        |
|`KC_F24`|F24        |

## Punctuation

|Key              |Aliases  |Description                       |
|-----------------|---------|----------------------------------|
|`KC_ENTER`       |`KC_ENT` |Return (Enter)                    |
|`KC_ESCAPE`      |`KC_ESC` |Escape                            |
|`KC_BSPACE`      |`KC_BSPC`|Delete (Backspace)                |
|`KC_TAB`         |         |Tab                               |
|`KC_SPACE`       |`KC_SPC` |Spacebar                          |
|`KC_MINUS`       |`KC_MINS`|`-` and `_`                       |
|`KC_EQUAL`       |`KC_EQL` |`=` and `+`                       |
|`KC_LBRACKET`    |`KC_LBRC`|`[` and `{`                       |
|`KC_RBRACKET`    |`KC_RBRC`|`]` and `}`                       |
|`KC_BSLASH`      |`KC_BSLS`|`\` and <code>&#124;</code>       |
|`KC_NONUS_HASH`  |`KC_NUHS`|Non-US `#` and `~`                |
|`KC_NONUS_BSLASH`|`KC_NUBS`|Non-US `\` and <code>&#124;</code>|
|`KC_INT1`        |`KC_RO`  |JIS `\` and <code>&#124;</code>   |
|`KC_INT2`        |`KC_KANA`|JIS Katakana/Hiragana             |
|`KC_INT3`        |`KC_JYEN`|JIS `¥`                           |
|`KC_SCOLON`      |`KC_SCLN`|`;` and `:`                       |
|`KC_QUOTE`       |`KC_QUOT`|`'` and `"`                       |
|`KC_GRAVE`       |`KC_GRV` |<code>&#96;</code> and `~`        |
|`KC_COMMA`       |`KC_COMM`|`,` and `<`                       |
|`KC_DOT`         |         |`.` and `>`                       |
|`KC_SLASH`       |`KC_SLSH`|`/` and `?`                       |
|`KC_CAPSLOCK`    |`KC_CAPS`|Caps Lock                         |
|Key              |Aliases            |Description                                    |
|-----------------|-------------------|-----------------------------------------------|
|`KC_ENTER`       |`KC_ENT`           |Return (Enter)                                 |
|`KC_ESCAPE`      |`KC_ESC`           |Escape                                         |
|`KC_BSPACE`      |`KC_BSPC`          |Delete (Backspace)                             |
|`KC_TAB`         |                   |Tab                                            |
|`KC_SPACE`       |`KC_SPC`           |Spacebar                                       |
|`KC_MINUS`       |`KC_MINS`          |`-` and `_`                                    |
|`KC_EQUAL`       |`KC_EQL`           |`=` and `+`                                    |
|`KC_LBRACKET`    |`KC_LBRC`          |`[` and `{`                                    |
|`KC_RBRACKET`    |`KC_RBRC`          |`]` and `}`                                    |
|`KC_BSLASH`      |`KC_BSLS`          |`\` and <code>&#124;</code>                    |
|`KC_NONUS_HASH`  |`KC_NUHS`          |Non-US `#` and `~`                             |
|`KC_SCOLON`      |`KC_SCLN`          |`;` and `:`                                    |
|`KC_QUOTE`       |`KC_QUOT`          |`'` and `"`                                    |
|`KC_GRAVE`       |`KC_GRV`, `KC_ZKHK`|<code>&#96;</code> and `~`, JIS Zenkaku/Hankaku|
|`KC_COMMA`       |`KC_COMM`          |`,` and `<`                                    |
|`KC_DOT`         |                   |`.` and `>`                                    |
|`KC_SLASH`       |`KC_SLSH`          |`/` and `?`                                    |
|`KC_NONUS_BSLASH`|`KC_NUBS`          |Non-US `\` and <code>&#124;</code>             |

## Lock Keys

|Key                |Aliases             |Description              |
|-------------------|--------------------|-------------------------|
|`KC_CAPSLOCK`      |`KC_CLCK`, `KC_CAPS`|Caps Lock                |
|`KC_SCROLLLOCK`    |`KC_SLCK`           |Scroll Lock              |
|`KC_NUMLOCK`       |`KC_NLCK`           |Keypad Num Lock and Clear|
|`KC_LOCKING_CAPS`  |`KC_LCAP`           |Locking Caps Lock        |
|`KC_LOCKING_NUM`   |`KC_LNUM`           |Locking Num Lock         |
|`KC_LOCKING_SCROLL`|`KC_LSCR`           |Locking Scroll Lock      |

## Modifiers

|Key                |Aliases             |Description                         |
|-------------------|--------------------|------------------------------------|
|`KC_LCTRL`         |`KC_LCTL`           |Left Control                        |
|`KC_LSHIFT`        |`KC_LSFT`           |Left Shift                          |
|`KC_LALT`          |                    |Left Alt                            |
|`KC_LGUI`          |`KC_LCMD`, `KC_LWIN`|Left GUI (Windows/Command/Meta key) |
|`KC_RCTRL`         |`KC_RCTL`           |Right Control                       |
|`KC_RSHIFT`        |`KC_RSFT`           |Right Shift                         |
|`KC_RALT`          |                    |Right Alt                           |
|`KC_RGUI`          |`KC_RCMD`, `KC_RWIN`|Right GUI (Windows/Command/Meta key)|
|`KC_LOCKING_CAPS`  |`KC_LCAP`           |Locking Caps Lock                   |
|`KC_LOCKING_NUM`   |`KC_LNUM`           |Locking Num Lock                    |
|`KC_LOCKING_SCROLL`|`KC_LSCR`           |Locking Scroll Lock                 |
|`KC_INT4`          |`KC_HENK`           |JIS Henkan                          |
|`KC_INT5`          |`KC_MHEN`           |JIS Muhenkan                        |
|Key        |Aliases             |Description                         |
|-----------|--------------------|------------------------------------|
|`KC_LCTRL` |`KC_LCTL`           |Left Control                        |
|`KC_LSHIFT`|`KC_LSFT`           |Left Shift                          |
|`KC_LALT`  |                    |Left Alt                            |
|`KC_LGUI`  |`KC_LCMD`, `KC_LWIN`|Left GUI (Windows/Command/Meta key) |
|`KC_RCTRL` |`KC_RCTL`           |Right Control                       |
|`KC_RSHIFT`|`KC_RSFT`           |Right Shift                         |
|`KC_RALT`  |                    |Right Alt                           |
|`KC_RGUI`  |`KC_RCMD`, `KC_RWIN`|Right GUI (Windows/Command/Meta key)|

## International

|Key       |Aliases  |Description                    |
|----------|---------|-------------------------------|
|`KC_INT1` |`KC_RO`  |JIS `\` and <code>&#124;</code>|
|`KC_INT2` |`KC_KANA`|JIS Katakana/Hiragana          |
|`KC_INT3` |`KC_JYEN`|JIS `¥`                        |
|`KC_INT4` |`KC_HENK`|JIS Henkan                     |
|`KC_INT5` |`KC_MHEN`|JIS Muhenkan                   |
|`KC_INT6` |         |JIS Numpad `,`                 |
|`KC_INT7` |         |International 7                |
|`KC_INT8` |         |International 8                |
|`KC_INT9` |         |International 9                |
|`KC_LANG1`|`KC_HAEN`|Hangul/English                 |
|`KC_LANG2`|`KC_HANJ`|Hanja                          |
|`KC_LANG3`|         |JIS Katakana                   |
|`KC_LANG4`|         |JIS Hiragana                   |
|`KC_LANG5`|         |JIS Zenkaku/Hankaku            |
|`KC_LANG6`|         |Language 6                     |
|`KC_LANG7`|         |Language 7                     |
|`KC_LANG8`|         |Language 8                     |
|`KC_LANG9`|         |Language 9                     |

## Commands

|Key               |Aliases  |Description                   |
|------------------|---------|------------------------------|
|`KC_PSCREEN`      |`KC_PSCR`|Print Screen                  |
|`KC_SCROLLLOCK`   |`KC_SLCK`|Scroll Lock                   |
|`KC_PAUSE`        |`KC_PAUS`|Pause                         |
|`KC_INSERT`       |`KC_INS` |Insert                        |
|`KC_HOME`         |         |Home                          |
|`KC_PGUP`         |         |Page Up                       |
|`KC_DELETE`       |`KC_DEL` |Forward Delete                |
|`KC_END`          |         |End                           |
|`KC_PGDOWN`       |`KC_PGDN`|Page Down                     |
|`KC_RIGHT`        |`KC_RGHT`|Right Arrow                   |
|`KC_LEFT`         |         |Left Arrow                    |
|`KC_DOWN`         |         |Down Arrow                    |
|`KC_UP`           |         |Up Arrow                      |
|`KC_APPLICATION`  |`KC_APP` |Application (Windows Menu Key)|
|`KC_POWER`        |         |Power                         |
|`KC_EXECUTE`      |         |Execute                       |
|`KC_HELP`         |         |Help                          |
|`KC_MENU`         |         |Menu                          |
|`KC_SELECT`       |         |Select                        |
|`KC_AGAIN`        |         |Again                         |
|`KC_UNDO`         |         |Undo                          |
|`KC_CUT`          |         |Cut                           |
|`KC_COPY`         |         |Copy                          |
|`KC_PASTE`        |         |Paste                         |
|`KC_FIND`         |         |Find                          |
|`KC_ALT_ERASE`    |         |Alternate Erase               |
|`KC_SYSREQ`       |         |SysReq/Attention              |
|`KC_CANCEL`       |         |Cancel                        |
|`KC_CLEAR`        |         |Clear                         |
|`KC_PRIOR`        |         |Prior                         |
|`KC_RETURN`       |         |Return                        |
|`KC_SEPARATOR`    |         |Separator                     |
|`KC_OUT`          |         |Out                           |
|`KC_OPER`         |         |Oper                          |
|`KC_CLEAR_AGAIN`  |         |Clear/Again                   |
|`KC_CRSEL`        |         |CrSel/Props                   |
|`KC_EXSEL`        |         |ExSel                         |
|Key               |Aliases            |Description                   |
|------------------|-------------------|------------------------------|
|`KC_PSCREEN`      |`KC_PSCR`          |Print Screen                  |
|`KC_PAUSE`        |`KC_PAUS`, `KC_BRK`|Pause                         |
|`KC_INSERT`       |`KC_INS`           |Insert                        |
|`KC_HOME`         |                   |Home                          |
|`KC_PGUP`         |                   |Page Up                       |
|`KC_DELETE`       |`KC_DEL`           |Forward Delete                |
|`KC_END`          |                   |End                           |
|`KC_PGDOWN`       |`KC_PGDN`          |Page Down                     |
|`KC_RIGHT`        |`KC_RGHT`          |Right Arrow                   |
|`KC_LEFT`         |                   |Left Arrow                    |
|`KC_DOWN`         |                   |Down Arrow                    |
|`KC_UP`           |                   |Up Arrow                      |
|`KC_APPLICATION`  |`KC_APP`           |Application (Windows Menu Key)|
|`KC_POWER`        |                   |System Power (macOS/Linux)    |
|`KC_EXECUTE`      |`KC_EXEC`          |Execute                       |
|`KC_HELP`         |                   |Help                          |
|`KC_MENU`         |                   |Menu                          |
|`KC_SELECT`       |`KC_SLCT`          |Select                        |
|`KC_STOP`         |                   |Stop                          |
|`KC_AGAIN`        |`KC_AGIN`          |Again                         |
|`KC_UNDO`         |                   |Undo                          |
|`KC_CUT`          |                   |Cut                           |
|`KC_COPY`         |                   |Copy                          |
|`KC_PASTE`        |`KC_PSTE`          |Paste                         |
|`KC_FIND`         |                   |Find                          |
|`KC__MUTE`        |                   |Mute (macOS)                  |
|`KC__VOLUP`       |                   |Volume Up (macOS)             |
|`KC__VOLDOWN`     |                   |Volume Down (macOS)           |
|`KC_ALT_ERASE`    |`KC_ERAS`          |Alternate Erase               |
|`KC_SYSREQ`       |                   |SysReq/Attention              |
|`KC_CANCEL`       |                   |Cancel                        |
|`KC_CLEAR`        |`KC_CLR`           |Clear                         |
|`KC_PRIOR`        |                   |Prior                         |
|`KC_RETURN`       |                   |Return                        |
|`KC_SEPARATOR`    |                   |Separator                     |
|`KC_OUT`          |                   |Out                           |
|`KC_OPER`         |                   |Oper                          |
|`KC_CLEAR_AGAIN`  |                   |Clear/Again                   |
|`KC_CRSEL`        |                   |CrSel/Props                   |
|`KC_EXSEL`        |                   |ExSel                         |

## Media Keys



@@ 165,42 193,37 @@ These keycodes are not part of the Keyboard/Keypad usage page. The `SYSTEM_` key

Windows and macOS use different keycodes for "next track" and "previous track". Make sure you choose the keycode that corresponds to your OS.

|Key                    |Aliases  |Description                      |
|-----------------------|---------|---------------------------------|
|`KC_SYSTEM_POWER`      |`KC_PWR` |System Power Down                |
|`KC_SYSTEM_SLEEP`      |`KC_SLEP`|System Sleep                     |
|`KC_SYSTEM_WAKE`       |`KC_WAKE`|System Wake                      |
|`KC_MAIL`              |`KC_MAIL`|                                 |
|`KC_CALCULATOR`        |`KC_CALC`|                                 |
|`KC_MY_COMPUTER`       |`KC_MYCM`|                                 |
|`KC_WWW_SEARCH`        |`KC_WSCH`|                                 |
|`KC_WWW_HOME`          |`KC_WHOM`|                                 |
|`KC_WWW_BACK`          |`KC_WBAK`|                                 |
|`KC_WWW_FORWARD`       |`KC_WFWD`|                                 |
|`KC_WWW_STOP`          |`KC_WSTP`|                                 |
|`KC_WWW_REFRESH`       |`KC_WREF`|                                 |
|`KC_STOP`              |         |Stop                             |
|`KC_WWW_FAVORITES`     |`KC_WFAV`|                                 |
|`KC__MUTE`             |         |Mute (macOS)                     |
|`KC__VOLUP`            |         |Volume Up (macOS)                |
|`KC__VOLDOWN`          |         |Volume Down (macOS)              |
|`KC_AUDIO_MUTE`        |`KC_MUTE`|Mute (Windows/macOS/Linux)       |
|`KC_AUDIO_VOL_UP`      |`KC_VOLU`|Volume Up (Windows/macOS/Linux)  |
|`KC_AUDIO_VOL_DOWN`    |`KC_VOLD`|Volume Down (Windows/macOS/Linux)|
|`KC_MEDIA_NEXT_TRACK`  |`KC_MNXT`|Next Track (Windows)             |
|`KC_MEDIA_PREV_TRACK`  |`KC_MPRV`|Previous Track (Windows)         |
|`KC_MEDIA_FAST_FORWARD`|`KC_MFFD`|Next Track (macOS)               |
|`KC_MEDIA_REWIND`      |`KC_MRWD`|Previous Track (macOS)           |
|`KC_MEDIA_STOP`        |`KC_MSTP`|Stop Track                       |
|`KC_MEDIA_PLAY_PAUSE`  |`KC_MPLY`|Play/Pause Track                 |
|`KC_MEDIA_SELECT`      |`KC_MSEL`|                                 |
|`KC_MEDIA_EJECT`       |`KC_EJCT`|Eject (macOS)                    |
|Key                    |Aliases  |Description                  |
|-----------------------|---------|-----------------------------|
|`KC_SYSTEM_POWER`      |`KC_PWR` |System Power Down            |
|`KC_SYSTEM_SLEEP`      |`KC_SLEP`|System Sleep                 |
|`KC_SYSTEM_WAKE`       |`KC_WAKE`|System Wake                  |
|`KC_AUDIO_MUTE`        |`KC_MUTE`|Mute                         |
|`KC_AUDIO_VOL_UP`      |`KC_VOLU`|Volume Up                    |
|`KC_AUDIO_VOL_DOWN`    |`KC_VOLD`|Volume Down                  |
|`KC_MEDIA_NEXT_TRACK`  |`KC_MNXT`|Next Track (Windows)         |
|`KC_MEDIA_PREV_TRACK`  |`KC_MPRV`|Previous Track (Windows)     |
|`KC_MEDIA_STOP`        |`KC_MSTP`|Stop Track (Windows)         |
|`KC_MEDIA_PLAY_PAUSE`  |`KC_MPLY`|Play/Pause Track             |
|`KC_MEDIA_SELECT`      |`KC_MSEL`|Launch Media Player (Windows)|
|`KC_MEDIA_EJECT`       |`KC_EJCT`|Eject (macOS)                |
|`KC_MAIL`              |         |Launch Mail (Windows)        |
|`KC_CALCULATOR`        |`KC_CALC`|Launch Calculator (Windows)  |
|`KC_MY_COMPUTER`       |`KC_MYCM`|Launch My Computer (Windows) |
|`KC_WWW_SEARCH`        |`KC_WSCH`|Browser Search (Windows)     |
|`KC_WWW_HOME`          |`KC_WHOM`|Browser Home (Windows)       |
|`KC_WWW_BACK`          |`KC_WBAK`|Browser Back (Windows)       |
|`KC_WWW_FORWARD`       |`KC_WFWD`|Browser Forward (Windows)    |
|`KC_WWW_STOP`          |`KC_WSTP`|Browser Stop (Windows)       |
|`KC_WWW_REFRESH`       |`KC_WREF`|Browser Refresh (Windows)    |
|`KC_WWW_FAVORITES`     |`KC_WFAV`|Browser Favorites (Windows)  |
|`KC_MEDIA_FAST_FORWARD`|`KC_MFFD`|Next Track (macOS)           |
|`KC_MEDIA_REWIND`      |`KC_MRWD`|Previous Track (macOS)       |

## Number Pad

|Key                |Aliases  |Description                   |
|-------------------|---------|------------------------------|
|`KC_NUMLOCK`       |`KC_NLCK`|Keypad Num Lock and Clear     |
|`KC_KP_SLASH`      |`KC_PSLS`|Keypad `/`                    |
|`KC_KP_ASTERISK`   |`KC_PAST`|Keypad `*`                    |
|`KC_KP_MINUS`      |`KC_PMNS`|Keypad `-`                    |


@@ 225,7 248,7 @@ Windows and macOS use different keycodes for "next track" and "previous track". 

In addition to these, keycodes in the range of `0xA5-DF` are reserved for internal use by TMK.

|Key             |Aliases  |Description                            |
|----------------|---------|---------------------------------------|
|`KC_NO`         |         |Ignore this key (NOOP)                 |
|`KC_TRANSPARENT`|`KC_TRNS`|Use the next lowest non-transparent key|
|Key             |Aliases             |Description                            |
|----------------|--------------------|---------------------------------------|
|`KC_NO`         |`XXXXXXX`           |Ignore this key (NOOP)                 |
|`KC_TRANSPARENT`|`KC_TRNS`, `_______`|Use the next lowest non-transparent key|

M docs/keycodes_us_ansi_shifted.md => docs/keycodes_us_ansi_shifted.md +23 -23
@@ 6,26 6,26 @@ It's important to remember that all of these keycodes send a left shift - this m

## US ANSI Shifted Keycodes

|Key                     |Aliases           |Description        |
|------------------------|------------------|-------------------|
|`KC_TILDE`              |`KC_TILD`         |`~`                |
|`KC_EXCLAIM`            |`KC_EXLM`         |`!`                |
|`KC_AT`                 |                  |`@`                |
|`KC_HASH`               |                  |`#`                |
|`KC_DOLLAR`             |`KC_DLR`          |`$`                |
|`KC_PERCENT`            |`KC_PERC`         |`%`                |
|`KC_CIRCUMFLEX`         |`KC_CIRC`         |`^`                |
|`KC_AMPERSAND`          |`KC_AMPR`         |`&`                |
|`KC_ASTERISK`           |`KC_ASTR`         |`*`                |
|`KC_LEFT_PAREN`         |`KC_LPRN`         |`(`                |
|`KC_RIGHT_PAREN`        |`KC_RPRN`         |`)`                |
|`KC_UNDERSCORE`         |`KC_UNDS`         |`_`                |
|`KC_PLUS`               |                  |`+`                |
|`KC_LEFT_CURLY_BRACE`   |`KC_LCBR`         |`{`                |
|`KC_RIGHT_CURLY_BRACE`  |`KC_RCBR`         |`}`                |
|`KC_PIPE`               |                  |<code>&#124;</code>|
|`KC_COLON`              |`KC_COLN`         |`:`                |
|`KC_DOUBLE_QUOTE`       |`KC_DQT`/`KC_DQUO`|`"`                |
|`KC_LEFT_ANGLE_BRACKET` |`KC_LT`/`KC_LABK` |`<`                |
|`KC_RIGHT_ANGLE_BRACKET`|`KC_GT`/`KC_RABK` |`>`                |
|`KC_QUESTION`           |`KC_QUES`         |`?`                |
|Key                     |Aliases            |Description        |
|------------------------|-------------------|-------------------|
|`KC_TILDE`              |`KC_TILD`          |`~`                |
|`KC_EXCLAIM`            |`KC_EXLM`          |`!`                |
|`KC_AT`                 |                   |`@`                |
|`KC_HASH`               |                   |`#`                |
|`KC_DOLLAR`             |`KC_DLR`           |`$`                |
|`KC_PERCENT`            |`KC_PERC`          |`%`                |
|`KC_CIRCUMFLEX`         |`KC_CIRC`          |`^`                |
|`KC_AMPERSAND`          |`KC_AMPR`          |`&`                |
|`KC_ASTERISK`           |`KC_ASTR`          |`*`                |
|`KC_LEFT_PAREN`         |`KC_LPRN`          |`(`                |
|`KC_RIGHT_PAREN`        |`KC_RPRN`          |`)`                |
|`KC_UNDERSCORE`         |`KC_UNDS`          |`_`                |
|`KC_PLUS`               |                   |`+`                |
|`KC_LEFT_CURLY_BRACE`   |`KC_LCBR`          |`{`                |
|`KC_RIGHT_CURLY_BRACE`  |`KC_RCBR`          |`}`                |
|`KC_PIPE`               |                   |<code>&#124;</code>|
|`KC_COLON`              |`KC_COLN`          |`:`                |
|`KC_DOUBLE_QUOTE`       |`KC_DQUO`, `KC_DQT`|`"`                |
|`KC_LEFT_ANGLE_BRACKET` |`KC_LABK`, `KC_LT` |`<`                |
|`KC_RIGHT_ANGLE_BRACKET`|`KC_RABK`, `KC_GT` |`>`                |
|`KC_QUESTION`           |`KC_QUES`          |`?`                |