bzr-explorer: GUI application for using Bazaar
==============================================

Dependencies
------------

Required packages are:

* Python 2.4 or later
* Bzr 2.3 or later.
* QBzr 0.19 or later (0.22 is recommended).
* PyQt4/Qt4 version 4.4 or later.

If you wish to use the applets provided via bzr-gtk, it should be
installed as well.

Optional dependencies:

* send2trash library (http://pypi.python.org/pypi/Send2Trash/).
  Modified copy of this library bundled with bzr-explorer (thirdparty/).


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

The easiest way to install this plugin is to either copy or symlink the
directory into your ~/.bazaar/plugins directory. Be sure to rename the
directory to explorer (instead of bzr-explorer).

In the future, it is hoped this plugin will be installed by the various
platform-specific installers for Windows and OS X. For Linux, it is
hoped that it will be made available via the usual package management
systems, include Add/Remove on Ubuntu.


Testing
-------

To test the plugin after installation:

    bzr selftest explorer
 

Documentation
-------------

To view the documentation after installation:

    bzr help explorer
 
A User Guide available at 
http://doc.bazaar.canonical.com/explorer/en/index.html.


Changing language of user interface
-----------------------------------

Bazaar Explorer GUI translated into many languages, 
and it tries to use system settings to show you localized messages.

But in some cases you may prefer to see messages in different
language (e.g. in English only). To change default language of the GUI 
via Bazaar Explorer menu:

  Tools -> Options -> Appearance -> User Interface -> Language.

Bazaar Explorer should be restarted to apply new language settings.

Language settings stored in DEFAULT section of bazaar.conf 
as ``language = code``. Language codes are the same as for LANG environment
variable. Environment variable LANGUAGE still preferred over settings
in bazaar.conf.


Developers
----------

If you'd like to help, see the ROADMAP.txt file in the doc directory.


Licensing
---------

This plugin is (C) Copyright Canonical Limited 2009 under the
GPL Version 2 or later. Please see the file COPYING.txt for the licence
details.
