path: root/tools
diff options
authorEd Maste <emaste@FreeBSD.org>2020-12-30 17:31:29 +0000
committerEd Maste <emaste@FreeBSD.org>2020-12-30 17:33:19 +0000
commitb67e440755391b4a75363173ca16e170ccbf0394 (patch)
tree39590104833e62df99546c49a7e0005fc09aec8f /tools
parent5e78bbb74a1f55c6213f99eda0ec87e81731a369 (diff)
Add comment explaining Git commit message hook
Suggested by: jhb
Diffstat (limited to 'tools')
1 files changed, 10 insertions, 0 deletions
diff --git a/tools/tools/git/hooks/prepare-commit-msg b/tools/tools/git/hooks/prepare-commit-msg
index 9dcb85cd1a3f..e453b73cc45d 100755
--- a/tools/tools/git/hooks/prepare-commit-msg
+++ b/tools/tools/git/hooks/prepare-commit-msg
@@ -1,5 +1,13 @@
+# prepare-commit-msg: Prepare a commit message upon `git commit` for the
+# user to edit. A script (rather than a static template) is used, so
+# that we can insert our template text other than at the top of the
+# message.
+# Install by copying into the git hooks directory - for example,
+# cp tools/tools/git/hooks/prepare-commit-msg .git/hooks/
case "$2" in
# It appears git invokes this script for interactive rebase but does
@@ -21,7 +29,9 @@ outfile=$(mktemp /tmp/freebsd-git-commit.XXXXXXXX)
# 1. The beginning of the git-provided template (up to the first comment-only
# line) which explains commented lines and such.
# 2. Our template.
# 3. The remainder of the git-provided template (from the first comment-only
# line to the end of the file) which lists files staged for commit, files
# not staged, and untracked files.