summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorQMK Bot <hello@qmk.fm>2021-04-15 02:00:59 +0000
committerQMK Bot <hello@qmk.fm>2021-04-15 02:00:59 +0000
commit2c0aa27e6c0db68c026d2e8d1b416bac5e9599a5 (patch)
tree8b0bb8f960c3edb631e30d391eb69443c85c48c2 /docs
parent19b143688fabcad7ffd192e56642232f1a08fdae (diff)
parent588bcdc8ca212b195a428fc43766a59a9252c08d (diff)
Merge remote-tracking branch 'origin/master' into develop
Diffstat (limited to 'docs')
-rw-r--r--docs/_summary.md1
-rw-r--r--docs/cli_tab_complete.md27
2 files changed, 28 insertions, 0 deletions
diff --git a/docs/_summary.md b/docs/_summary.md
index 83799acdb8..825514e6b5 100644
--- a/docs/_summary.md
+++ b/docs/_summary.md
@@ -29,6 +29,7 @@
* [Overview](cli.md)
* [Configuration](cli_configuration.md)
* [Commands](cli_commands.md)
+ * [Tab Completion](cli_tab_complete.md)
* Using QMK
* Guides
diff --git a/docs/cli_tab_complete.md b/docs/cli_tab_complete.md
new file mode 100644
index 0000000000..2217d4fd3b
--- /dev/null
+++ b/docs/cli_tab_complete.md
@@ -0,0 +1,27 @@
+# Tab Completion for QMK
+
+If you are using Bash 4.2 or later, Zsh, or FiSH you can enable Tab Completion for the QMK CLI. This will let you tab complete the names of flags, keyboards, files, and other `qmk` options.
+
+## Setup
+
+There are several ways you can setup tab completion.
+
+### For Your User Only
+
+Add this to the end of your `.profile` or `.bashrc`:
+
+ source ~/qmk_firmware/util/qmk_tab_complete.sh
+
+If you put `qmk_firmware` into another location you will need to adjust this path.
+
+### System Wide Symlink
+
+If you want the tab completion available to all users of the system you can add a symlink to the `qmk_tab_complete.sh` script:
+
+ `ln -s ~/qmk_firmware/util/qmk_tab_complete.sh /etc/profile.d/qmk_tab_complete.sh`
+
+### System Wide Copy
+
+In some cases a symlink may not work. Instead you can copy the file directly into place. Be aware that updates to the tab complete script may happen from time to time, you will want to recopy the file periodically.
+
+ cp util/qmk_tab_complete.sh /etc/profile.d