README.markdown in svn2git-2.3.2 vs README.markdown in svn2git-2.4.0
- old
+ new
@@ -64,11 +64,11 @@
Installation
------------
Make sure you have git, git-svn, and ruby installed. svn2git is a ruby wrapper around git's native SVN support through git-svn. It is possible to have git installed without git-svn installed, so please do verify that you can run `$ git svn` successfully. For a Debian-based system, the installation of the prerequisites would look like:
- $ sudo apt-get install git-core git-svn ruby rubygems
+ $ sudo apt-get install git-core git-svn ruby
Once you have the necessary software on your system, you can install svn2git through rubygems, which will add the `svn2git` command to your PATH.
$ sudo gem install svn2git
@@ -116,10 +116,14 @@
7. The svn repo is password protected.
$ svn2git http://svn.example.com/path/to/repo --username <<user_with_perms>>
+If this doesn't cooperate and you need to specify a password on the command-line:
+
+ $ svn2git http://svn.example.com/path/to/repo --username <<user_with_perms>> --password <<password>>
+
8. You need to migrate starting at a specific svn revision number.
$ svn2git http://svn.example.com/path/to/repo --revision <<starting_revision_number>>
9. You need to migrate starting at a specific svn revision number, ending at a specific revision number.
@@ -174,15 +178,15 @@
it outputs a list of usernames of the people that made commits to the svn
repository which name on its own line. This would allow you to easily
redirect the output of this command sequence to `~/.svn2git/authors` and have
a very good starting point for your mapping.
- $ svn log --quiet | grep -E "r[0-9]+ \| .+ \|" | cut -d'|' -f2 | sed 's/^ //' | sort | uniq
+ $ svn log --quiet | grep -E "r[0-9]+ \| .+ \|" | cut -d'|' -f2 | sed 's/ //g' | sort | uniq
Or, for a remote URL:
- $ svn log --quiet http://path/to/root/of/project | grep -E "r[0-9]+ \| .+ \|" | cut -d'|' -f2 | sed 's/^ //' | sort | uniq
+ $ svn log --quiet http://path/to/root/of/project | grep -E "r[0-9]+ \| .+ \|" | cut -d'|' -f2 | sed 's/ //g' | sort | uniq
Debugging
---------
If you're having problems with converting your repository and you're not sure why,
@@ -200,12 +204,13 @@
Usage: svn2git SVN_URL [options]
Specific options:
--rebase Instead of cloning a new project, rebase an existing one against SVN
--username NAME Username for transports that needs it (http(s), svn)
+ --password PASS Password for transports that needs it (http(s), svn)
--trunk TRUNK_PATH Subpath to trunk from repository URL (default: trunk)
- --branches BRANCHES_PATH Subpath to branches from repository URL (default: branches)
- --tags TAGS_PATH Subpath to tags from repository URL (default: tags)
+ --branches BRANCHES_PATH Subpath to branches from repository URL (default: branches); can be used multiple times
+ --tags TAGS_PATH Subpath to tags from repository URL (default: tags); can be used multiple times
--rootistrunk Use this if the root level of the repo is equivalent to the trunk and there are no tags or branches
--notrunk Do not import anything from trunk
--nobranches Do not try to import any branches
--notags Do not try to import any tags
--no-minimize-url Accept URLs as-is without attempting to connect to a higher level directory