spec: Re-word documentation of ReleaseName

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 846cfd71468b9d113e590b4de9acb30a9143f3d6..565ce56c6701aead9240778bbf8b33289ed46d46 100644 (file)
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -5549,15 +5549,13 @@
           </informaltable>
         </para>
         <para>
-          This method call should be sent to
-          <literal>org.freedesktop.DBus</literal> and asks the message bus to
-          release the method caller's claim to the given name. If the caller is
-          the primary owner, a new primary owner will be selected from the
-          queue if any other owners are waiting. If the caller is waiting in
-          the queue for the name, the caller will removed from the queue and
-          will not be made an owner of the name if it later becomes available.
-          If there are no other owners in the queue for the name, it will be
-          removed from the bus entirely.
+          Ask the message bus to release the method caller's claim to the given
+          name. If the caller is the primary owner, a new primary owner will be
+          selected from the queue if any other owners are waiting. If the
+          caller is waiting in the queue for the name, the caller will removed
+          from the queue and will not be made an owner of the name if it later
+          becomes available. If there are no other owners in the queue for the
+          name, it will be removed from the bus entirely.
 
           The return code can be one of the following values: