X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=Documentation%2Fgit-receive-pack.txt;h=60debca48720ad54766287e8770254f57fad9d7b;hb=b4a081b428c607f98c5d0a0eec8d543dc1f2abcd;hp=7f95e44046ce2a28053bdddaec8d730257c873a0;hpb=b1bf95bba26c8de1581f401dcab1f743bad7fc1d;p=git.git diff --git a/Documentation/git-receive-pack.txt b/Documentation/git-receive-pack.txt index 7f95e440..60debca4 100644 --- a/Documentation/git-receive-pack.txt +++ b/Documentation/git-receive-pack.txt @@ -1,6 +1,5 @@ git-receive-pack(1) =================== -v0.1, July 2005 NAME ---- @@ -43,40 +42,50 @@ The hook should exit with non-zero status if it wants to disallow updating the named ref. Otherwise it should exit with zero. -The same hook is also called with an empty string as refname and -no other arguments just before git-receive-pack exits. This can -be used to implement repository wide cleanup task if needed. -The exit code from this hook invocation is ignored; the only -thing left for git-receive-pack to do at that point is to exit -itself anyway. - Using this hook, it is easy to generate mails on updates to the local repository. This example script sends a mail with the commits pushed to the repository: #!/bin/sh - case "$#,$1" in - 1,) # help packed repository pulled via dumb protocol. - git-update-server-info - ;; - *) # mail out commit update information. - if expr "$2" : '0*$' >/dev/null - then - echo "Created now ref." + # mail out commit update information. + if expr "$2" : '0*$' >/dev/null + then + echo "Created a new ref, with the following commits:" git-rev-list --pretty "$2" - else - echo "New commits" + else + echo "New commits:" git-rev-list --pretty "$3" "^$2" - fi | - mail -s "Changes to ref $1" commit-list@mydomain - esac + fi | + mail -s "Changes to ref $1" commit-list@mydomain exit 0 +Another hook $GIT_DIR/hooks/post-update, if exists and +executable, is called with the list of refs that have been +updated. This can be used to implement repository wide cleanup +task if needed. The exit code from this hook invocation is +ignored; the only thing left for git-receive-pack to do at that +point is to exit itself anyway. This hook can be used, for +example, to run "git-update-server-info" if the repository is +packed and is served via a dumb transport. + + #!/bin/sh + exec git-update-server-info + +There are other real-world examples of using update and +post-update hooks found in the Documentation/howto directory. + + OPTIONS ------- :: The repository to sync into. + +SEE ALSO +-------- +gitlink:git-send-pack[1] + + Author ------ Written by Linus Torvalds @@ -87,4 +96,4 @@ Documentation by Junio C Hamano. GIT --- -Part of the link:git.html[git] suite +Part of the gitlink:git[7] suite