From 233602d96374955f71dbf30919a03678fe2afa4c Mon Sep 17 00:00:00 2001
From: Simon McVittie <smcv@collabora.com>
Date: Thu, 12 Apr 2018 13:51:38 +0100
Subject: [PATCH 1/9] spec: Recommend Unix domain sockets for all non-Windows
 platforms

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

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 3b2be1c3..14fac9ee 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -3543,6 +3543,10 @@
       </para>
       <para>
         Unix domain sockets are not available on Windows.
+        On all other platforms, they are the recommended transport for
+        D-Bus, either used alone or in conjunction with
+        <link linkend="transports-systemd">systemd</link> or
+        <link linkend="transports-launchd">launchd</link> addresses.
       </para>
       <para>
         Unix addresses that specify <literal>path</literal> or
@@ -3691,7 +3695,8 @@
       </para>
       <para>
         The systemd transport accepts only one or more Unix domain or
-        TCP streams sockets passed in via socket activation.
+        TCP streams sockets passed in via socket activation. Using
+        Unix domain sockets is strongly recommended.
       </para>
       <para>
         The systemd transport is not available on non-Linux operating systems.
-- 
2.17.0