diff options
author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2012-02-10 10:10:12 +0000 |
---|---|---|
committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2012-02-10 10:10:17 +0000 |
commit | 349260f245d95a6c8bcc0f000be1f3232c616052 (patch) | |
tree | 7f09107d249c4519ae1b0a49e7d7d37d08a5b72c /doc | |
parent | 818e62f15f30f284f4cfddf5725972975b97ce52 (diff) | |
parent | 6b01c6cdfdaae6d6847c5f5f8333867f53f0463e (diff) | |
download | dbus-349260f245d95a6c8bcc0f000be1f3232c616052.tar.gz |
Merge branch 'doc-search-paths-35306'
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=35306
Reviewed-by: Lennart Poettering <lennart@poettering.net>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/dbus-specification.xml | 22 |
1 files changed, 19 insertions, 3 deletions
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index b1b3b5cf..959c4e7f 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -4591,9 +4591,25 @@ <sect4> <title></title> <para> - [FIXME specify location of .service files, probably using - DESKTOP_DIRS etc. from basedir specification, though login session - bus is not really desktop-specific] + On Unix systems, the session bus should search for .service files + in <literal>$XDG_DATA_DIRS/dbus-1/services</literal> as defined + by the + <ulink url="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">XDG Base Directory Specification</ulink>. + Implementations may also search additional locations, which + should be searched with lower priority than anything in + XDG_DATA_HOME, XDG_DATA_DIRS or their respective defaults; + for example, the reference implementation also + looks in <literal>${datadir}/dbus-1/services</literal> as + set at compile time. + </para> + <para> + As described in the XDG Base Directory Specification, software + packages should install their session .service files to their + configured <literal>${datadir}/dbus-1/services</literal>, + where <literal>${datadir}</literal> is as defined by the GNU + coding standards. System administrators or users can arrange + for these service files to be read by setting XDG_DATA_DIRS or by + symlinking them into the default locations. </para> </sect4> </sect3> |