summaryrefslogtreecommitdiff
path: root/docs/hardware_keyboard_guidelines.md
AgeCommit message (Collapse)Author
2021-08-29add 'include keyboard_features.mk' into build_keyboard.mk (#8422)Takeshi ISHII
* add 'include keyboard_features.mk' into build_keyboard.mk keyboard_features.mk is a keyboard-local version of the functions performed by common_features.mk. * add comment into build_keyboard.mk * added description of keyboard_features.mk in hardware_keyboard_guidelines.md. * rename `keyboard_features.mk` to `post_rules.mk`
2021-08-06Remove Full Bootmagic (#13846)James Young
* disambiguate Bootmagic rules in keymaps The files edited by this commit were added at a point in time where `BOOTMAGIC_ENABLE = yes` enabled full Bootmagic. This commit edits the files to specify that full Bootmagic is intended. * remove BOOTMAGIC_ENABLE=full setting * unify commented BOOTMAGIC_ENABLE rules in keyboards Explicitly sets `BOOTMAGIC_ENABLE = no` in keyboards where the rule was commented out. Command: ``` find keyboards/ -type f -name 'rules.mk' -and -not -path '*/keymaps/*' -exec sed -i -e 's;#[ \t]*\(BOOTMAGIC_ENABLE\)[ \t=]\+\([a-zA-Z]\+\).*;\1 = no # Virtual DIP switch configuration;g' {} + ``` * remove commented Bootmagic rules from keymap/user level Command: ``` find keyboards/ layouts/ users/ -type f -name 'rules.mk' -exec sed -i -e '/#.*\(BOOTMAGIC_ENABLE\)[ \t=]\+\([a-z]\+\).*/d' {} + ``` * update keyboard BOOTMAGIC_ENABLE rule formatting Sets the formatting of BOOTMAGIC_ENABLE rules to `BOOTMAGIC_ENABLE = [value]`, without the inline comments (which will be replaced later). Command: ``` find keyboards/ -type f -name 'rules.mk' -and -not -path '*/keymaps/*' -exec sed -i -e 's;\(BOOTMAGIC_ENABLE\)[ \t=]\+\([a-z]\+\).*;\1 = \2;g' '{}' + ``` * update keyboards' BOOTMAGIC_ENABLE settings Updates keyboard `rules.mk` files to use `BOOTMAGIC_ENABLE = lite` where `BOOTMAGIC_ENABLE = full` was being used. Command: ``` find keyboards/ -type f -name 'rules.mk' -and -not -path '*/keymaps/*' -exec sed -i -e 's;\(BOOTMAGIC_ENABLE = \)full;\1lite;g' '{}' + ``` * update keymap/user BOOTMAGIC_ENABLE settings Updates keymap/user `rules.mk` files to use `BOOTMAGIC_ENABLE = lite` where `BOOTMAGIC_ENABLE = full` was being used. Commands: ``` find keyboards/ -type f -name 'rules.mk' -and -path '*/keymaps/*' -exec sed -i -e 's;\(BOOTMAGIC_ENABLE[ \t=]\+\)full;\1lite;g' '{}' + find layouts/community/ users/ -type f -name 'rules.mk' -exec sed -i -e 's;\(BOOTMAGIC_ENABLE[ \t=]\+\)full;\1lite;g' '{}' + ``` * remove and replace inline comments in keyboards and keymap/user files Removes and replaces the inline comments, which have been updated to read `Enable Bootmagic Lite`. Commands: ``` find keyboards/ -type f -name 'rules.mk' -and -path '*/keymaps/*' -exec sed -i -e 's;\(BOOTMAGIC_ENABLE\)[ \t=]\+\([a-z]\+\).*;\1 = \2;g' '{}' + find layouts/community/ users/ -type f -name 'rules.mk' -exec sed -i -e 's;\(BOOTMAGIC_ENABLE\)[ \t=]\+\([a-z]\+\).*;\1 = \2;g' '{}' + find keyboards/ layouts/community/ users/ -type f -name 'rules.mk' -exec sed -i -e 's;\(BOOTMAGIC_ENABLE = lite\);\1 # Enable Bootmagic Lite;g' '{}' + find keyboards/ layouts/community/ users/ -type f -name 'rules.mk' -exec sed -i -e 's;\(BOOTMAGIC_ENABLE = yes\);\1 # Enable Bootmagic Lite;g' '{}' + find keyboards/ layouts/community/ users/ -type f -name 'rules.mk' -exec sed -i -e 's;\(BOOTMAGIC_ENABLE = no\);\1 # Enable Bootmagic Lite;g' '{}' + ``` * rename improperly named makefiles Some files intended to be used as makefiles had improper names causing them to not be used as intended when building. This commit corrects the filenames of the affected files. * update renamed file with new rule formatting * update QMK's template files Updates QMK's `rules.mk` templates to use the new inline comment. * update QMK Docs - remove documentation of full Bootmagic - update links to Bootmagic Lite doc - add doc for Magic Keycodes * rules.mk patch for coarse/ixora and coarse/vinta
2021-01-30[Docs] Use HTTPS for images and links where possible (#11695)Ryan
2020-11-07New command: qmk lint (#10761)Zach White
* Basic qmk lint command * check for keymap readme * change the workflow from qmk info to qmk lint * add a strict mode * parsing -> parse * document qmk lint * small info logging cleanup * Apply suggestions from code review Co-authored-by: Ryan <fauxpark@gmail.com> * honor --strict in more places * change the job name to lint Co-authored-by: Ryan <fauxpark@gmail.com>
2020-10-05Fixes small typo in docs (#10515)Joe Strong
2020-03-29[Docs] added the description of the reading order of the rules.mk files. (#8566)Takeshi ISHII
* added the description of the reading order of the rules.mk files. * Update docs/hardware_keyboard_guidelines.md Co-Authored-By: Ryan <fauxpark@gmail.com> * Update docs/hardware_keyboard_guidelines.md Co-Authored-By: Ryan <fauxpark@gmail.com> Co-authored-by: Ryan <fauxpark@gmail.com>
2020-03-25[Docs] added the description of the reading order of the config.h files. (#8545)Takeshi ISHII
* added the description of the reading order of the config.h files. * Update docs/hardware_keyboard_guidelines.md * Update docs/hardware_keyboard_guidelines.md * Added a description of post_config.h. * sample bug fix * sample update * Update docs/hardware_keyboard_guidelines.md * Update docs/hardware_keyboard_guidelines.md * update docs/hardware_keyboard_guidelines.md * Update docs/hardware_keyboard_guidelines.md
2019-10-02Fixed typos in documentation (#6871)Erik Doffagne
* Fixed typos in documentation * Update docs/arm_debugging.md Co-Authored-By: fauxpark <fauxpark@gmail.com> * Update docs/arm_debugging.md Co-Authored-By: fauxpark <fauxpark@gmail.com>
2019-02-08Clarify LAYOUT vs LAYOUT_allskullY
2019-02-08Address comments in #4832. Move info.json reference to its own file.skullY
2019-02-08Update docs/hardware_keyboard_guidelines.mdKonstantin Đorđević
Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com>
2019-02-08Update docs/hardware_keyboard_guidelines.mdKonstantin Đorđević
Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com>
2019-02-08Update docs/hardware_keyboard_guidelines.mdKonstantin Đorđević
Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com>
2019-02-08Update docs/hardware_keyboard_guidelines.mdKonstantin Đorđević
Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com>
2019-02-08Update docs/hardware_keyboard_guidelines.mdKonstantin Đorđević
Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com>
2019-02-08Update docs/hardware_keyboard_guidelines.mdKonstantin Đorđević
Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com>
2019-02-08Update docs/hardware_keyboard_guidelines.mdKonstantin Đorđević
Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com>
2019-02-08Update docs/hardware_keyboard_guidelines.mdKonstantin Đorđević
Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com>
2019-02-08Update docs/hardware_keyboard_guidelines.mdKonstantin Đorđević
Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com>
2019-02-08Update docs/hardware_keyboard_guidelines.mdKonstantin Đorđević
Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com>
2019-02-08Update docs/hardware_keyboard_guidelines.mdKonstantin Đorđević
Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com>
2019-02-08Update docs/hardware_keyboard_guidelines.mdfauxpark
Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com>
2019-02-08tweak the keyboard guidelinesskullY
2019-02-08Update the keyboard guidelinesskullY
2018-06-01Remove bootloader key as it is no longer used (#3093)Dan Hertz
2018-04-07Remove obsolete info.json entries (#2712)skullydazed
2018-03-31Fix broken Markdown (#2652)Mike Kozlowski
Fix links in Keyboard Guidelines page
2018-03-20Added bootloader optionsMerlin04
I think I got all of them, so I removed the "FIXME".
2018-03-03Mention invalid names in the readme. (#2458)Graham P Heath
2018-03-02More thoroughly document Bootmagic and Command (#2455)skullydazed
2017-12-09Trim trailing whitespacefauxpark
2017-12-09Convert all headings to Title Casefauxpark
2017-11-02use real greater than and less than charsskullY
2017-11-02Document info.json filesskullY
2017-10-24Restructure the hardware and feature docs to make things easier to find (#1888)skullydazed
* fix #1313 by documenting more config.h options * Clean up and organize documentation