Spec: Re-word documentation of RequestName

This was previously written in an unusual message-passing-oriented
style, which obscured the meaning. Use a more method-call-oriented
style instead.

[smcv: separated out from a larger commit, added commit message]
Reviewed-by: Simon McVittie <smcv@collabora.com>

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 071665a..846cfd7 100644 (file)
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -5316,14 +5316,12 @@
           </informaltable>
         </para>
         <para>
-          This method call should be sent to
-          <literal>org.freedesktop.DBus</literal> and asks the message bus to
-          assign the given name to the method caller. Each name maintains a
-          queue of possible owners, where the head of the queue is the primary
-          or current owner of the name. Each potential owner in the queue
-          maintains the DBUS_NAME_FLAG_ALLOW_REPLACEMENT and
-          DBUS_NAME_FLAG_DO_NOT_QUEUE settings from its latest RequestName
-          call.  When RequestName is invoked the following occurs:
+          Ask the message bus to assign the given name to the method caller. Each
+          name maintains a queue of possible owners, where the head of the queue is
+          the primary or current owner of the name. Each potential owner in the
+          queue maintains the DBUS_NAME_FLAG_ALLOW_REPLACEMENT and
+          DBUS_NAME_FLAG_DO_NOT_QUEUE settings from its latest RequestName call.
+          When RequestName is invoked the following occurs:
           <itemizedlist>
             <listitem>
               <para>