diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index 20b0d48a..ea72752f 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -762,9 +762,29 @@ + + Object paths are often namespaced by starting with a reversed + domain name and containing an interface version number, in the + same way as + interface + names and + well-known + bus names. + 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). + + + + For instance, if the owner of example.com is + developing a D-Bus API for a music player, they might use the + hierarchy of object paths that start with + /com/example/MusicPlayer1 for its objects. + - Valid Signatures