aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2024-07-31 13:34:16 -0700
committerJunio C Hamano <gitster@pobox.com>2024-07-31 13:34:16 -0700
commitf31e901332756780ed6af222b55fd75084121621 (patch)
treef026b05ddcdd11b185142d8bb4fd6b68b94d939a
parentf084c50de6b584f3c2fd2af3550c53f4f238d19b (diff)
parent8db8786fc2de36731738fd480d1df422c6e86579 (diff)
downloadgit-f31e901332756780ed6af222b55fd75084121621.tar.gz
Merge branch 'jt/doc-post-receive-hook-update'
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
~~~~~~~~~~~