From 2a49832db33598b8acee822fa7b3a6c6af48de0d Mon Sep 17 00:00:00 2001 From: fauxpark Date: Sun, 5 Aug 2018 20:09:42 +1000 Subject: [PATCH] Update FAQ section on power keys --- docs/faq_keymap.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/faq_keymap.md b/docs/faq_keymap.md index 447b892262..b05b968a6c 100644 --- a/docs/faq_keymap.md +++ b/docs/faq_keymap.md @@ -34,12 +34,11 @@ See [issue #168](https://github.com/tmk/tmk_keyboard/issues/168) and * http://en.wikipedia.org/wiki/Magic_SysRq_key * http://en.wikipedia.org/wiki/System_request -## Power Key Doesn't Work -Use `KC_PWR` instead of `KC_POWER` or vice versa. -* `KC_PWR` works with Windows and Linux, not with OSX. -* `KC_POWER` works with OSX and Linux, not with Windows. +## Power Keys Aren't Working -More info: http://geekhack.org/index.php?topic=14290.msg1327264#msg1327264 +Somewhat confusingly, there are two "Power" keycodes in QMK: `KC_POWER` in the Keyboard/Keypad HID usage page, and `KC_SYSTEM_POWER` (or `KC_PWR`) in the Consumer page. + +The former is only recognized on macOS, while the latter, `KC_SLEP` and `KC_WAKE` are supported by all three major operating systems, so it is recommended to use those instead. Under Windows, these keys take effect immediately, however on macOS they must be held down until a dialog appears. ## One Shot Modifier Solves my personal 'the' problem. I often got 'the' or 'THe' wrongly instead of 'The'. One Shot Shift mitigates this for me.