[PATCH 0 of 2] document convert-repo interfaces

[Edouard Gomez]

On Sun, 20 May 2007 05:59:48 +0300, Giorgos Keramidas wrote:
> Another point which is important is that some projects with long-lived
> branches, and a clear plan of supporting backwards compatibility for
> their existing userbase may need the reverse too, i.e.:
> 
>    Once they switch to Hg, a 'gateway' between Hg commits and their old
>    CVS tree, which will be maintained for historical reasons.  Users who
>    depend on the existing CVS-based infrastructure, can continue to work
>    with the tools they find comfortable, but the cutting edge of
>    development has moved to Hg and happens there first.

Two way sync is a bit complicated but still feasible, see the bzr svn 
branches.

> The usage is also not so well documented.  I was literally scared away
> the first time I looked at convert-repo because of the lack of 'Average
> Joe User' documentation.  We don't need something too fancy, mind you.
> Just a manpage with usage examples would make things go a long way :)

One of my patches dump an help message at least :-)

But i'll put a manpage on my todo list.

I've put on my site an updated queue, have a look at it and don't 
hesitate giving feedback.
http://ed.gomez.free.fr/mercurial/convert-repo-queue.tar.bz2

Note that i tested the git and cvs backends, they work fine. I had a 
problem with the SVN backend on the rawstudio.org project:

I typed :
$ convert-repo -d https://rawstudio.org/svn/rawstudio rawstudio.hg

And the error dump:
branch:                  hg: bcb8ab45ad09 p1: f57a104eba2e
        Reverted MMX from revision 109.
Traceback (most recent call last):
  File "/data/opt/mercurial/bin/convert-repo", line 1307, in ?
    command(*args, **opts)
  File "/data/opt/mercurial/bin/convert-repo", line 1269, in command
    c.convert()
  File "/data/opt/mercurial/bin/convert-repo", line 1202, in convert
    self.copy(c)
  File "/data/opt/mercurial/bin/convert-repo", line 1167, in copy
    data = self.source.getfile(f, v)
  File "/data/opt/mercurial/bin/convert-repo", line 522, in getfile
    data, mode = self._getfile(file, rev)
  File "/data/opt/mercurial/bin/convert-repo", line 505, in _getfile
    info = svn.ra.get_file(self.ra, file, revnum, io)
  File "/var/lib/python-support/python2.4/libsvn/ra.py", line 392, in svn_ra_get_file
    return apply(_ra.svn_ra_get_file, args)
libsvn._core.SubversionException: ("PROPFIND request failed on '/svn/rawstudio/!svn/bc/114/trunk/src/gconf_interface.c'", 175007)

Any hint about the error ?

-- 
Edouard Gomez