From 72b2f40954cfb30662c2c3b8363e7b395d5beecd Mon Sep 17 00:00:00 2001
From: Simon McVittie <smcv@collabora.com>
Date: Thu, 12 Apr 2018 13:55:25 +0100
Subject: [PATCH 3/9] spec: Expand on how tcp connections are normally
 authenticated

Signed-off-by: Simon McVittie <smcv@collabora.com>
---
 doc/dbus-specification.xml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index b79d9ae3..a2c8b192 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -3722,8 +3722,11 @@
       </para>
       <para>
         On Windows and most Unix platforms, the TCP stack is unable to transfer
-        credentials over a TCP connection, so the EXTERNAL authentication
-        mechanism does not work for this transport.
+        credentials over a TCP connection, so the
+        <link linkend="auth-mechanisms-external">EXTERNAL</link>
+        authentication mechanism does not work for this transport.
+        The <link linkend="auth-mechanisms-sha">DBUS_COOKIE_SHA1</link>
+        mechanism is normally used instead.
       </para>
       <para>
         All <literal>tcp</literal> addresses are listenable.
-- 
2.17.0