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