comparison README @ 161:47127255145c

Wrapped long lines in README.
author Martin Geisler <mg@daimi.au.dk>
date Tue, 30 Dec 2008 19:24:16 -0600
parents 04800fda7af5
children 71d170253a6f
comparison
equal deleted inserted replaced
160:7a5a0b5c8e34 161:47127255145c
1 -*-restructuredtext-*- 1 -*-restructuredtext-*-
2 2
3 About 3 About
4 ----- 4 -----
5 hgsubversion is an extension for Mercurial that allows using Mercurial as a 5 hgsubversion is an extension for Mercurial that allows using Mercurial
6 Subversion client. 6 as a Subversion client.
7 7
8 Right now it is *not* ready for production use. You should only be using this if 8 Right now it is *not* ready for production use. You should only be
9 you're ready to hack on it, and go diving into the internals of Mercurial and/or 9 using this if you're ready to hack on it, and go diving into the
10 Subversion. 10 internals of Mercurial and/or Subversion.
11 11
12 Installation 12 Installation
13 ------------ 13 ------------
14 You need to have Subversion installed with the SWIG Python bindings from Subversion 1.5 or later. 14 You need to have Subversion installed with the SWIG Python bindings
15 You need Mercurial 1.1.1 or later. 15 from Subversion 1.5 or later. You need Mercurial 1.1.1 or later.
16 16
17 .. _mercurial: http://selenic.com/repo/hg 17 .. _mercurial: http://selenic.com/repo/hg
18 .. _mercurial-stable: http://selenic.com/repo/hg-stable 18 .. _mercurial-stable: http://selenic.com/repo/hg-stable
19 .. _crew: http://hg.intevation.org/mercurial/crew 19 .. _crew: http://hg.intevation.org/mercurial/crew
20 .. _crew-stable: http://hg.intevation.org/mercurial/crew-stable 20 .. _crew-stable: http://hg.intevation.org/mercurial/crew-stable
21 21
22 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. 22 If you are unfamiliar with installing Mercurial extensions, please see
23 the UsingExtensions_ page in the Mercurial wiki. Look at the example
24 for specifying an absolute path near the bottom of the page. You want
25 to give the path to the top level of your clone of this repository.
23 26
24 .. _UsingExtensions: http://www.selenic.com/mercurial/wiki/index.cgi/UsingExtensions 27 .. _UsingExtensions: http://www.selenic.com/mercurial/wiki/index.cgi/
28 UsingExtensions
25 29
26 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. 30 Before using hgsubversion, I *strongly* encourage you to run the
31 automated tests. Just use nose_ if you have it (or ``easy_install
32 nose`` if you want it), or use ``python tests/run.py`` to run the
33 suite with the conventional test runner. Note that because I use nose,
34 there's a lot of stdout spew in the tests right now. The important
35 part is that all the tests pass.
27 36
28 .. _nose: http://code.google.com/p/python-nose/ 37 .. _nose: http://code.google.com/p/python-nose/
29 38
30 Basic Use 39 Basic Use
31 ----------- 40 -----------
35 44
36 Real example:: 45 Real example::
37 46
38 $ hg svnclone http://python-nose.googlecode.com/svn nose-hg 47 $ hg svnclone http://python-nose.googlecode.com/svn nose-hg
39 48
40 Note, you should pull from the root subversion directory, not specific folders (such as trunk). 49 Note, you should pull from the root subversion directory, not specific
50 folders (such as trunk).
41 51
42 Pull new revisions into an already-converted repo:: 52 Pull new revisions into an already-converted repo::
43 53
44 $ hg svn pull 54 $ hg svn pull
45 55
46 For more information, see 'hg help svn' while in a converted repo. 56 For more information, see 'hg help svn' while in a converted repo.
47
48