README

git-bzr: a bidirectional git - bazaar gateway
=============================================

This script allows you to add bazaar repositories as git branches in your
git repository. After that, you can fetch the Bazaar repo, make some
changes, and push it back into Bazaar.

Usage
-----

An example session goes like this:

  $ git init
  $ git-bzr add upstream ../bzr-branch
  $ git-bzr fetch upstream
  $ git checkout -b local_branch upstream
  $ Hack hack, merge merge....
  $ git-bzr push upstream

bzr URLs
--------

Note that a bzr URL corresponds to a single bzr branch, and is represented in
git as a single branch in your repository.

The URL passed to "git-bzr add" can be any valid bzr URL, such as:

  * A local filesystem reference
        git-bzr add upstream ../bzr-branch
  * A remote bzr repository: 
        git-bzr add mega-nerd http://www.mega-nerd.com/Bzr/libsndfile-dev/
  * A Launchpad URL:
	git-bzr add upstream lp:inkscape


Installation
------------

You need a new Git (v 1.6.0 or higher).

Furthermore, you need the Bazaar fastimport plugin. It can be found at
https://launchpad.net/bzr-fastimport; to fetch it, run:

  $ bzr branch lp:bzr-fastimport

Finally, you need to install the git-bzr script somewhere.

License
-------

The git-bzr script is licensed under the same license as Git.


SEE ALSO
========

The following are rewrites in Python and may offer better bzr integration:

  * http://github.com/termie/git-bzr-ng

  * http://github.com/matthew-brett/git-bzr