From 9c1edcdca99cc8caa7fc2f7a80cb192ab5f4c143 Mon Sep 17 00:00:00 2001 From: precondition <57645186+precondition@users.noreply.github.com> Date: Tue, 23 Aug 2022 00:47:03 +0200 Subject: [PATCH 1/3] Expand on the differences between Caps Word and Caps Lock --- docs/feature_caps_word.md | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/docs/feature_caps_word.md b/docs/feature_caps_word.md index 0b71119917fc..791d79f12d9f 100644 --- a/docs/feature_caps_word.md +++ b/docs/feature_caps_word.md @@ -6,9 +6,9 @@ a modern alternative to Caps Lock: * Letters are capitalized while active, and Caps Word automatically disables itself at the end of the word. That is, it stops by default once a space or - any key other than `a`--`z`, `0`--`9`, `-`, `_`, delete, or backspace is - pressed. Caps Word also disables itself if the keyboard is idle for 5 seconds. - This is configurable, see below. + any key other than `KC_A`--`KC_Z`, `KC_0`--`KC_9`, `KC_MINS`, `KC_UNDS`, + `KC_DELETE`, or `KC_BACKSPACE` is pressed. Caps Word also disables itself if + the keyboard is idle for 5 seconds. This is configurable, see below. * To avoid requiring a dedicated key for Caps Word, there is an option (`BOTH_SHIFTS_TURNS_ON_CAPS_WORD`) to activate Caps Word by simultaneously @@ -16,7 +16,14 @@ a modern alternative to Caps Lock: * The implementation does not use the Caps Lock (`KC_CAPS`) keycode. Caps Word works even if you're remapping Caps Lock at the OS level to Ctrl or something - else, as Emacs and Vim users often do. + else, as Emacs and Vim users often do. As a consequence, Caps Word does not + follow the typical Caps Lock behaviour and may thus act in potentially + unexpected ways, especially when using an *OS* keyboard layout other than US + or UK. For example, Dvorak's , < key (`DV_COMM`) will get shifted + because Caps Word interprets that keycode as the letter 'W' by default, the + Spanish Ñ key (`ES_NTIL`) will not get capitalized because Caps + Word interprets it as the semicolon ';' punctuation character, and the US + hyphen key (`KC_MINS`), while unaffected by Caps Lock, is shifted by Caps Word. ## How do I enable Caps Word :id=how-do-i-enable-caps-word @@ -60,7 +67,7 @@ time, since both use the Left Shift + Right Shift key combination."** Many keyboards enable the [Command feature](feature_command.md), which by default is also activated using the Left Shift + Right Shift key combination. To -fix this conflict, please disable Command by adding in rules.mk: +fix this conflict, please disable Command by adding in rules.mk: ```make COMMAND_ENABLE = no @@ -81,7 +88,7 @@ by defining `IS_COMMAND()` in config.h: Caps Word turns off automatically if no keys are pressed for `CAPS_WORD_IDLE_TIMEOUT` milliseconds. The default is 5000 (5 seconds). -Configure the timeout duration in config.h, for instance +Configure the timeout duration in config.h, for instance ```c #define CAPS_WORD_IDLE_TIMEOUT 3000 // 3 seconds. From f000c170e7564c226cad001b5b1a820aac84a40c Mon Sep 17 00:00:00 2001 From: precondition <57645186+precondition@users.noreply.github.com> Date: Tue, 23 Aug 2022 01:03:59 +0200 Subject: [PATCH 2/3] Add the equiv default KC_ next to intl alias --- docs/feature_caps_word.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/feature_caps_word.md b/docs/feature_caps_word.md index 791d79f12d9f..50bef3e62ab4 100644 --- a/docs/feature_caps_word.md +++ b/docs/feature_caps_word.md @@ -19,9 +19,9 @@ a modern alternative to Caps Lock: else, as Emacs and Vim users often do. As a consequence, Caps Word does not follow the typical Caps Lock behaviour and may thus act in potentially unexpected ways, especially when using an *OS* keyboard layout other than US - or UK. For example, Dvorak's , < key (`DV_COMM`) will get shifted + or UK. For example, Dvorak's , < key (`DV_COMM` aka `KC_W`) will get shifted because Caps Word interprets that keycode as the letter 'W' by default, the - Spanish Ñ key (`ES_NTIL`) will not get capitalized because Caps + Spanish Ñ key (`ES_NTIL` aka `KC_SCLN`) will not get capitalized because Caps Word interprets it as the semicolon ';' punctuation character, and the US hyphen key (`KC_MINS`), while unaffected by Caps Lock, is shifted by Caps Word. From 7bfb8f18256402921cd7bcf7667e6fdf313db5a7 Mon Sep 17 00:00:00 2001 From: precondition <57645186+precondition@users.noreply.github.com> Date: Tue, 23 Aug 2022 01:55:35 +0200 Subject: [PATCH 3/3] It's configurable so it's not a problem --- docs/feature_caps_word.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/docs/feature_caps_word.md b/docs/feature_caps_word.md index 50bef3e62ab4..283f0f528893 100644 --- a/docs/feature_caps_word.md +++ b/docs/feature_caps_word.md @@ -19,11 +19,14 @@ a modern alternative to Caps Lock: else, as Emacs and Vim users often do. As a consequence, Caps Word does not follow the typical Caps Lock behaviour and may thus act in potentially unexpected ways, especially when using an *OS* keyboard layout other than US - or UK. For example, Dvorak's , < key (`DV_COMM` aka `KC_W`) will get shifted - because Caps Word interprets that keycode as the letter 'W' by default, the - Spanish Ñ key (`ES_NTIL` aka `KC_SCLN`) will not get capitalized because Caps - Word interprets it as the semicolon ';' punctuation character, and the US - hyphen key (`KC_MINS`), while unaffected by Caps Lock, is shifted by Caps Word. + or UK. For example, Dvorak's , < key (`DV_COMM` aka `KC_W`) will + get shifted because Caps Word interprets that keycode as the letter 'W' by + default, the Spanish Ñ key (`ES_NTIL` aka `KC_SCLN`) will not get + capitalized because Caps Word interprets it as the semicolon ';' punctuation + character, and the US hyphen key (`KC_MINS`), while unaffected by Caps Lock, + is shifted by Caps Word. However, this is not really a problem because you can + [configure which keys should Caps Word + shift](#configure-which-keys-are-word-breaking). ## How do I enable Caps Word :id=how-do-i-enable-caps-word