wiki:HowToMaintainGrassWorkflowUsingGit

Version 8 (modified by martinl, 13 years ago) ( diff )

--

This article describes how to maintain GRASS development workflow with Git against GRASS Subversion repository.

Text of this article is mainly inspired by Using Git to maintain GDAL workflow.

Git repository setup

First, initialize local Git repository for copy of trunk from Subversion repository:

git svn init --trunk https://svn.osgeo.org/grass/grass/trunk

The option --trunk explicitly specifies intention of this operation.

It is also possible to copy complete repository, including trunk, branches and tags modules. Learn about --stdlayout option dedicated for this purpose. However, note that this initial fetch is a time consuming process (fetching of SVN trunk takes nearly two hours).

Next, fetch complete copy of GRASS trunk:

git svn --authors-file=/path/to/grass-git-authors.txt fetch

The file grass-git-authors.txt (attached) is used by Git to translate names of SVN committers to Git names which uses format "Full name <e-mail>". Specifying the --authors-file option is optional, but recommended.

It may be a good idea to compress Git repository in order to save some space. For example, SVN trunk occupies nearly 230 MB of disk space. Git can compress it to about 90 MB. Git provides a dedicated command for this purpose git-gc:

$ git gc

You can bring your local Git repository up to date against GRASS trunk any time.

$ git svn --authors-file=/path/to/gdal-git-authors.txt rebase

The rebase command is equivalent to svn update. Learn more about rebase in git-svn manual.

Resources

Note: See TracWiki for help on using the wiki.