Rendering of reStructured text is not possible, please install Docutils.
bzr-gtk is a plugin for Bazaar that aims to provide GTK+ interfaces to most Bazaar operations.
It will also integrate with the GNOME desktop environment, if GNOME python bindings are found.
Provided user interfaces
========================
* NautilusIntegration_
Releases
========
* 0.103.0_ (works with bzr >= 2.1, <= 2.5)
* 0.100.0_ (works with bzr >= 2.0, <= 2.4)
* 0.99.0_ (works with bzr >= 2.0)
* 0.98.0_ (works with bzr >= 2.0)
* 0.97.0_ (works with bzr >= 1.17)
* 0.96.2_ (works with bzr >= 1.17)
* 0.96.1_ (works with bzr >= 1.16)
* 0.95.0_ (works with bzr >= 1.6)
* 0.94.0_ (works with bzr >= 1.0)
* `0.93.0 (Launchpad)`_, `0.93.0 (mirror)`_ (works with bzr 1.0)
* `0.92.1 (Launchpad)`_, `0.92.1 (mirror)`_ (works with bzr 0.92.x)
* `0.92.0 (Launchpad)`_, `0.92.0 (mirror)`_ (works with bzr 0.92.x)
* `0.91.0 (Launchpad)`_, `0.91.0 (mirror)`_ (works with bzr 0.91.x)
* 0.90.0_ (works with bzr 0.90.x)
* 0.18.0_ (works with bzr 0.18.x)
* 0.17.0_ (works with bzr 0.17.x)
* 0.16.0_ (works with bzr 0.16.x)
* 0.15.2_ (works with bzr 0.15.x)
* 0.15.1_ (works with bzr 0.15.x)
* 0.15.0_ (works with bzr 0.15.x)
* 0.14.0_ (works with bzr 0.14.x)
* 0.13.0_ (works with bzr 0.13.x)
* 0.12.0_ (works with bzr 0.12.x)
* 0.11.0_ (works with bzr 0.11.x)
* 0.10.0_ (works with bzr 0.10.x)
* 0.9.0_ (works with bzr 0.9.x)
.. _0.9.0: http://samba.org/~jelmer/bzr/bzr-gtk-0.9.0.tar.gz
.. _0.10.0: http://samba.org/~jelmer/bzr/bzr-gtk-0.10.0.tar.gz
.. _0.11.0: http://samba.org/~jelmer/bzr/bzr-gtk-0.11.0.tar.gz
.. _0.12.0: http://samba.org/~jelmer/bzr/bzr-gtk-0.12.0.tar.gz
.. _0.13.0: http://samba.org/~jelmer/bzr/bzr-gtk-0.13.0.tar.gz
.. _0.14.0: http://samba.org/~jelmer/bzr/bzr-gtk-0.14.0.tar.gz
.. _0.15.0: http://samba.org/~jelmer/bzr/bzr-gtk-0.15.0.tar.gz
.. _0.15.1: http://samba.org/~jelmer/bzr/bzr-gtk-0.15.1.tar.gz
.. _0.15.2: http://samba.org/~jelmer/bzr/bzr-gtk-0.15.2.tar.gz
.. _0.16.0: http://samba.org/~jelmer/bzr/bzr-gtk-0.16.0.tar.gz
.. _0.17.0: http://samba.org/~jelmer/bzr/bzr-gtk-0.17.0.tar.gz
.. _0.18.0: http://samba.org/~jelmer/bzr/bzr-gtk-0.18.0.tar.gz
.. _0.90.0: http://samba.org/~jelmer/bzr/bzr-gtk-0.90.0.tar.gz
.. _0.91.0 (Launchpad): https://launchpad.net/bzr-gtk/0.91/0.91.0/+download/bzr-gtk-0.91.0.tar.gz
.. _0.91.0 (mirror): http://phanatic.hu/bzr-gtk/bzr-gtk-0.91.0.tar.gz
.. _0.92.0 (Launchpad): https://launchpad.net/bzr-gtk/0.92/0.92.0/+download/bzr-gtk-0.92.0.tar.gz
.. _0.92.0 (mirror): http://phanatic.hu/bzr-gtk/bzr-gtk-0.92.0.tar.gz
.. _0.92.1 (Launchpad): https://launchpad.net/bzr-gtk/0.92/0.92.1/+download/bzr-gtk-0.92.1.tar.gz
.. _0.92.1 (mirror): http://phanatic.hu/bzr-gtk/bzr-gtk-0.92.1.tar.gz
.. _0.93.0 (Launchpad): https://launchpad.net/bzr-gtk/0.93/0.93.0/+download/bzr-gtk-0.93.0.tar.gz
.. _0.93.0 (mirror): http://phanatic.hu/bzr-gtk/bzr-gtk-0.93.0.tar.gz
.. _0.94.0: http://samba.org/~jelmer/bzr/bzr-gtk-0.94.0.tar.gz
.. _0.95.0: http://samba.org/~jelmer/bzr/bzr-gtk-0.95.0.tar.gz
.. _0.96.0: http://launchpad.net/bzr-gtk/trunk/0.96.0/+download/bzr-gtk-0.96.0.tar.gz
.. _0.96.1: http://launchpad.net/bzr-gtk/trunk/0.96.1/+download/bzr-gtk-0.96.1.tar.gz
.. _0.96.2: http://launchpad.net/bzr-gtk/trunk/0.96.2/+download/bzr-gtk-0.96.2.tar.gz
.. _0.97.0: http://launchpad.net/bzr-gtk/trunk/0.97.0/+download/bzr-gtk-0.97.0.tar.gz
.. _0.98.0: http://launchpad.net/bzr-gtk/trunk/0.98.0/+download/bzr-gtk-0.98.0.tar.gz
.. _0.99.0: http://launchpad.net/bzr-gtk/trunk/0.99.0/+download/bzr-gtk-0.99.0.tar.gz
.. _0.100.0: http://launchpad.net/bzr-gtk/trunk/0.100.0/+download/bzr-gtk-0.100.0.tar.gz
.. _0.103.0: http://launchpad.net/bzr-gtk/trunk/0.103.0/+download/bzr-gtk-0.103.0.tar.gz
Debian Packages
===============
Ubuntu/Debian packages are available from the Bazaar Debian repository. See DistroDownloads for details. These packages are not uploaded as part of the bzr-gtk release process, so they may be one or two releases behind.
These packages are also uploaded to the official Debian and Ubuntu repositories.
Fedora or EPEL Packages
=======================
RPMS are available in Fedora or EPEL::
# yum install bzr-gtk
Gentoo Package
==============
Ebuild request submitted, see `Gentoo bug 154959`_.
.. _Gentoo bug 145959: http://bugs.gentoo.org/show_bug.cgi?id=154959
There is also an ebuild in an unofficial bzr-related overlay on Launchpad: https://launchpad.net/bzr-gentoo-overlay
Mac OS X - MacPorts
===================
bzr-gtk can be installed using MacPorts::
$ sudo port install bzr-gtk
Windows
=======
Windows packages by Kevin Light can be found at http://d5190871.u44.websitesource.net/bzr-gtk/
FreeBSD
=======
bzr-gtk can be installed using portmaster::
$ portmaster devel/bzr-gtk
or::
$ cd /usr/ports/devel/bzr-gtk
$ make install clean
Manual installation
===================
You can use the setup script provided with the tarball::
# ./setup.py install
or::
$ sudo ./setup.py install
Getting and installing the latest code::
$ bzr branch http://bazaar.launchpad.net/~bzr-gtk/bzr-gtk/trunk ~/.bazaar/plugins/gtk
Mailing list
============
There is a mailing list for bzr-gtk. Details can be found at
https://lists.ubuntu.com/mailman/listinfo/bzr-gtk
Please send merge requests to this mailing list. If you are running a recent enough version of Bazaar, it should be possible to just run::
$ bzr send lp:bzr-gtk
from your branch to send a merge request.
This should open a new e-mail message in your mail-client with a feature-revno.patch file attached and '[MERGE] my latest commit message' as subject. If this is not fully the case, you could try to set the 'mail_client = ' variable in ~/.bazaar/bazaar.conf (see http://doc.bazaar-vcs.org/bzr.dev/en/user-reference/bzr_man.html for details).
It is possible to send email to the list without being subscribed but please allow us a few days
to moderate your message. Please mention if you are not on the list so we can make sure to CC you on
any feedback.
Giving back
===========
When you see a way to improve bzr-gtk, you can follow these steps to get your contribution back to the developers as easy as possible.
Create a repository for bzr-gtk and download the current development tree::
$ bzr init-repo bzr-gtk
$ cd bzr-gtk
bzr-gtk$ bzr branch https://code.launchpad.net/~bzr-gtk/bzr-gtk/trunk trunk
The folder bzr-gtk/trunk now holds a local copy of the current development tree. When you have an idea for an improvement of the code::
bzr-gtk/trunk$ bzr pull
bzr-gtk$ bzr branch trunk feature
and implement that improvement in the feature branch. Since this is your local, personal branch you can commit whenever you like. Testing the code is easiest by creating a symlink to it in your user's ``.bazaar/plugins`` directory::
~/.bazaar/plugins$ ln -s /path/to/bzr-gtk/feature/ gtk
When you have a working feature, we would very much like to receive it. Therefor you should make a bundle of the changes and send that bundle to the bzr-gtk mailing list (see above).
Screenshots
===========
* `Commit window <http://samba.org/~jelmer/bzr/gcommit.png>`_
* `Branch window <http://samba.org/~jelmer/bzr/gbranch.png>`_
* `Log Window <http://samba.org/~jelmer/bzr/bzrk.png>`_
* `diff window screenshot <http://samba.org/~jelmer/bzr/bzrk-diff.png>`_
* `Nautilus integration screenshot 1 <http://samba.org/~jelmer/bzr/nautilus-bzr1.png>`_
* `Nautilus integration screenshot 2 <http://samba.org/~jelmer/bzr/nautilus-bzr2.png>`_
Launchpad: http://launchpad.net/products/bzr-gtk
