summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDrashna Jaelre <drashna@live.com>2018-12-14 07:37:27 -0800
committerMechMerlin <30334081+mechmerlin@users.noreply.github.com>2018-12-14 07:37:27 -0800
commit6c6bbff600cd37416bdf067ac67971c58136129f (patch)
tree137bbc095cb7089a2a008377a31338a3c9ef34cf /docs
parent641bbeb41af87feb01882e9f8a252312d2665a6a (diff)
Enhance documentation for Tap-Hold functions (#4628)
Diffstat (limited to 'docs')
-rw-r--r--docs/feature_advanced_keycodes.md13
1 files changed, 9 insertions, 4 deletions
diff --git a/docs/feature_advanced_keycodes.md b/docs/feature_advanced_keycodes.md
index e5f241f7f1..bda4972331 100644
--- a/docs/feature_advanced_keycodes.md
+++ b/docs/feature_advanced_keycodes.md
@@ -161,8 +161,13 @@ For one shot mods, you need to call `set_oneshot_mods(MOD)` to set it, or `clear
!> If you're having issues with OSM translating over Remote Desktop Connection, this can be fixed by opening the settings, going to the "Local Resources" tap, and in the keyboard section, change the drop down to "On this Computer". This will fix the issue and allow OSM to function properly over Remote Desktop.
+# Tap-Hold Configuration Options
-# Permissive Hold
+While Tap-Hold options are fantastic, they are not without their issues. We have tried to configure them with reasonal defaults, but that may still cause issues for some people.
+
+These options let you modify the behavior of the Tap-Hold keys.
+
+## Permissive Hold
As of [PR#1359](https://github.com/qmk/qmk_firmware/pull/1359/), there is a new `config.h` option:
@@ -185,7 +190,7 @@ Normally, if you do all this within the `TAPPING_TERM` (default: 200ms) this wil
?> If you have `Ignore Mod Tap Interrupt` enabled, as well, this will modify how both work. The regular key has the modifier added if the first key is released first or if both keys are held longer than the `TAPPING_TERM`.
-# Ignore Mod Tap Interrupt
+## Ignore Mod Tap Interrupt
To enable this setting, add this to your `config.h`:
@@ -211,7 +216,7 @@ Normally, this would send `X` (`SHIFT`+`x`). With `Ignore Mod Tap Interrupt` ena
?> If you have `Permissive Hold` enabled, as well, this will modify how both work. The regular key has the modifier added if the first key is released first or if both keys are held longer than the `TAPPING_TERM`.
-# Tapping Force Hold
+## Tapping Force Hold
To enable `tapping force hold`, add the following to your `config.h`:
@@ -235,7 +240,7 @@ With `TAPPING_FORCE_HOLD`, the second press will be interpreted as a Shift, allo
!> `TAPPING_FORCE_HOLD` will break anything that uses tapping toggles (Such as the `TT` layer keycode, and the One Shot Tapping Toggle).
-# Retro Tapping
+## Retro Tapping
To enable `retro tapping`, add the following to your `config.h`: