view README @ 16:48a44546c12f

Add a basic system for running the hgsubversion tests (although not the svnwrap ones) without requiring Nose. Nose is still the recommended way to run the tests. Also added some tests for pushing.
author Augie Fackler <durin42@gmail.com>
date Tue, 07 Oct 2008 22:13:14 -0500
parents 0548662e2f34
children 5954a514ae26
line wrap: on
line source

-*-restructuredtext-*-

About
-----
hgsubversion is an extension for Mercurial that allows using Mercurial as a 
Subversion client.

Right now it is *not* ready for production use. You should only be using this if 
you're ready to hack on it, and go diving into the internals of Mercurial and/or 
Subversion.

Installation
------------
You need to have Subversion installed with the SWIG Python bindings.
You need a recent Mercurial. At present, the required memctx code is in mercurial_, crew_, and crew-stable_, but not mercurial-stable. Install Mercurial from one of mercurial or the crew repos if you have not already. Personally, I use crew_.

.. _mercurial: http://selenic.com/repo/hg
.. _crew: http://hg.intevation.org/mercurial/crew
.. _crew-stable: http://hg.intevation.org/mercurial/crew-stable

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.

.. _UsingExtensions: http://www.selenic.com/mercurial/wiki/index.cgi/UsingExtensions

Basic Use
-----------
Get a new clone of an svn server::

 $ hg svnclone <svn URI> [destination]

Real example::

 $ hg svnclone http://python-nose.googlecode.com/svn nose-hg

Pull new revisions into an already-converted repo::

 $ hg svn pull

For more information, see 'hg svn help' while in a converted repo.