[telepathy-doc/master] Move the section on RequestChannel to the bottom

Davyd Madeley davyd at madeley.id.au
Sun Aug 9 04:45:18 PDT 2009


---
 docs/book/C/channel.xml |  130 +++++++++++++++++++++++-----------------------
 1 files changed, 65 insertions(+), 65 deletions(-)

diff --git a/docs/book/C/channel.xml b/docs/book/C/channel.xml
index ac27d4e..030c71f 100644
--- a/docs/book/C/channel.xml
+++ b/docs/book/C/channel.xml
@@ -326,6 +326,71 @@
     </para>
    </sect2>
 
+   <sect2 id="sect.channel.requesting.python">
+    <title>telepathy-python</title>
+
+    <para>
+      telepathy-python provides the
+      <classname>telepathy.client.Channel</classname> class as a D-Bus proxy
+      object. To construct this proxy you need to pass the connection's
+      D-Bus service name and the path to the channel object.
+    </para>
+
+    <para>
+     <classname>telepathy.client.Channel</classname> can be inherited like
+     any other Python class, so that you can pass around all of the methods
+     and state relating to that channel as one object. This is shown in
+     <xref linkend="ex.channel.requesting.python.class"/>.
+    </para>
+
+    <example id="ex.channel.requesting.python.class"
+             file="python_iface_messaging/example.py">
+     <title>Inheriting telepathy.client.Channel</title>
+    </example>
+   </sect2>
+
+   <sect2 id="sect.channel.requesting.glib">
+    <title>telepathy-glib</title>
+
+    <para>
+     <application>telepathy-glib</application> maps
+     <methodname>CreateChannel</methodname> and
+     <methodname>EnsureChannel</methodname> to the functions
+     <function>tp_cli_connection_interface_requests_call_create_channel</function>
+     and <function>tp_cli_connection_interface_requests_call_ensure_channel</function>
+     respectively. <xref linkend="ex.channel.requesting.glib.ensure"/>
+     shows how this is done.
+    </para>
+
+    <example id="ex.channel.requesting.glib.ensure"
+             file="glib_get_roster/example.c">
+     <title>Ensuring a Channel With telepathy-glib</title>
+    </example>
+
+    <para>
+     The <classname>TpChannel</classname> is used to work with channels in
+     <application>telepathy-glib</application>. It also provides API to help
+     use the <link linkend="sect.channel.groups">Groups interface</link>,
+     that is present on many channels.
+    </para>
+
+    <para>
+     A <classname>TpChannel</classname> can either be created using
+     <function>tp_channel_new</function> or
+     <function>tp_channel_new_from_properties</function>. The latter is more
+     useful when you've created a channel using the
+     <interfacename>Requests</interfacename> interface,
+     as you can just pass in the returned property map, as shown in
+     <xref linkend="ex.channel.requesting.glib.tpchannel"/>.
+    </para>
+
+    <example id="ex.channel.requesting.glib.tpchannel"
+             file="glib_get_roster/example.c">
+     <title>Using tp_channel_new_from_properties</title>
+    </example>
+
+   </sect2>
+
    <sect2 id="sect.channel.requesting.requestchannel">
     <title>The RequestChannel Method</title>
 
@@ -396,71 +461,6 @@
     </para>
    </sect2>
 
-   <sect2 id="sect.channel.requesting.python">
-    <title>telepathy-python</title>
-
-    <para>
-      telepathy-python provides the
-      <classname>telepathy.client.Channel</classname> class as a D-Bus proxy
-      object. To construct this proxy you need to pass the connection's
-      D-Bus service name and the path to the channel object.
-    </para>
-
-    <para>
-     <classname>telepathy.client.Channel</classname> can be inherited like
-     any other Python class, so that you can pass around all of the methods
-     and state relating to that channel as one object. This is shown in
-     <xref linkend="ex.channel.requesting.python.class"/>.
-    </para>
-
-    <example id="ex.channel.requesting.python.class"
-             file="python_iface_messaging/example.py">
-     <title>Inheriting telepathy.client.Channel</title>
-    </example>
-   </sect2>
-   
-   <sect2 id="sect.channel.requesting.glib">
-    <title>telepathy-glib</title>
-    
-    <para>
-     <application>telepathy-glib</application> maps
-     <methodname>CreateChannel</methodname> and
-     <methodname>EnsureChannel</methodname> to the functions
-     <function>tp_cli_connection_interface_requests_call_create_channel</function>
-     and <function>tp_cli_connection_interface_requests_call_ensure_channel</function>
-     respectively. <xref linkend="ex.channel.requesting.glib.ensure"/>
-     shows how this is done.
-    </para>
-
-    <example id="ex.channel.requesting.glib.ensure"
-             file="glib_get_roster/example.c">
-     <title>Ensuring a Channel With telepathy-glib</title>
-    </example>
-
-    <para>
-     The <classname>TpChannel</classname> is used to work with channels in
-     <application>telepathy-glib</application>. It also provides API to help
-     use the <link linkend="sect.channel.groups">Groups interface</link>,
-     that is present on many channels.
-    </para>
-
-    <para>
-     A <classname>TpChannel</classname> can either be created using
-     <function>tp_channel_new</function> or
-     <function>tp_channel_new_from_properties</function>. The latter is more
-     useful when you've created a channel using the
-     <interfacename>Requests</interfacename> interface,
-     as you can just pass in the returned property map, as shown in
-     <xref linkend="ex.channel.requesting.glib.tpchannel"/>.
-    </para>
-
-    <example id="ex.channel.requesting.glib.tpchannel"
-             file="glib_get_roster/example.c">
-     <title>Using tp_channel_new_from_properties</title>
-    </example>
-
-   </sect2>
-
   </sect1>
 
   <sect1 id="sect.channel.newchannels">
-- 
1.5.6.5




More information about the telepathy-commits mailing list