web commit by http://willu.myopenid.com/: Comments on the current state of Monotone...
authorjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>
Wed, 22 Aug 2007 01:56:49 +0000 (01:56 +0000)
committerjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>
Wed, 22 Aug 2007 01:56:49 +0000 (01:56 +0000)
doc/rcs/monotone.mdwn

index d68eb1ed59ffd6ec0ffadc04d8beaba6b0c93565..7c5497611db7c3ec3f9337f3c1bdcf97e8d9f7c8 100644 (file)
@@ -1,7 +1,16 @@
 [monotone](http://monotone.ca/) is a distributed revision control system.
-Ikiwiki supports storing a wiki in tla.
+Ikiwiki supports storing a wiki in Monotone and editing it using the [[cgi]] interface.
+It will use the Monotone logs to generate the [[RecentChanges]] page.
 
-This requires the Monotone perl module from the monotone contrib/ directory
-to be installed. In particlar, it needs version 0.03 or higher of that module.
-It is available from the monotone source repository at:
+The monotone support requires the Monotone perl module (from the contrib/ directory
+in the monotone source) to be installed. In particular, it needs version 0.03 or higher of that module.
+The module is available from the monotone source repository at:
 <http://viewmtn.angrygoats.net/branch/changes/net.venge.monotone>
+
+Monotone support works, but there are still a few minor missing bits (listed here so they are not forgotten):
+ * At the moment there are no links to display diffs between revisions.  It shouldn't be hard to add links to a [ViewMTN](http://grahame.angrygoats.net/moinmoin/ViewMTN) instance, but it hasn't been done yet.
+ * The [[post-commit]] hook support, so that Ikiwiki sends change notifications when people commit using Monotone rather than the web interface, is partially implemented and untested.
+ * Documentation (this page) could be improved.
+ * If you have both a conflict and a simultaneous rename on a file, then Ikiwiki may get confused.
+
+There is also a mismatch between the way Ikiwiki handles conflicts and the way Monotone handles conflicts.  At present, if there is a conflict, then Ikiwiki will commit a revision with conflict markers before presenting it to the user.  This is ugly, but there is no clean way to fix it at present.