summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorTom Gundersen <teg@jklm.no>2017-05-31 16:21:00 +0100
committerSimon McVittie <smcv@collabora.com>2017-05-31 16:26:06 +0100
commitf612b067ebf8ff83b0725ccd55df61f57f565398 (patch)
tree7c23d9b79b547bc0082964b226c6970fa327e4fe /doc
parent6725cac9d089318c6408426f07c72e7b9d87506a (diff)
downloaddbus-f612b067ebf8ff83b0725ccd55df61f57f565398.tar.gz
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>
Diffstat (limited to 'doc')
-rw-r--r--doc/dbus-specification.xml14
1 files changed, 6 insertions, 8 deletions
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 071665a4..846cfd71 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>