summaryrefslogtreecommitdiffstats
path: root/docs/cli_commands.md
diff options
context:
space:
mode:
authorErovia <Erovia@users.noreply.github.com>2021-07-23 21:41:33 +0100
committerGitHub <noreply@github.com>2021-07-23 21:41:33 +0100
commitfdcea0633657fba4cebcef45eee2f103d162e28c (patch)
tree6d547e2154fa55aea125bc6fc08420c18c8f232a /docs/cli_commands.md
parent164a74a078722cc488526c0c8fcbc4e1b54a5780 (diff)
CLI/Docs: Fix the format commands' name (#13668)
PR #13296 changed the name of the `cformat` and `pyformat` commands to `format-c` and `format-py` respectively. This PR updates the documentation and some parts of the CLI to use the new names. Also add documentation for the new `format-text` subcommand, introduced in the same PR.
Diffstat (limited to 'docs/cli_commands.md')
-rw-r--r--docs/cli_commands.md25
1 files changed, 18 insertions, 7 deletions
diff --git a/docs/cli_commands.md b/docs/cli_commands.md
index e30593daa9..0a2bd8121e 100644
--- a/docs/cli_commands.md
+++ b/docs/cli_commands.md
@@ -314,7 +314,18 @@ qmk clean [-a]
# Developer Commands
-## `qmk cformat`
+## `qmk format-text`
+
+This command formats text files to have proper line endings.
+
+Every text file in the repository needs to have Unix (LF) line ending.
+If you are working on **Windows**, you must ensure that line endings are corrected in order to get your PRs merged.
+
+```
+qmk format-text
+```
+
+## `qmk format-c`
This command formats C code using clang-format.
@@ -325,25 +336,25 @@ Run it with `-a` to format all core code, or pass filenames on the command line
**Usage for specified files**:
```
-qmk cformat [file1] [file2] [...] [fileN]
+qmk format-c [file1] [file2] [...] [fileN]
```
**Usage for all core files**:
```
-qmk cformat -a
+qmk format-c -a
```
**Usage for only changed files against origin/master**:
```
-qmk cformat
+qmk format-c
```
**Usage for only changed files against branch_name**:
```
-qmk cformat -b branch_name
+qmk format-c -b branch_name
```
## `qmk docs`
@@ -398,14 +409,14 @@ $ qmk kle2json -f kle.txt -f
Ψ Wrote out to info.json
```
-## `qmk pyformat`
+## `qmk format-python`
This command formats python code in `qmk_firmware`.
**Usage**:
```
-qmk pyformat
+qmk format-python
```
## `qmk pytest`