README
======
git-me-up was written to automate the creation of a local git repo for a Rails
app that is hosted in Subversion. It should work equally well for non Rails
projects.
In a nutshell, this is what it does:
- Clones the latest version of the source (by default skipping the history
for performance reasons) into a new local Git repository.
- Recreates empty directories (that git chooses to ignore), but that your
app might need.
- Converts any svn:ignore Subversion properties into entries in your
.git/info/exclude file.
- Checks for Rails plugins installed via svn:externals and clones them into
their own git repositories (located in a new directory called ./plugins,
relative to your working directory). Each external plugin is symlinked
into vendor/plugins. Git is then instructed to ignore them so that it
doesn't attempt to commit the symlink back into Subversion.
- Creates a local working branch (called "work" by default; override it by
setting the BRANCH environement variable).
All this happens in a manner that avoids adding Git metadata (such as
.gitignore files) to your subversion repository.
INSTALL
=======
To install git-me-up into /usr/local/bin, run:
$ sudo make install
You will need to install git-svn before you can use git-me-up.
USAGE
=====
You need to specify two arguments; the Subversion repo that you will be
checking back into, and the path (relative to your current directory) of the
Git repository that you'd like to create.
For example:
$ git-me-up http://svn.mydomain.com/repo/project/trunk project
By default git-me-up will pull the latest version of your code from
Subversion, ignoring all the history. If you want to override the revision
pulled, set the REVISION environment variable, like this:
$ REVISION=123:HEAD http://svn.mydomain.com/repo/project/trunk project
See the coverage of the -r option in the git-svn(1) man page for more examples
of how to specify the revision.
Give it a whirl. If you don't like it, delete your local directory. No harm
done...
) is private.
