[gaim-migrate @ 12996]

Added preliminary DBUS support to gaim, the details are described in
README.dbus.

1 files changed, 53 insertions, 0 deletions

diff --git a/README.dbus b/README.dbus
new file mode 100644
index 0000000000..199b3f5277
--- /dev/null
+++ b/README.dbus
@@ -0,0 +1,53 @@
+This file describes how to compile and run gaim with dbus support.
+Hopefully, most of the steps from point 3 will soon be automated.
+
+
+1. Make sure you have the latest version (0.34) of the dbus library
+   installed, including glib bindings.  
+
+   http://www.freedesktop.org/Software/dbus
+
+
+2. Compile gaim
+
+   ./configure --enable-dbus
+   make
+   make install
+
+
+3. Configure your dbus instalation for gaim
+
+   A. Find your dbus session configuration file, usually
+
+      /etc/dbus-1/session.conf
+
+   B. In that file, find the <servicedir> section.  This section
+      contains the directory that stores files describing services,
+      usually
+
+      /usr/share/dbus-1/services
+
+   C. Copy src/dbus-gaim.service to that directory
+
+   D. Edit the dbus-gaim.service file you've just copied, and replace
+      the path in the "Exec=" line with the path to your gaim
+      executable.
+
+
+4. Start DBUS if you haven't done it already
+
+   eval `dbus-launch --session`
+   export DBUS_SESSION_BUS_ADDRESS DBUS_SESSION_BUS_PID
+
+   These commands will set the two above shell variables.  These
+   variables must be set before running any dbus-aware programs.
+
+
+Now you can start gaim as usual.  A new program, gaim-client can be
+used to issue commands to a running gaim process
+
+   gaim-client command1 command2 ...
+
+At the moment there are only three commands: ping, quit, and connect.
+When you execute gaim-client, the dbus system will automatically start
+a gaim process if one is not running already.