summaryrefslogtreecommitdiff
path: root/docs/feature_layouts.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/feature_layouts.md')
-rw-r--r--docs/feature_layouts.md29
1 files changed, 29 insertions, 0 deletions
diff --git a/docs/feature_layouts.md b/docs/feature_layouts.md
index 1ee8b5e35c..b34fd442d5 100644
--- a/docs/feature_layouts.md
+++ b/docs/feature_layouts.md
@@ -51,6 +51,35 @@ The folder name must be added to the keyboard's `rules.mk`:
but the `LAYOUT_<layout>` variable must be defined in `<folder>.h` as well.
+## Building a Keymap
+
+You should be able to build the keyboard keymap with a command in this format:
+
+ make <keyboard>:<layout>
+
+### Conflicting layouts
+When a keyboard supports multiple layout options,
+
+ LAYOUTS = ortho_4x4 ortho_4x12
+
+And a layout exists for both options,
+```
+layouts/
++ community/
+| + ortho_4x4/
+| | + <layout>/
+| | | + ...
+| + ortho_4x12/
+| | + <layout>/
+| | | + ...
+| + ...
+```
+
+The FORCE_LAYOUT argument can be used to specify which layout to build
+
+ make <keyboard>:<layout> FORCE_LAYOUT=ortho_4x4
+ make <keyboard>:<layout> FORCE_LAYOUT=ortho_4x12
+
## Tips for Making Layouts Keyboard-Agnostic
### Includes