README.markdown in svn2git-2.2.1 vs README.markdown in svn2git-2.2.2
- old
+ new
@@ -154,37 +154,41 @@
system with the list of conversions to make, one per line, for example:
jcoglan = James Coglan <jcoglan@never-you-mind.com>
stnick = Santa Claus <nicholas@lapland.com>
-Then pass an +authors+ option to +svn2git+ pointing to your file:
+Then pass an _authors_ option to svn2git pointing to your file:
$ svn2git http://svn.example.com/path/to/repo --authors ~/authors.txt
-Alternatively, you can place the authors file into ~/.svn2git/authors and
+Alternatively, you can place the authors file into `~/.svn2git/authors` and
svn2git will load it out of there. This allows you to build up one authors
file for all your projects and have it loaded for each repository that you
migrate.
If you need a jump start on figuring out what users made changes in your
svn repositories the following command sequence might help. It grabs all
the logs from the svn repository, pulls out all the names from the commits,
sorts them, and then reduces the list to only unique names. So, in the end
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
+redirect the output of this command sequence to `~/.svn2git/authors` and have
a very good starting point for your mapping.
- $ svn log | grep -E "r[0-9]+ \| .+ \|" | awk '{print $3}' | sort | uniq
+ $ svn log --quiet | grep -E "r[0-9]+ \| .+ \|" | awk '{print $3}' | sort | uniq
+Or, for a remote URL:
+
+ $ svn log --quiet http://path/to/root/of/project | grep -E "r[0-9]+ \| .+ \|" | awk '{print $3}' | sort | uniq
+
Debugging
---------
If you're having problems with converting your repository and you're not sure why,
try turning on verbose logging. This will print out more information from the
underlying git-svn process.
-You can turn on verbose logging with the '-v' or '--verbose' flags, like so:
+You can turn on verbose logging with the `-v` or `--verbose` flags, like so:
$ svn2git http://svn.yoursite.com/path/to/repo --verbose
FAQ
---