README

README
======

This repository contains the meta-data used to convert the Scribus SVN
(svn://scribus.net) repository to Git.

The trunk and all branches and tags are imported from SVN into Git.

The SVN repository contains an additional folder "Scribus" at the
project root. This folder is skipped during conversion, so that the
programm sources appear in the repository root.

The git_repo_init.sh script configures an empty Git repository to
receive the SVN commits.

The update_from_svn.sh script pulls new commits from SVN, creates Git
tags from SVN tags and pushes the result to the configured "origin"
Git remote repository. (To congigure this origin Git remote repo, 
just do a "git remote add repo_name repo_url" in the shell).


How to set-up
-------------

1. create empty git repository
          git init <nice_name>
2. move into the git repository
          cd <nice_name>
3. initialize git svn
          ./path/to/git_repo_init.sh
4. configure remote Git server
          git remote add origin <URL/to/remote>
5. import svn into git
          ./path/to/update_from_svn.sh


Caveat
------

All SVN commiters need to be listed in svn_authors.txt. A missing
author will lead to an error:

    Author: <username> not defined in /path/to/svn_authors.txt file

In this case, add the new commiter to the svn_authors.txt file with
the following format:

    username = Full Name <email@address.xzy>

and re-run the import.

External references
===================

* github to svn and svn to github sync scripts using another git repo : http://zone.spip.org/trac/spip-zone/browser/_outils_/svn2git/trunk