summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorsupperthomas <[email protected]>2023-04-23 21:56:29 +0800
committerguo <[email protected]>2023-05-10 19:43:05 +0800
commit8de0bef8a50030e0242589ec8b2fc5e403a95af6 (patch)
tree0aecf5bdd9975acd34fb5315c3065f55fe89dac3
parent4ac7e6092f98a7b6588571b9a2372db30b3a4f95 (diff)
[hooks] add readme
-rw-r--r--.hooks/readme.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/.hooks/readme.md b/.hooks/readme.md
index 18d7432961..0b720179e1 100644
--- a/.hooks/readme.md
+++ b/.hooks/readme.md
@@ -4,3 +4,12 @@
Please use cmd `git config --local core.hooksPath .hooks` for git hooks local.
+## git hooks使用注意事项
+
+- hooks里面的要安装cppcheck和astyle以及formatting命令行才能使用,如果想要去掉某个选项,在pre-commit中注释掉相应的命令即可。
+- 取消hook选项请使用命令`git config --unset --local core.hooksPath .hooks` 可以取消hook格式化文件
+- 这个githook不敲命令是不生效的
+- githook会用astyle格式化一些文件(这个按照rt-thread coding-style里面的设置来的),这里要注意,如果之前文件没有经过astlye格式化的话,会出现很多修改,如果修改过多,建议不用astyle进行格式化。
+- formatting命令只针对`c|cpp|h` 文件,并没有针对文件夹修改等。所以如果有SDK等不希望formatting的文件,请先将hooks功能去掉,commit之后,再考虑使用hooks命令。
+- 如果对git的pre-commit不是很熟悉,建议可以先不用这个hooks。
+