aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2024-08-16 12:50:53 -0700
committerJunio C Hamano <gitster@pobox.com>2024-08-16 12:50:53 -0700
commitfca5ece27880b0d4f350d89fdf06e35a927ab547 (patch)
tree02071ef838eb51d9f886aed4e3d265f0faff7ba6
parent8ad56325e9047d5c9075341b9acc9b1a5691889b (diff)
parent8db8786fc2de36731738fd480d1df422c6e86579 (diff)
downloadgit-fca5ece27880b0d4f350d89fdf06e35a927ab547.tar.gz
Merge branch 'jt/doc-post-receive-hook-update' into maint-2.46
Doc update. * jt/doc-post-receive-hook-update: doc: clarify post-receive hook behavior
-rw-r--r--Documentation/githooks.txt15
1 files changed, 9 insertions, 6 deletions
diff --git a/Documentation/githooks.txt b/Documentation/githooks.txt
index 06e997131b..0397dec64d 100644
--- a/Documentation/githooks.txt
+++ b/Documentation/githooks.txt
@@ -415,13 +415,13 @@ post-receive
This hook is invoked by linkgit:git-receive-pack[1] when it reacts to
`git push` and updates reference(s) in its repository.
-It executes on the remote repository once after all the refs have
-been updated.
+The hook executes on the remote repository once after all the proposed
+ref updates are processed and if at least one ref is updated as the
+result.
-This hook executes once for the receive operation. It takes no
-arguments, but gets the same information as the
-<<pre-receive,'pre-receive'>>
-hook does on its standard input.
+The hook takes no arguments. It receives one line on standard input for
+each ref that is successfully updated following the same format as the
+<<pre-receive,'pre-receive'>> hook.
This hook does not affect the outcome of `git receive-pack`, as it
is called after the real work is done.
@@ -448,6 +448,9 @@ environment variables will not be set. If the client selects
to use push options, but doesn't transmit any, the count variable
will be set to zero, `GIT_PUSH_OPTION_COUNT=0`.
+See the "post-receive" section in linkgit:git-receive-pack[1] for
+additional details.
+
[[post-update]]
post-update
~~~~~~~~~~~