summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorRyan <fauxpark@gmail.com>2023-11-12 18:25:46 +1100
committerGitHub <noreply@github.com>2023-11-12 18:25:46 +1100
commit786ebf87608dd4d7232cd0e66638382a55ceafa4 (patch)
treefe7f395d7ccf6e7b71ba720a743b65ea49a2a942 /docs
parent87d69aebbbac957a770be0e55c9c71d0ea808eb4 (diff)
Remove requirement for `keymap_steno.h` include in keymaps (#22423)
* Remove requirement for `keymap_steno.h` include in keymaps * Add back keymap_steno.h with a note for the time being
Diffstat (limited to 'docs')
-rw-r--r--docs/feature_stenography.md6
-rw-r--r--docs/reference_keymap_extras.md1
2 files changed, 2 insertions, 5 deletions
diff --git a/docs/feature_stenography.md b/docs/feature_stenography.md
index df4c9c6ad3..5ca3ea945f 100644
--- a/docs/feature_stenography.md
+++ b/docs/feature_stenography.md
@@ -104,7 +104,7 @@ After enabling stenography and optionally selecting a protocol, you may also nee
104 104
105!> If you had *explicitly* set `VIRSTER_ENABLE = no`, none of the serial stenography protocols (GeminiPR, TX Bolt) will work properly. You are expected to either set it to `yes`, remove the line from your `rules.mk` or send the steno chords yourself in an alternative way using the [provided interceptable hooks](#interfacing-with-the-code). 105!> If you had *explicitly* set `VIRSTER_ENABLE = no`, none of the serial stenography protocols (GeminiPR, TX Bolt) will work properly. You are expected to either set it to `yes`, remove the line from your `rules.mk` or send the steno chords yourself in an alternative way using the [provided interceptable hooks](#interfacing-with-the-code).
106 106
107In your keymap, create a new layer for Plover, that you can fill in with the [steno keycodes](#keycode-reference) (you will need to include `keymap_steno.h`, see `planck/keymaps/steno/keymap.c` for an example). Remember to create a key to switch to the layer as well as a key for exiting the layer. 107In your keymap, create a new layer for Plover, that you can fill in with the [steno keycodes](#keycode-reference). Remember to create a key to switch to the layer as well as a key for exiting the layer.
108 108
109Once you have your keyboard flashed, launch Plover. Click the 'Configure...' button. In the 'Machine' tab, select the Stenotype Machine that corresponds to your desired protocol. Click the 'Configure...' button on this tab and enter the serial port or click 'Scan'. Baud rate is fine at 9600 (although you should be able to set as high as 115200 with no issues). Use the default settings for everything else (Data Bits: 8, Stop Bits: 1, Parity: N, no flow control). 109Once you have your keyboard flashed, launch Plover. Click the 'Configure...' button. In the 'Machine' tab, select the Stenotype Machine that corresponds to your desired protocol. Click the 'Configure...' button on this tab and enter the serial port or click 'Scan'. Baud rate is fine at 9600 (although you should be able to set as high as 115200 with no issues). Use the default settings for everything else (Data Bits: 8, Stop Bits: 1, Parity: N, no flow control).
110 110
@@ -149,8 +149,6 @@ At the end of this scenario given as an example, `chord` would have five bits se
149 149
150## Keycode Reference :id=keycode-reference 150## Keycode Reference :id=keycode-reference
151 151
152You must include `keymap_steno.h` to your `keymap.c` with `#include "keymap_steno.h"` before you can use these keycodes
153
154> Note: TX Bolt does not support the full set of keys. The TX Bolt implementation in QMK will map the GeminiPR keys to the nearest TX Bolt key so that one key map will work for both. 152> Note: TX Bolt does not support the full set of keys. The TX Bolt implementation in QMK will map the GeminiPR keys to the nearest TX Bolt key so that one key map will work for both.
155 153
156|GeminiPR|TX Bolt|Steno Key| 154|GeminiPR|TX Bolt|Steno Key|
@@ -198,7 +196,7 @@ You must include `keymap_steno.h` to your `keymap.c` with `#include "keymap_sten
198|`STN_RES2`||(Reset 2)| 196|`STN_RES2`||(Reset 2)|
199|`STN_PWR`||(Power)| 197|`STN_PWR`||(Power)|
200 198
201If you do not want to hit two keys with one finger combined keycodes can be used. These are also defined in `keymap_steno.h`, and causes both keys to be reported as pressed or released. To use these keycodes define `STENO_COMBINEDMAP` in your `config.h` file. 199If you do not want to hit two keys with one finger combined keycodes can be used. These cause both keys to be reported as pressed or released. To use these keycodes define `STENO_COMBINEDMAP` in your `config.h` file.
202 200
203|Combined key | Key1 | Key 2 | 201|Combined key | Key1 | Key 2 |
204|---------------|--------|----------| 202|---------------|--------|----------|
diff --git a/docs/reference_keymap_extras.md b/docs/reference_keymap_extras.md
index b70d505f1f..84751a512c 100644
--- a/docs/reference_keymap_extras.md
+++ b/docs/reference_keymap_extras.md
@@ -87,6 +87,5 @@ There are also a few which are not quite language-specific, but useful if you ar
87|Norman |`keymap_norman.h` |`sendstring_norman.h` | 87|Norman |`keymap_norman.h` |`sendstring_norman.h` |
88|Plover |`keymap_plover.h` | | 88|Plover |`keymap_plover.h` | |
89|Plover (Dvorak) |`keymap_plover_dvorak.h` | | 89|Plover (Dvorak) |`keymap_plover_dvorak.h` | |
90|Steno |`keymap_steno.h` | |
91|Workman |`keymap_workman.h` |`sendstring_workman.h` | 90|Workman |`keymap_workman.h` |`sendstring_workman.h` |
92|Workman (ZXCVM) |`keymap_workman_zxcvm.h` |`sendstring_workman_zxcvm.h` | 91|Workman (ZXCVM) |`keymap_workman_zxcvm.h` |`sendstring_workman_zxcvm.h` |