summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorQMK Bot <hello@qmk.fm>2023-01-18 00:26:53 +0000
committerQMK Bot <hello@qmk.fm>2023-01-18 00:26:53 +0000
commit949bdd22ef229fa16cc52650e1f3c9201d18f129 (patch)
tree042fc454bf84f95ea51f16647f1c6d6a83c89dd1 /docs
parent8e16920530b810510885f5f77a1c0731c463d8bf (diff)
parent737e6bf027e43235c8db31a727b4c8bc9f44e6de (diff)
Merge remote-tracking branch 'origin/master' into develop
Diffstat (limited to 'docs')
-rw-r--r--docs/feature_leader_key.md10
1 files changed, 8 insertions, 2 deletions
diff --git a/docs/feature_leader_key.md b/docs/feature_leader_key.md
index 4e7a487be7..d3dc9a56db 100644
--- a/docs/feature_leader_key.md
+++ b/docs/feature_leader_key.md
@@ -41,14 +41,20 @@ As you can see, you have a few functions. You can use `SEQ_ONE_KEY` for single-k
Each of these accepts one or more keycodes as arguments. This is an important point: You can use keycodes from **any layer on your keyboard**. That layer would need to be active for the leader macro to fire, obviously.
-## Adding Leader Key Support in the `rules.mk`
+## Adding Leader Key Support
-To add support for Leader Key you simply need to add a single line to your keymap's `rules.mk`:
+To enable Leader Key, add the following line to your keymap's `rules.mk`:
```make
LEADER_ENABLE = yes
```
+Place the following macro in your `keymap.c` or user space source file, before any functional code. It handles declaration of external variables that will be referenced by Leader Key codes that follows:
+
+```c
+LEADER_EXTERNS();
+```
+
## Per Key Timing on Leader keys
Rather than relying on an incredibly high timeout for long leader key strings or those of us without 200wpm typing skills, we can enable per key timing to ensure that each key pressed provides us with more time to finish our stroke. This is incredibly helpful with leader key emulation of tap dance (read: multiple taps of the same key like C, C, C).