post-receive-email: document command-line mode
According to the default hooks/post-receive file, the hook is called with three arguments on stdin: <oldrev> <newrev> <refname> In command-line mode, the arguments come in a different order, because the email hook instead calls: generate_email $2 $3 $1 Add a comment to explain why, based on comments from the mailing list and the commit message to v1.5.1~9. Thanks to Andy for the explanation. Requested-by: martin f. krafft <madduck@debian.org> Cc: Andy Parkins <andyparkins@gmail.com> Signed-off-by: Jonathan Nieder <jrnieder@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Jonathan Nieder committed
May 19, 2010 at 14:01 UTC
cc24a1d809c75f0b6e5b1e56134b5127196bb2fb
1 file changed
+7
contrib/hooks/post-receive-email
+7
@@ -23,6 +23,13 @@
23
# possible for the email to be from someone other than the person doing the
24
# push.
25
#
26
+# To help with debugging and use on pre-v1.5.1 git servers, this script will
27
+# also obey the interface of hooks/update, taking its arguments on the
28
+# command line. Unfortunately, hooks/update is called once for each ref.
29
+# To avoid firing one email per ref, this script just prints its output to
30
+# the screen when used in this mode. The output can then be redirected if
31
+# wanted.
32
+#
33
# Config
34
# ------
35
# hooks.mailinglist