Gitorious

73c1be6 by Nathan R. Yergler at 2009-07-21	1	===
	2	gsc
	3	===
	4
	5	:Author: Nathan R. Yergler <nathan@yergler.net>
	6	:Copyright:
	7	2009, Nathan R. Yergler;
	8	licensed to the public under a `BSD license
	9	<http://opensource.org/licenses/bsd-license.php>`_.
	10
	11	.. contents::
	12
	13	gsc is a utility for cloning Subversion repositories in git,
	14	including any ``svn:externals``.
	15
	16
	17	Installation
	18	============
	19
	20	gsc is written in Python and requires `setuptools`_. With
	21	``setuptools`` installed, you can checkout gsc and install it ::
	22
	23	$ git clone git://gitorious.org/gsc/mainline.git
	24	$ cd mainline
	25	$ python setup.py install
	26
	27	`setuptools` will installing pyparsing_ and GitPython_ if needed.
	28
	29
	30	Usage
	31	=====
	32
	33	Running ``gsc`` with ``-h`` will display the usage information.
	34
	35	To clone a Subversion project and all of its history into a git
	36	repository, run something like ::
	37
	38	$ gsc http://example.org/svnroot/project/trunk
	39
	40	If you'd like to clone the complete project, including branches and
	41	tags, specify the "standard" layout ::
	42
	43	$ gsc -s http://example.org/svnroot/project
	44
	45	Note that the path specified does not include the ``trunk``
	46	specifier.
	47
	48	.. warning::
	49
	50	``gsc`` currently only supports the "standard" Subversion
	51	layout (trunk/tags/branches as sibling paths).
	52
	53	If you're not interested in the full project history, you can clone
	54	the latest revision only ::
	55
	56	$ gsc --no-history http://example.org/svnroot/project/trunk
	57
	58
	59	.. _setuptools: http://pypi.python.org/pypi/setuptools
	60	.. _pyparsing: http://pypi.python.org/pypi/pyparsing
	61	.. _GitPython: http://pypi.python.org/pypi/GitPython