summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorFredric Silberberg <fred@silberberg.xyz>2018-07-16 19:10:23 -0700
committerJack Humbert <jack.humb@gmail.com>2018-07-17 00:10:42 -0400
commite9755521ab73f5ae87e578ed1826fe128de426a7 (patch)
tree1f57ffd4289a13074409e0f903ebd208897de8ff /docs
parentbbecd276d2883e488f7ec41ec78a0f71c6d604c1 (diff)
Update README with rules.mk ordering information.
Diffstat (limited to 'docs')
-rw-r--r--docs/feature_userspace.md16
1 files changed, 15 insertions, 1 deletions
diff --git a/docs/feature_userspace.md b/docs/feature_userspace.md
index c8fa406cb0..5f7c05b83b 100644
--- a/docs/feature_userspace.md
+++ b/docs/feature_userspace.md
@@ -31,6 +31,20 @@ The reason for this, is that `<name>.h` won't be added in time to add settings (
So you should use the `config.h` for QMK settings, and the `<name>.h` file for user or keymap specific settings.
+`/users/<name>/rules.mk` will be included in the build _after_ the `rules.mk` from your keymap. This allows you to have features in your userspace `rules.mk` that depend on individual QMK features that may or may not be available on a specific keyboard. For example, if you have RGB control features shared between all your keyboards that support RGB lighting, you can `define RGB_ENABLE` in your keymap `rules.mk` and then check for the variable in your userspace `rules.mk` like this:
+```make
+ifdef RGB_ENABLE
+ # Include my fancy rgb functions source here
+endif
+```
+Because of this, any time you turn on QMK features in your `users/<name>/rules.mk`, you should conditionally enable them only if the flag isn't already defined, like this:
+```make
+ifndef TAP_DANCE_ENABLE
+ TAP_DANCE_ENABLE = yes
+endif
+```
+This will ensure that you can explicitly turn off features for an individual keymap.
+
## Readme
Please include authorship (your name, github username, email), and optionally [a license that's GPL compatible](https://www.gnu.org/licenses/license-list.html#GPLCompatibleLicenses).
@@ -122,4 +136,4 @@ By default the userspace used will be the same as the keymap name. In some situa
```
USER_NAME := mylayout
-``` \ No newline at end of file
+```