fdo-mirrors/dbus
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/dbus/dbus.git synced 2026-01-29 14:40:25 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

Briefly mention why to namespace object-paths

Browse source
This commit is contained in:
Simon McVittie 2011-05-17 17:06:46 +01:00
parent cd279fd3c5
commit dd2b63e6e1
1 changed files with 21 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
doc/dbus-specification.xml
View file

@ -762,9 +762,29 @@
</itemizedlist>
</para>
<para>
Object paths are often namespaced by starting with a reversed
domain name and containing an interface version number, in the
same way as
<link linkend="message-protocol-names-interface">interface
names</link> and
<link linkend="message-protocol-names-bus">well-known
bus names</link>.
This makes it possible to implement more than one service, or
more than one version of a service, in the same process,
even if the services share a connection but cannot otherwise
co-operate (for instance, if they are implemented by different
plugins).
</para>
<para>
For instance, if the owner of <literal>example.com</literal> is
developing a D-Bus API for a music player, they might use the
hierarchy of object paths that start with
<literal>/com/example/MusicPlayer1</literal> for its objects.
</para>
</sect3>
<sect3 id="message-protocol-marshaling-signature">
<title>Valid Signatures</title>
<para>