'\" t
.\"     Title: git-remote-bzr
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 10/15/2017
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "GIT\-REMOTE\-BZR" "1" "10/15/2017" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
git-remote-bzr \- bidirectional bridge between Git and Bazaar
.SH "SYNOPSIS"
.sp
.nf
\fIgit clone\fR bzr::<bzr repository>
.fi
.SH "DESCRIPTION"
.sp
This tool allows you to transparently clone, fetch and push to and from Bazaar repositories as if they were Git ones\&.
.sp
To use it you simply need to use the "\fIbzr::\fR" prefix when specifying a remote URL (e\&.g\&. when cloning)\&.
.SH "EXAMPLE"
.sp
.if n \{\
.RS 4
.\}
.nf
git clone bzr::lp:ubuntu/hello
.fi
.if n \{\
.RE
.\}
.SH "NOTES"
.sp
Remember to run git gc \-\-aggressive after cloning a repository, specially if it\(cqs a big one\&. Otherwise lots of space will be wasted\&.
.sp
The oldest version of Bazaar supported is 2\&.0\&. Older versions are not tested\&.
.SS "Branches vs\&. repositories"
.sp
Bazaar\(cqs UI can clone only branches, but a repository can contain multiple branches, and \fIgit\-remote\-bzr\fR can clone both\&.
.sp
For example, to clone a branch:
.sp
.if n \{\
.RS 4
.\}
.nf
git clone bzr::bzr://bzr\&.savannah\&.gnu\&.org/emacs/trunk emacs\-trunk
.fi
.if n \{\
.RE
.\}
.sp
And to clone the whole repository:
.sp
.if n \{\
.RS 4
.\}
.nf
git clone bzr::bzr://bzr\&.savannah\&.gnu\&.org/emacs emacs
.fi
.if n \{\
.RE
.\}
.sp
The second command would clone all the branches contained in the emacs repository, however, it\(cqs possible to specify only certain branches:
.sp
.if n \{\
.RS 4
.\}
.nf
git config remote\-bzr\&.branches \*(Aqtrunk, xwindow\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
Some remotes don\(cqt support listing the branches contained in the repository, in which cases you need to manually specify the branches, and while you can specify the configuration in the clone command, you might find this easier:
.sp
.if n \{\
.RS 4
.\}
.nf
git init emacs
git remote add origin bzr::bzr://bzr\&.savannah\&.gnu\&.org/emacs
git config remote\-bzr\&.branches \*(Aqtrunk, xwindow\*(Aq
git fetch
.fi
.if n \{\
.RE
.\}