diff --git a/doc/dbus-daemon.1.xml.in b/doc/dbus-daemon.1.xml.in
index 42e3f86f..960da080 100644
--- a/doc/dbus-daemon.1.xml.in
+++ b/doc/dbus-daemon.1.xml.in
@@ -432,6 +432,19 @@ a transport name plus possible parameters/options.
+
+ Remote TCP connections were historically sometimes used to share
+ a single session bus between login sessions of the same user on
+ different machines within a trusted local area network, in
+ conjunction with unencrypted remote X11, a NFS-shared home
+ directory and NIS (YP) authentication. This is insecure against
+ an attacker on the same LAN and should be considered strongly
+ deprecated; more specifically, it is insecure in the same ways
+ and for the same reasons as unencrypted remote X11 and NFSv2/NFSv3.
+ The D-Bus maintainers
+ recommend using a separate session bus per (user, machine) pair,
+ only accessible from within that machine.
+
Example: <listen>unix:path=/tmp/foo</listen>