X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/f7f3b0bb7d91c74f67023e970cee71ad2ea260da..9e7309ec820066f2fed443245d66f79658360e53:/doc/about_rcs_backends.mdwn diff --git a/doc/about_rcs_backends.mdwn b/doc/about_rcs_backends.mdwn index 95d641e72..84081d6a7 100644 --- a/doc/about_rcs_backends.mdwn +++ b/doc/about_rcs_backends.mdwn @@ -117,7 +117,20 @@ part). GIT doesn't have a similar functionality like 'svn merge -rOLD:NEW FILE' (please see the relevant comment in mergepast for more details), so I had to invent an ugly hack just for the purpose. -## [Mercurial](http://www.selenic.com/mercurial/) +By design, Git backend uses a "master-clone" repository pair approach in contrast +to the single repository approach (here, _clone_ may be considered as the working +copy of a fictious web user). Even though a single repository implementation is +possible, it somewhat increases the code complexity of backend (I couldn't figure +out a uniform method which doesn't depend on the prefered repository model, yet). +By exploiting the fact that the master repo and _web user_'s repo (`srcdir`) are all +on the same local machine, I suggest to create the latter with the "`git clone -l -s`" +command to save disk space. + +Note that, as a rule of thumb, you should always put the rcs wrapper (`post-update`) +into the master repository (`.git/hooks/`) as can be noticed in the Git wrappers of +the sample [[ikiwiki.setup]]. + +## [[Mercurial]] The Mercurial backend is still in a early phase, so it may not be mature enough, but it should be simple to understand and use. @@ -146,4 +159,6 @@ in the destination directory each time 'hg update' is called. CGI operates on M. rcs_commit() will commit directly in M. If you have any question or suggestion about the Mercurial backend -please refer to [Emanuele](http://nerd.ocracy.org/em/). +please refer to [Emanuele](http://nerd.ocracy.org/em/) + +## [[tla]] \ No newline at end of file