README - mainline in gsc

===
gsc
===

:Author: Nathan R. Yergler <nathan@yergler.net>
:Copyright: 
   2009, Nathan R. Yergler;
   licensed to the public under a `BSD license 
   <http://opensource.org/licenses/bsd-license.php>`_.

.. contents::

*gsc* is a utility for cloning Subversion repositories in git,
including any ``svn:externals``.


Installation
============

*gsc* is written in Python and requires `setuptools`_.  With
``setuptools`` installed, you can checkout gsc and install it ::

  $ git clone git://gitorious.org/gsc/mainline.git
  $ cd mainline
  $ python setup.py install

`setuptools` will installing pyparsing_ and GitPython_ if needed.


Usage
=====

Running ``gsc`` with ``-h`` will display the usage information.

To clone a Subversion project and all of its history into a git
repository, run something like ::

  $ gsc http://example.org/svnroot/project/trunk

If you'd like to clone the complete project, including branches and
tags, specify the "standard" layout ::

  $ gsc -s http://example.org/svnroot/project

Note that the path specified does not include the ``trunk``
specifier.  

.. warning::

   ``gsc`` currently only supports the "standard" Subversion
   layout (trunk/tags/branches as sibling paths).

If you're not interested in the full project history, you can clone
the latest revision only ::

  $ gsc --no-history http://example.org/svnroot/project/trunk


.. _setuptools: http://pypi.python.org/pypi/setuptools
.. _pyparsing: http://pypi.python.org/pypi/pyparsing
.. _GitPython: http://pypi.python.org/pypi/GitPython

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

Gitorious