Gecko [ tanishkshah.com ]

Name	Size	Permission	Date
coordinate-embargoed-releases.adoc	10.57 KB	-rw-r--r--	2025-11-17 16:38
coordinate-embargoed-releases.html	42.42 KB	-rw-r--r--	2026-04-05 23:58
howto-index.sh	706 B	-rwxr-xr-x	2025-11-17 16:38
keep-canonical-history-correct.adoc	6.63 KB	-rw-r--r--	2025-11-17 16:38
keep-canonical-history-correct.html	39.04 KB	-rw-r--r--	2026-04-05 23:58
maintain-git.adoc	23.74 KB	-rw-r--r--	2025-11-17 16:38
maintain-git.html	59.48 KB	-rw-r--r--	2026-04-05 23:58
meson.build	1.43 KB	-rw-r--r--	2025-11-17 16:38
new-command.adoc	4.35 KB	-rw-r--r--	2025-11-17 16:38
new-command.html	35.11 KB	-rw-r--r--	2026-04-05 23:58
rebase-from-internal-branch.adoc	6.16 KB	-rw-r--r--	2025-11-17 16:38
rebase-from-internal-branch.html	37.27 KB	-rw-r--r--	2026-04-05 23:58
rebuild-from-update-hook.adoc	3.06 KB	-rw-r--r--	2025-11-17 16:38
rebuild-from-update-hook.html	33.38 KB	-rw-r--r--	2026-04-05 23:58
recover-corrupted-blob-object.adoc	5.38 KB	-rw-r--r--	2025-11-17 16:38
recover-corrupted-blob-object.html	36.74 KB	-rw-r--r--	2026-04-05 23:58
recover-corrupted-object-harder.adoc	14.28 KB	-rw-r--r--	2025-11-17 16:38
recover-corrupted-object-harder.html	48.43 KB	-rw-r--r--	2026-04-05 23:58
revert-a-faulty-merge.adoc	10.6 KB	-rw-r--r--	2025-11-17 16:38
revert-a-faulty-merge.html	43.48 KB	-rw-r--r--	2026-04-05 23:58
revert-branch-rebase.adoc	7.64 KB	-rw-r--r--	2025-11-17 16:38
revert-branch-rebase.html	37.57 KB	-rw-r--r--	2026-04-05 23:58
separating-topic-branches.adoc	3.28 KB	-rw-r--r--	2025-11-17 16:38
separating-topic-branches.html	33.54 KB	-rw-r--r--	2026-04-05 23:58
setup-git-server-over-http.adoc	8.41 KB	-rw-r--r--	2025-11-17 16:38
setup-git-server-over-http.html	43.08 KB	-rw-r--r--	2026-04-05 23:58
update-hook-example.adoc	6.11 KB	-rw-r--r--	2025-11-17 16:38
update-hook-example.html	36.14 KB	-rw-r--r--	2026-04-05 23:58
use-git-daemon.adoc	2.08 KB	-rw-r--r--	2025-11-17 16:38
use-git-daemon.html	32.79 KB	-rw-r--r--	2026-04-05 23:58
using-merge-subtree.adoc	2.95 KB	-rw-r--r--	2025-11-17 16:38
using-merge-subtree.html	33.39 KB	-rw-r--r--	2026-04-05 23:58
using-signed-tag-in-pull-request.adoc	8.09 KB	-rw-r--r--	2025-11-17 16:38
using-signed-tag-in-pull-request.html	39.72 KB	-rw-r--r--	2026-04-05 23:58

Rename

Subject: [HOWTO] Using post-update hook
Message-ID: <7vy86o6usx.fsf@assigned-by-dhcp.cox.net>
From: Junio C Hamano <gitster@pobox.com>
Date: Fri, 26 Aug 2005 18:19:10 -0700
Abstract: In this how-to article, JC talks about how he
 uses the post-update hook to automate Git documentation page
 shown at https://www.kernel.org/pub/software/scm/git/docs/.
Content-type: text/asciidoc

How to rebuild from update hook
===============================

The pages under https://www.kernel.org/pub/software/scm/git/docs/
are built from Documentation/ directory of the git.git project
and needed to be kept up-to-date.  The www.kernel.org/ servers
are mirrored and I was told that the origin of the mirror is on
the machine $some.kernel.org, on which I was given an account
when I took over Git maintainership from Linus.

The directories relevant to this how-to are these two:

/pub/scm/git/git.git/	The public Git repository.
    /pub/software/scm/git/docs/	The HTML documentation page.

So I made a repository to generate the documentation under my
home directory over there.

$ cd
    $ mkdir doc-git && cd doc-git
    $ git clone /pub/scm/git/git.git/ docgen

What needs to happen is to update the $HOME/doc-git/docgen/
working tree, build HTML docs there and install the result in
/pub/software/scm/git/docs/ directory.  So I wrote a little
script:

$ cat >dododoc.sh <<\EOF
    #!/bin/sh
    cd $HOME/doc-git/docgen || exit

unset GIT_DIR

git pull /pub/scm/git/git.git/ master &&
    cd Documentation &&
    make install-webdoc
    EOF

Initially I used to run this by hand whenever I push into the
public Git repository.  Then I did a cron job that ran twice a
day.  The current round uses the post-update hook mechanism,
like this:

$ cat >/pub/scm/git/git.git/hooks/post-update <<\EOF
    #!/bin/sh
    #
    # An example hook script to prepare a packed repository for use over
    # dumb transports.
    #
    # To enable this hook, make this file executable by "chmod +x post-update".

case " $* " in
    *' refs/heads/master '*)
            echo $HOME/doc-git/dododoc.sh | at now
            ;;
    esac
    exec git-update-server-info
    EOF
    $ chmod +x /pub/scm/git/git.git/hooks/post-update

There are four things worth mentioning:

- The update-hook is run after the repository accepts a "git
   push", under my user privilege.  It is given the full names
   of refs that have been updated as arguments.  My post-update
   runs the dododoc.sh script only when the master head is
   updated.

- When update-hook is run, GIT_DIR is set to '.' by the calling
   receive-pack.  This is inherited by the dododoc.sh run via
   the "at" command, and needs to be unset; otherwise, "git
   pull" it does into $HOME/doc-git/docgen/ repository would not
   work correctly.

- The stdout of update hook script is not connected to git
   push; I run the heavy part of the command inside "at", to
   receive the execution report via e-mail.

- This is still crude and does not protect against simultaneous
   make invocations stomping on each other.  I would need to add
   some locking mechanism for this.