From: Tom Gundersen <teg@jklm.no>
Date: Wed, 31 May 2017 15:21:00 +0000 (+0100)
Subject: Spec: Re-word documentation of RequestName
X-Git-Tag: dbus-1.11.14~56
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f612b067ebf8ff83b0725ccd55df61f57f565398;p=thirdparty%2Fdbus.git

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 071665a48..846cfd714 100644
--- 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>