git-svn bootstrap repository for freebsd-doc
What is this branch for?
This branch serves as a bootstrap for getting your own copy of a git-svn enabled mirror repository of FreeBSD "doc".
It will include all available branches and tags. You can refer to any commit on any branch using Git and see what revision it corresponds to.
Do not ever track this branch, it's just for one-time use and will often be force-updated to avoid bloat.
How much disk space do I need?
You'll need less than 500MB of disk space to have a git-svn clone of the FreeBSD doc repository.
How long does it take?
It highly depends on the bandwidth and disk performance, but in my case the whole process finished in approximately 45 minutes.
How to use
Take the following steps to get a git-svn working directory:
Clone this repository. The git URL is preferred to https if you want to save time as much as possible.
$ git clone git://github.com/idaemons/freebsd-doc.git
If you don't have outbound access to the git port (9418), use the https URL instead.
$ git clone https://github.com/idaemons/freebsd-doc.git
Go into the working directory and make sure you are on the
$ cd freebsd-doc $ git status # On branch git-svn nothing to commit, working directory clean
./run init. This sets up the repository for git-svn, extracting a snapshot of git-svn files and refs.
If you have a local mirror of the subversion repository:
$ ./run init --repository=file:///path/to/repository
If you are a non-committer:
$ ./run init --repository=svn://svn.freebsd.org/doc
If you are a committer:
$ ./run init
./run fetch. This simply runs
git-svn fetchto obtain the new commits since the snapshot was generated.
$ ./run fetch
$ ./run clean
Start hacking! Note that the
masterbranch is branched off from
origin/masterand is not set up to track any subversion branch with git-svn. To use commands like
git svn rebaseand
git svn dcommit, create a branch from one of the remote branches that start with
svn/and work in there.
$ git checkout -b trunk svn/trunk (..hack..) $ git svn rebase $ git svn dcommit
The script and this document are:
Copyright (c) 2013 Akinori MUSHA.
Licensed under the 2-clause BSD license. See
Visit GitHub Repository for the latest information.