aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorKonstantin Đorđević <vomindoraan@gmail.com>2020-04-09 01:18:30 +0200
committerGitHub <noreply@github.com>2020-04-09 00:18:30 +0100
commitbe2f5816b6cf6513591f825df1d0438729b83388 (patch)
tree86d00fbf766521955ab50706b8d109d800e4b052 /docs
parentff213d5fe1a74f345dd2263c6fb4bc9280f74e0f (diff)
downloadqmk_firmware-be2f5816b6cf6513591f825df1d0438729b83388.tar.gz
qmk_firmware-be2f5816b6cf6513591f825df1d0438729b83388.zip
Fix compile issues related to NO_ACTION_MACRO/FUNCTION and LTO_ENABLE (#8663)
* Define NO_ACTION_MACRO/FUNCTION in header instead of makefile when LTO is enabled Currently, boards and keymaps that define NO_ACTION_MACRO/FUNCTION unconditionally will not compile with LTO_ENABLE (#8604). This fixes the issue by moving the definitions from common.mk to action.h, which enables us to check for previous definitions of those macros (this cannot be done in a makefile). * Remove LTO checks in templates Since now NO_ACTION_MACRO/FUNCTION are defined as needed in action.h (which is included by quantum.h), checking for LTO in keyboard and user code is no longer required. * Update LTO_ENABLE docs
Diffstat (limited to 'docs')
-rw-r--r--docs/config_options.md10
1 files changed, 5 insertions, 5 deletions
diff --git a/docs/config_options.md b/docs/config_options.md
index 661cfccce..16fea83a3 100644
--- a/docs/config_options.md
+++ b/docs/config_options.md
@@ -115,9 +115,9 @@ If you define these options you will disable the associated feature, which can s
115* `#define NO_ACTION_ONESHOT` 115* `#define NO_ACTION_ONESHOT`
116 * disable one-shot modifiers 116 * disable one-shot modifiers
117* `#define NO_ACTION_MACRO` 117* `#define NO_ACTION_MACRO`
118 * disable old style macro handling: MACRO() & action_get_macro 118 * disable old-style macro handling using `MACRO()`, `action_get_macro()` _(deprecated)_
119* `#define NO_ACTION_FUNCTION` 119* `#define NO_ACTION_FUNCTION`
120 * disable calling of action_function() from the fn_actions array (deprecated) 120 * disable old-style function handling using `fn_actions`, `action_function()` _(deprecated)_
121 121
122## Features That Can Be Enabled 122## Features That Can Be Enabled
123 123
@@ -317,10 +317,10 @@ This is a [make](https://www.gnu.org/software/make/manual/make.html) file that i
317* `LAYOUTS` 317* `LAYOUTS`
318 * A list of [layouts](feature_layouts.md) this keyboard supports. 318 * A list of [layouts](feature_layouts.md) this keyboard supports.
319* `LINK_TIME_OPTIMIZATION_ENABLE` 319* `LINK_TIME_OPTIMIZATION_ENABLE`
320 * Enables Link Time Optimization (`LTO`) when compiling the keyboard. This makes the process take longer, but can significantly reduce the compiled size (and since the firmware is small, the added time is not noticeable). However, this will automatically disable the old Macros and Functions features automatically, as these break when `LTO` is enabled. 320 * Enables Link Time Optimization (LTO) when compiling the keyboard. This makes the process take longer, but it can significantly reduce the compiled size (and since the firmware is small, the added time is not noticeable).
321 It does this by automatically defining `NO_ACTION_MACRO` and `NO_ACTION_FUNCTION` 321However, this will automatically disable the legacy TMK Macros and Functions features, as these break when LTO is enabled. It does this by automatically defining `NO_ACTION_MACRO` and `NO_ACTION_FUNCTION`. (Note: This does not affect QMK [Macros](feature_macros.md) and [Layers](feature_layers.md).)
322* `LTO_ENABLE` 322* `LTO_ENABLE`
323 * It has the same meaning as LINK_TIME_OPTIMIZATION_ENABLE. You can use `LTO_ENABLE` instead of `LINK_TIME_OPTIMIZATION_ENABLE`. 323 * Has the same meaning as `LINK_TIME_OPTIMIZATION_ENABLE`. You can use `LTO_ENABLE` instead of `LINK_TIME_OPTIMIZATION_ENABLE`.
324 324
325## AVR MCU Options 325## AVR MCU Options
326* `MCU = atmega32u4` 326* `MCU = atmega32u4`