2009-04-28 04:11:00 +04:00
|
|
|
.. -*-restructuredtext-*-
|
2008-10-01 17:58:56 +04:00
|
|
|
|
2009-01-22 05:38:10 +03:00
|
|
|
============
|
|
|
|
hgsubversion
|
|
|
|
============
|
|
|
|
|
2008-12-31 04:24:16 +03:00
|
|
|
hgsubversion is an extension for Mercurial that allows using Mercurial
|
|
|
|
as a Subversion client.
|
2008-09-30 20:42:52 +04:00
|
|
|
|
2010-01-11 01:03:12 +03:00
|
|
|
At this point, hgsubversion is usable by users reasonably familiar with
|
|
|
|
Mercurial as a VCS. It's not recommended to dive into hgsubversion as an
|
|
|
|
introduction to Mercurial, since hgsubversion "bends the rules" a little
|
|
|
|
and violates some of the typical assumptions of early Mercurial users.
|
2008-10-01 03:01:35 +04:00
|
|
|
|
2008-10-01 19:35:36 +04:00
|
|
|
Installation
|
|
|
|
------------
|
2010-08-11 22:03:26 +04:00
|
|
|
You need to have either have Subversion 1.5 (or later) installed along with
|
2010-10-09 19:16:07 +04:00
|
|
|
either Subvertpy 0.7.4 (or later) or the Subversion SWIG Python bindings. You
|
2013-08-05 22:49:53 +04:00
|
|
|
need Mercurial 2.0 or later.
|
2008-10-01 19:35:36 +04:00
|
|
|
|
2018-01-03 22:51:20 +03:00
|
|
|
.. _mercurial: http://mercurial-scm.org/repo/hg
|
|
|
|
.. _mercurial-stable: http://mercurial-scm.org/repo/hg-stable
|
2008-10-01 19:35:36 +04:00
|
|
|
.. _crew: http://hg.intevation.org/mercurial/crew
|
|
|
|
.. _crew-stable: http://hg.intevation.org/mercurial/crew-stable
|
|
|
|
|
2008-12-31 04:24:16 +03:00
|
|
|
If you are unfamiliar with installing Mercurial extensions, please see
|
|
|
|
the UsingExtensions_ page in the Mercurial wiki. Look at the example
|
|
|
|
for specifying an absolute path near the bottom of the page. You want
|
|
|
|
to give the path to the top level of your clone of this repository.
|
2008-10-01 19:35:36 +04:00
|
|
|
|
2018-01-03 22:51:20 +03:00
|
|
|
.. _UsingExtensions: http://mercurial-scm.org/wiki/UsingExtensions
|
2008-10-01 19:35:36 +04:00
|
|
|
|
2008-12-31 04:24:16 +03:00
|
|
|
Before using hgsubversion, I *strongly* encourage you to run the
|
|
|
|
automated tests. Just use nose_ if you have it (or ``easy_install
|
|
|
|
nose`` if you want it), or use ``python tests/run.py`` to run the
|
|
|
|
suite with the conventional test runner. Note that because I use nose,
|
|
|
|
there's a lot of stdout spew in the tests right now. The important
|
|
|
|
part is that all the tests pass.
|
2008-10-14 18:13:15 +04:00
|
|
|
|
|
|
|
.. _nose: http://code.google.com/p/python-nose/
|
|
|
|
|
2010-08-11 22:03:26 +04:00
|
|
|
You can check that hgsubversion is installed and properly activated using the
|
|
|
|
following command::
|
|
|
|
|
|
|
|
$ hg version --svn
|
|
|
|
Mercurial Distributed SCM (version ...)
|
|
|
|
|
|
|
|
Copyright (C) 2005-2010 Matt Mackall <mpm@selenic.com> and others
|
|
|
|
This is free software; see the source for copying conditions. There is NO
|
|
|
|
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
|
|
|
|
|
|
hgsubversion: ...
|
|
|
|
Subversion: ...
|
|
|
|
bindings: Subvertpy ...
|
|
|
|
|
|
|
|
If your bindings are listed as `SWIG`, please consider installing Subvertpy_.
|
|
|
|
|
|
|
|
.. _Subvertpy: http://pypi.python.org/pypi/subvertpy
|
|
|
|
|
2010-08-11 21:57:34 +04:00
|
|
|
Further Reading
|
|
|
|
---------------
|
2008-10-01 17:58:56 +04:00
|
|
|
|
2010-08-11 21:57:34 +04:00
|
|
|
More information on how to use hgsubversion is available from within Mercurial
|
|
|
|
in the `subversion` help topic. To view it, use::
|
2008-10-01 17:58:56 +04:00
|
|
|
|
2010-08-11 21:57:34 +04:00
|
|
|
$ hg help subversion
|
2008-10-01 17:58:56 +04:00
|
|
|
|
2010-08-11 21:57:34 +04:00
|
|
|
The Restructured Text source for this topic is also available in the file
|
|
|
|
``hgsubverson/help/subversion.rst``.
|