Switch to a BSD 2 clause license
[git2svn.git] / README
blob217dd633b1ba525b793e10ed018e4bc72c18dbf2
1 NAME
2     git2svn - converts a git branch to a svn ditto
4 SYNOPSIS
5     git2svn [options] git-repro svn-repro
7 OPTIONS
8     --git-branch
9             The git branch to export. The default is branch is master.
11     --svn-prefix
12             The svn prefix where the branch is import. The default is trunk
13             to match the default GIT branch (master).
15     --no-load
16             Don't load the svn repository or update the syncpoint tagname.
18     --keep-logs
19             Don't delete the logs in $CWD/.data on success.
21     --verbose
22             More verbose output, can be give more then once to increase the
23             verbosity.
25     --help  Print a brief help message and exits.
27 DESCRIPTION
28     git2svn will convert a git branch to a svn ditto, it also support
29     incremantal updates.
31     git2svn takes a git fast-export dump and converts it into a svn dump
32     that is feed into svnadmin load.
34     git2svn assumes its the only process that writes into the svn
35     repository. This is because of the race between getting the to svn
36     Revsion number from the svn, creating the dump with correct Revsions,
37     and do the svnadmin load.
39     git2svn also support incremental updates from a git branch to a svn
40     reprositry. Its does this by setting a git tag
41     (git2svn-syncpoint-<branchname>) where the last update was pulled from.
43     git2svn was created as a hack over a weekend to support a smoother
44     migration away from svn and allow users access to tools to browse and
45     search code (fisheye) and use anonymouns svn servers.
47 EXAMPLES
48             B<git2svn> ~/src/heimdal svn-repro
50             B<git2svn> --git-branch heimdal-1-0-branch \
51                  --svn-prefix branches/heimdal-1-0-branch \
52                  ~/src/heimdal svn-repro
54 DOWNLOAD
55     git2svn is avaible from repo.or.cz
57             git clone git://repo.or.cz/git2svn.git
59 AUTHORS
60             Love Hörnquist Ã…strand <lha@kth.se>
62 BUGS
63             Send bug reports to lha@kth.se