monotone updates
[ikiwiki.git] / doc / bugs / Monotone_rcs_support.mdwn
1 #Ikiwiki plugin for the Monotone revision control system.
2
3 I've just made a patch to the ikiwiki code that allows it to use the [[rcs/Monotone]] revision control system.  It is available at:
4
5 <http://www.cse.unsw.edu.au/~willu/monotone-ikiwiki.diff>
6
7 At the moment it is basically complete.  At present rcs_notify() is implemeted but untested, the rest is implemented and tested.
8
9 The current version of the patch handles conflicts through the web interface.  It is still not perfect as it will break if there is a rename that conflicts with a web change (but so will the other Rcs plugins I think).  It also commits a revision with conflict markers if there is a conflict requiring such markers... ick.
10
11 Note: This patch requires a rather recent Monotone perl module (18 August 2007 or later).  It is available from the monotone repository here: <http://viewmtn.angrygoats.net/branch/changes/net.venge.monotone>.
12
13 > The setup instructions to add 40 lines of code to monotonerc is pretty frightning stuff.
14 > Is there some way this can be automated? --[[Joey]]
15
16 >> I've committed a bunch of this to monotone so that in future it could be removed.
17 >> I've also just fixed this so it is in a separate, automagically generated, rc file.
18
19 >>> Fair enough. Didn't realize you were a monotone committer. :-)
20
21 >>>> I am, but still a little newish.  Feedback is good.  In particular, this is my first major bit of PERL.
22
23 > Having rcs_commit return a warning message when there's an unresolved conflict
24 > isn't right; that message will populate the page edit box. You might want
25 > to use the error() function here?
26
27 >> It should never reach that case, so I have changed that to error.
28
29 > There'an incomplete comment ending with "note, this relies on the fact that"
30
31 >> erg... sorry, fixed.
32
33 [[tag patch]]
34
35 >> I've [[accepted|done]] this patch, thank you! 
36
37 >>> Thanks for committing it.  I hate keeping my own diffs. :)
38
39 >> I did make a few changes. Please review, and make sure it still works
40 >> (a test case like we have for some of the other RCSes would be nice..)
41
42 >>> Tested.  It still works at least as well as it did.  I'll try to get to a test case soon.
43 >>> In checking the source I noticed a few bogus comments I left in when editing,
44 >>> and a bug in page adding.
45 >>> Here is a small patch for them:
46
47 >>>> applied
48
49 >> BTW, will all the monotone output parsing work if LANG != C?
50
51 >>> It should (he says crossing fingers).
52 >>> In the places where I do any complex parsing I'm using a special
53 >>> version of the mtn commands designed for scripting.  They have a
54 >>> stable, easy to parse, output that doesn't get translated (I think).
55
56 >> Do monotone post-commit hooks actually use REV?
57
58 >>> Monotone post-commit hooks are written in Lua and can do
59 >>> what they please.  Setting the REV environment var before
60 >>> calling Ikiwiki seems reasonable, but I've not written the
61 >>> Lua hook.
62
63 >>>> So the rcs_notify support is not just untested, but can't work
64 >>>> at all w/o further development.