Mention git-clang-format (cbf5f2c) - testcode.git

README.md

@@ -74,7 +74,19 @@ Or install a newer one (replace 17 with whatever's current now) with:
     sudo ./llvm.sh 17
     sudo apt install clang-format-17
 
-Then, after making your edits, use the [vim integration](https://clang.llvm.org/docs/ClangFormat.html#vim-integration) or manually format with:
+Then, after making your edits, use the [vim integration](https://clang.llvm.org/docs/ClangFormat.html#vim-integration)
+or manually format in one of a couple of ways:
+
+### Use git-clang-format
+
+`git-clang-format` is installed with clang-format and will format staged files
+into the unstaged area.
+
+1. Stage the files you want to format.
+2. Run `git-clang-format-17 --style=file`, and it'll leave unstaged formatting changes.
+3. Review with `git difftool` and accept the desired changes or unstage.
+
+### Manually clang-format
 
     git status --porcelain | \
     awk 'match($1, "M|A") && match($2, "(c|h)(pp)?$"){print $2}' | \


...	...	@@ -74,7 +74,19 @@ Or install a newer one (replace 17 with whatever's current now) with:
74	74	sudo ./llvm.sh 17
75	75	sudo apt install clang-format-17
76	76
77		-Then, after making your edits, use the [vim integration](https://clang.llvm.org/docs/ClangFormat.html#vim-integration) or manually format with:
	77	+Then, after making your edits, use the [vim integration](https://clang.llvm.org/docs/ClangFormat.html#vim-integration)
	78	+or manually format in one of a couple of ways:
	79	+
	80	+### Use git-clang-format
	81	+
	82	+`git-clang-format` is installed with clang-format and will format staged files
	83	+into the unstaged area.
	84	+
	85	+1. Stage the files you want to format.
	86	+2. Run `git-clang-format-17 --style=file`, and it'll leave unstaged formatting changes.
	87	+3. Review with `git difftool` and accept the desired changes or unstage.
	88	+
	89	+### Manually clang-format
78	90
79	91	git status --porcelain \| \
80	92	awk 'match($1, "M\|A") && match($2, "(c\|h)(pp)?$"){print $2}' \| \
81	93