From abb6c7cfcea4c94f2a6846377853dc2c7f9301ec Mon Sep 17 00:00:00 2001 From: Felix Sargent Date: Thu, 16 Dec 2021 13:05:30 -0800 Subject: [PATCH] Improve 'retro-tap' documentation. --- docs/docs/behaviors/hold-tap.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/docs/behaviors/hold-tap.md b/docs/docs/behaviors/hold-tap.md index 972df0be..27211c59 100644 --- a/docs/docs/behaviors/hold-tap.md +++ b/docs/docs/behaviors/hold-tap.md @@ -50,13 +50,19 @@ In QMK, unlike ZMK, this functionality is enabled by default, and you turn it of #### `retro-tap` -If retro tap is enabled, the tap behavior is triggered when releasing the hold-tap key if no other key was pressed in the meantime. +If retro tap is enabled, the tap behavior is triggered when releasing the hold-tap key if no other key was pressed in the meantime. The hold key does not activate until another key is pressed, meaning that it cannot be used for mouse events like Shift Click to select from your cursor position to mouse position. -For example, if you press `&mt LEFT_SHIFT A` and then release it without pressing another key, it will output `a`. +For example, if you press `&sh LEFT_SHIFT Z` and then release it without pressing another key, it will output `z`. ``` -&mt { - retro-tap; +sh: shift { + compatible = "zmk,behavior-hold-tap"; + label = "shift mod"; + #binding-cells = <2>; + tapping_term_ms = <100>; + retro-tap; + flavor = "hold-preferred"; + bindings = <&kp>, <&kp>; }; ```