bzr-dbus: dbus support for bzr/bzrlib
-------------------------------------

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

Please see TODO for future plans.

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

bzr-dbus depends on python-dbus 0.82.4 or newer.

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

To install the plugin there are three steps, and they vary if you are installing
into your home directory or system wide.
For per user installs:
 1. Symlink the plugin directory to ~/.bazaar/plugins/dbus.
 2. Copy the org.bazaarvcs.plugins.dbus.Broadcast.service file to
    ~/.local/share/dbus-1/services/. This directory probably does not exist, so
    you will want to do ``mkdir -p ~/.local/share/dbus-1/services/``.
 3. kill -HUP your dbus session daemon. You can find it via ps, look for a
    process that looks like 
    ``/usr/bin/dbus-daemon --fork --print-pid 4 --print-address 8 --session``.
    Alternatively you can log out and back into your user session.
For system wide installs:
 1. Run setup.py install with whatever options make sense on your platform.
 2. kill -HUP your dbus session daemon. You can find it via ps, look for a
    process that looks like ``/usr/bin/dbus-daemon --system``. Alternatively
    you can restart your system.

 If you did not install to the default directory with setup.py, you may have to 
 copy the org.bazaarvcs.plugins.dbus.Broadcast.service file to
 /usr/share/dbus-1/services/ manually.

What next?
----------

Use ``bzr help dbus`` to access the online help for the dbus plugin.
