[PATCH v9 1/4] doc: add proc-receive hook info in 'git-receive-pack.adoc'

From: Karthik Nayak <karthik.188@gmail.com>
Date: Sep 9, 2026, 14:51 UTC
Message-ID: <20260909-758-introduce-hook-v9-1-3043d417e0ee@gmail.com>
In-Reply-To: <20260909-758-introduce-hook-v9-0-3043d417e0ee@gmail.com>

The manpage of git-receive-pack(1) documents hooks invoked when receiving a push. The manpage does not mention the 'proc-receive' hook though, which is also invoked as part of that process. Add a paragraph about this hook to plug that gap.

Helped-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Karthik Nayak <karthik.188@gmail.com>
---
 Documentation/git-receive-pack.adoc | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/Documentation/git-receive-pack.adoc b/Documentation/git-receive-pack.adoc
index 0956086d61..5806792ba7 100644
--- a/Documentation/git-receive-pack.adoc
+++ b/Documentation/git-receive-pack.adoc
@@ -236,6 +236,14 @@ if the repository is packed and is served via a dumb transport.
 exec git update-server-info
 ----
 
+PROC-RECEIVE HOOK
+-----------------
+This hook is invoked by linkgit:git-receive-pack[1].  If the server has
+set the multi-valued config variable `receive.procReceiveRefs`, and the
+commands sent to 'receive-pack' have matching reference names, these
+commands will be executed by this hook, instead of by the internal
+`execute_commands()` function.  This hook is responsible for updating
+the relevant references and reporting the results back to 'receive-pack'.
 
 QUARANTINE ENVIRONMENT
 ----------------------

-- 
2.55.GIT