diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index 9b02f5cd..3b0f4cab 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -5783,13 +5783,27 @@ variable. If that variable is not set, applications should try to connect to the well-known address unix:path=/var/run/dbus/system_bus_socket. - - - The D-Bus reference implementation actually honors the - $(localstatedir) configure option - for this address, on both client and server side. - - + Implementations of the well-known system bus should listen on + an address that will result in that connection being successful. + + + On systems where /var/run/ is known to be + synonymous with /run/ (such as most Linux + operating system distributions), implementations might prefer + to make use of that knowledge to connect to or listen on + unix:path=/run/dbus/system_bus_socket instead, + which has some minor technical advantages, particularly during + early startup and late shutdown. + + + In practice, implementations of D-Bus often have build-time + configuration options for the system bus address, whose defaults + often depend on other build-time options such as the installation + prefix (in particular, this is the case for dbus, the reference + implementation of D-Bus). + Distributors intending to provide access to the well-known + system bus should verify that they are using an interoperable + address. On Unix systems, the system bus should default to searching