[Doc] Improve magic keycode section (#21787)

This commit is contained in:
フィルターペーパー 2023-08-23 12:52:52 +08:00 committed by GitHub
parent 3f192722b1
commit c2b837514b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -27,8 +27,7 @@ SPACE_CADET_ENABLE = no
GRAVE_ESC_ENABLE = no GRAVE_ESC_ENABLE = no
MAGIC_ENABLE = no MAGIC_ENABLE = no
``` ```
These features are enabled by default, but may not be needed. Double check to make sure, though. These features are enabled by default, but they may not be needed. Double check to make sure. The [Magic Keycodes](keycodes_magic.md) are the largest and control things like NKRO toggling, GUI and ALT/CTRL swapping, etc. Disabling them will disable those functions. See [Magic Functions](#magic-functions) for disabling related functions.
Largest in size is "magic" -- the QMK magic keycodes -- which control things like NKRO toggling, GUI and ALT/CTRL swapping, etc. Disabling it will disable those functions.
If you use `sprintf` or `snprintf` functions you can save around ~400 Bytes by enabling this option. If you use `sprintf` or `snprintf` functions you can save around ~400 Bytes by enabling this option.
```make ```make
@ -88,7 +87,7 @@ Or if you're not using layers at all, you can outright remove the functionality
#define NO_ACTION_LAYER #define NO_ACTION_LAYER
``` ```
## Magic keycodes ## Magic Functions
There are two `__attribute__ ((weak))` placeholder functions available to customize magic keycodes. If you are not using that feature to swap keycodes, such as backslash with backspace, add the following to your `keymap.c` or user space code: There are two `__attribute__ ((weak))` placeholder functions available to customize magic keycodes. If you are not using that feature to swap keycodes, such as backslash with backspace, add the following to your `keymap.c` or user space code:
```c ```c