NAME¶
svn-all-fast-export - tool to convert svn repositories into git
SYNOPSIS¶
svn-all-fast-export [
options]
[
Path to subversion repository]
DESCRIPTION¶
svn-all-fast-export is a tool to convert your svn repositories to git.
You will need to have a copy of your svn repository and to write some rules to
specify how the conversion will be done, for instance, you can manage how the
tags and branches will be managed writing the appropriate rules. You have
examples in /usr/share/doc/svn-all-fast-export/samples
Path to subversion repository is a backup copy of the subversion
repository. Note that an svn url will not work due to the undistributed nature
of svn.
OPTIONS¶
- --identity-map
- Provide map between svn username and email. You can provide
a file mapping the old svn accounts to the authors names. This file must
have a line per each svn account, you can use either the
svn-all-fast-export native format:
janesvnaccountname Jane Doe <jane.doe@example.com>
or the git-svn format:
janesvnaccountname = Jane Doe <jane.doe@example.com>
- --revisions-file
- Provide a file with revisions numbers that should be
processed. This file should have one revision number per line.
- --rules
- The rules file that determines what goes where. See
/usr/share/doc/svn-all-fast-export/samples
- --add-metadata
- If passed, each git commit will have svn commit info.
- --resume-from
- Start importing at svn revision number.
- --max-rev
- Stop importing at svn revision number.
- --dry-run
- Don't actually write anything.
- --debug-rules
- Print what rule is being used for each file.
- --commit-interval number
- If passed the cache will be flushed to git every
number of commits.
- --stats
- After a run, print some statistics.
- --svn-branches
- Use the content of SVN when creating branches, Note: SVN
tags are branches as well.
- -h, --help
- Show summary of options.
- -v, --version
- Show version of program.
RETURN VALUES¶
This program returns 0 on success, on error something else (numbers in base 10):
10 unrecognized option or missing argument
11 no rules file specified
BUGS¶
All matching rules need to end with a '/', else the tool will crash at some
point. The only exception are the rules using the recurse-action.
HOMEPAGE¶
http://gitorious.org/svn2git
SEE ALSO¶
http://techbase.kde.org/Projects/MoveToGit/UsingSvn2Git
AUTHORS¶
svn-all-fast-export was written by Thiago Macieira and Thomas Zander.
