spec: Move ListQueuedOwners API description to list of methods

Tom Gundersen pointed out that RequestName, ReleaseName and
ListQueuedOwners were documented in their own section instead of being
put together with the other method calls, which makes it more difficult
to apply changes consistently across all methods.

I'm moving them one at a time to make the changes reviewable, since
the diff resulting from moving all three as a unit is too large to
review sensibly.

Signed-off-by: Simon McVittie <smcv@collabora.com>
This commit is contained in:
Simon McVittie 2017-05-31 16:17:22 +01:00
parent f3f347a850
commit 6725cac9d0

View file

@ -4253,62 +4253,6 @@
name. These names can be released again using the
<literal>org.freedesktop.DBus.ReleaseName</literal> message.
</para>
<sect3 id="bus-messages-list-queued-owners">
<title><literal>org.freedesktop.DBus.ListQueuedOwners</literal></title>
<para>
As a method:
<programlisting>
ARRAY of STRING ListQueuedOwners (in STRING name)
</programlisting>
Message arguments:
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Argument</entry>
<entry>Type</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>0</entry>
<entry>STRING</entry>
<entry>The well-known bus name to query, such as
<literal>com.example.cappuccino</literal></entry>
</row>
</tbody>
</tgroup>
</informaltable>
Reply arguments:
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Argument</entry>
<entry>Type</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>0</entry>
<entry>ARRAY of STRING</entry>
<entry>The unique bus names of connections currently queued
for the name</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
This method call should be sent to
<literal>org.freedesktop.DBus</literal> and lists the connections
currently queued for a bus name (see
<xref linkend="term-queued-owner"/>).
</para>
</sect3>
</sect2>
<sect2 id="message-bus-routing">
@ -5655,6 +5599,62 @@
</para>
</sect3>
<sect3 id="bus-messages-list-queued-owners">
<title><literal>org.freedesktop.DBus.ListQueuedOwners</literal></title>
<para>
As a method:
<programlisting>
ARRAY of STRING ListQueuedOwners (in STRING name)
</programlisting>
Message arguments:
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Argument</entry>
<entry>Type</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>0</entry>
<entry>STRING</entry>
<entry>The well-known bus name to query, such as
<literal>com.example.cappuccino</literal></entry>
</row>
</tbody>
</tgroup>
</informaltable>
Reply arguments:
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Argument</entry>
<entry>Type</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>0</entry>
<entry>ARRAY of STRING</entry>
<entry>The unique bus names of connections currently queued
for the name</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
This method call should be sent to
<literal>org.freedesktop.DBus</literal> and lists the connections
currently queued for a bus name (see
<xref linkend="term-queued-owner"/>).
</para>
</sect3>
<sect3 id="bus-messages-list-names">
<title><literal>org.freedesktop.DBus.ListNames</literal></title>
<para>