no time to do maser for now, but some pointers and thanks

[git.ikiwiki.info.git] / doc / rcs / mercurial.mdwn

diff --git a/doc/rcs/mercurial.mdwn b/doc/rcs/mercurial.mdwn
index 020edfc12fa5e27b6b467a6307e1ed9bf4ad1e1b..ebfc352025d6e4c46e1dc4020faf512be6b4ce27 100644 (file)
--- a/doc/rcs/mercurial.mdwn
+++ b/doc/rcs/mercurial.mdwn
@@ -2,9 +2,17 @@
 system developed by Matt Mackall. Ikiwiki supports storing a wiki in a
 mercurial repository.
 
 system developed by Matt Mackall. Ikiwiki supports storing a wiki in a
 mercurial repository.
 

-Ikiwiki can run as a post-commit and/or install hook to update a wiki whenever commits or remote pushes
+Ikiwiki can run as a `post-commit` and/or `incoming` hook to update a wiki whenever commits or remote pushes

 come in. When running as a [[cgi]] with Mercurial, ikiwiki automatically
 commits edited pages, and uses the Mercurial history to generate the
 [[RecentChanges]] page.
 
 come in. When running as a [[cgi]] with Mercurial, ikiwiki automatically
 commits edited pages, and uses the Mercurial history to generate the
 [[RecentChanges]] page.
 

+Example for a `.hg/hgrc` file in `$SRCDIR`:
+
+    [hooks]
+    post-commit = ikiwiki --setup /path/to/ikiwiki.setup --post-commit
+    incoming = ikiwiki --setup /path/to/ikiwiki.setup --post-commit
+
+Do not use `commit` or `precommit` hooks or ikiwiki will run into a dead lock when committing in `$SRCDIR`. Also note that `--post-commit` and not `--refresh` must be used to avoid dead locking when editing the pages via CGI interface.
+

 See also [[todo/mercurial|todo/mercurial]]
 See also [[todo/mercurial|todo/mercurial]]