# HG changeset patch
# User Goffi <goffi@goffi.org>
# Date 1371743067 -7200
# Node ID 190ccc6dc36c8f819a86ed4279b2be8f2bd9f94a
# Parent  5646ecd3e35ec6764ed888d889d6ab143337d545
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.

diff -r 5646ecd3e35e -r 190ccc6dc36c README
--- a/README	Thu Jun 20 17:22:40 2013 +0200
+++ b/README	Thu Jun 20 17:44:27 2013 +0200
@@ -63,6 +63,31 @@
 
 ** Misc **
 
+To use SàT, you need to have D-Bus daemon launched (http://www.freedesktop.org/wiki/Software/dbus/). If you use X Window, it should already be launched. If your are on a terminal environment without X11 (e.g. on a server) you may have to launch it. You can launch a daemon using the following command:
+$ eval `dbus-launch --sh-syntax`
+
+Be careful to use the same environment variables if you start a new session.
+
+I personnaly use the following script to do that automaticaly:
+
+--- /usr/local/bin/dbus-launch.sh ---
+#!/bin/sh
+
+DBUS_PATH="/tmp/.dbus.`whoami`"
+
+if [ ! -e $DBUS_PATH ]; then
+        dbus-launch --sh-syntax > $DBUS_PATH
+        chmod 400 $DBUS_PATH
+fi
+
+cat $DBUS_PATH
+--- end of /usr/local/bin/dbus-launch.sh ---
+
+You can launch this script by putting at the end of your .zshrc (or whatever you're using):
+eval `/usr/local/bin/dbus-launch.sh`
+
+--
+
 You can find Primitivus shortcuts on the wiki:
 http://wiki.goffi.org/wiki/Primitivus