From 6ec8d071e4aa9e678780765e69daba669475e98a Mon Sep 17 00:00:00 2001
From: Simon McVittie <smcv@collabora.com>
Date: Tue, 12 Dec 2017 12:31:20 +0000
Subject: [PATCH 3/9] spec: Document the direction of each auth command

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

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 051dd07b..7f09ba69 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -2270,6 +2270,9 @@
     </sect2>
     <sect2 id="auth-command-auth">
       <title>AUTH command</title>
+      <para>
+        The AUTH command is sent by the client to the server.
+      </para>
       <para>
         If an AUTH command has no arguments, it is a request to list
         available mechanisms. The server must respond with a REJECTED
@@ -2300,6 +2303,9 @@
     </sect2>
     <sect2 id="auth-command-cancel">
       <title>CANCEL Command</title>
+      <para>
+        The CANCEL command is sent by the client to the server.
+      </para>
       <para>
         At any time up to sending the BEGIN command, the client may send a
         CANCEL command. On receiving the CANCEL command, the server must
@@ -2321,6 +2327,9 @@
     </sect2>
     <sect2 id="auth-command-begin">
       <title>BEGIN Command</title>
+      <para>
+        The BEGIN command is sent by the client to the server.
+      </para>
       <para>
         The BEGIN command acknowledges that the client has received an
         OK command from the server and completed any feature negotiation
@@ -2342,6 +2351,9 @@
     </sect2>
     <sect2 id="auth-command-rejected">
       <title>REJECTED Command</title>
+      <para>
+        The REJECTED command is sent by the server to the client.
+      </para>
       <para>
         The REJECTED command indicates that the current authentication
         exchange has failed, and further exchange of DATA is inappropriate.
@@ -2357,6 +2369,9 @@
     </sect2>
     <sect2 id="auth-command-ok">
       <title>OK Command</title>
+      <para>
+        The OK command is sent by the server to the client.
+      </para>
       <para>
         The OK command indicates that the client has been
         authenticated. The client may now proceed with negotiating
@@ -2388,6 +2403,9 @@
     </sect2>
     <sect2 id="auth-command-error">
       <title>ERROR Command</title>
+      <para>
+        The ERROR command can be sent in either direction.
+      </para>
       <para>
         The ERROR command indicates that either server or client did not
         know a command, does not accept the given command in the current
@@ -2415,6 +2433,9 @@
     </sect2>
     <sect2 id="auth-command-negotiate-unix-fd">
       <title>NEGOTIATE_UNIX_FD Command</title>
+      <para>
+        The NEGOTIATE_UNIX_FD command is sent by the client to the server.
+      </para>
       <para>
         The NEGOTIATE_UNIX_FD command indicates that the client
         supports Unix file descriptor passing. This command may only
@@ -2435,6 +2456,9 @@
     </sect2>
     <sect2 id="auth-command-agree-unix-fd">
       <title>AGREE_UNIX_FD Command</title>
+      <para>
+        The AGREE_UNIX_FD command is sent by the server to the client.
+      </para>
       <para>
         The AGREE_UNIX_FD command indicates that the server supports
         Unix file descriptor passing. This command may only be sent
-- 
2.15.1