diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index f57a4983..b747c0bf 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -586,6 +586,15 @@ plugins). + + Using an object path of / is allowed, but + recommended against, as it makes versioning of interfaces hard. Any + signals emitted from a D-Bus object have the service’s unique bus name + associated with them, rather than its well-known name. This means that + receipients of the signals must rely entirely on the signal name and + object path to work out which interface the signal originated from. + + For instance, if the owner of example.com is developing a D-Bus API for a music player, they might use the