b4baf07f4a32ba4af0bdfd40e3cd0d3f2657d80e
[ikiwiki.git] / doc / rcs / mercurial.mdwn
1 [Mercurial](http://selenic.com/mercurial) is a distributed revison control
2 system developed by Matt Mackall. Ikiwiki supports storing a wiki in a
3 mercurial repository.
4
5 Ikiwiki can run as a `post-commit` and/or `incoming` hook to update a wiki whenever commits or remote pushes
6 come in. When running as a [[cgi]] with Mercurial, ikiwiki automatically
7 commits edited pages, and uses the Mercurial history to generate the
8 [[RecentChanges]] page.
9
10 Example for a `.hg/hgrc` file in `$SRCDIR`:
11
12     [hooks]
13     post-commit = /home/abe/bin/rebuildwiki
14     incoming = /home/abe/bin/rebuildwiki
15
16 Do not use `commit` or `precommit` hooks or ikiwiki will run into a dead lock when committing in `$SRCDIR`
17
18 See also [[todo/mercurial|todo/mercurial]]