[next] telepathy-glib: Move documentation of low-level (D-Bus-API-dependent ) things to the end

Simon McVittie smcv at kemper.freedesktop.org
Wed May 2 08:56:38 PDT 2012


Module: telepathy-glib
Branch: next
Commit: 4676e15e774c3a68dc00bab08c9330bea48c14b2
URL:    http://cgit.freedesktop.org/telepathy/telepathy-glib/commit/?id=4676e15e774c3a68dc00bab08c9330bea48c14b2

Author: Simon McVittie <simon.mcvittie at collabora.co.uk>
Date:   Tue May  1 16:12:18 2012 +0100

Move documentation of low-level (D-Bus-API-dependent) things to the end

Bug: https://bugs.freedesktop.org/show_bug.cgi?id=49377
Signed-off-by: Simon McVittie <simon.mcvittie at collabora.co.uk>
Reviewed-by: Jonny Lamb <jonny.lamb at collabora.co.uk>

---

 docs/reference/telepathy-glib-docs.sgml |  151 +++++++++++++++++--------------
 1 files changed, 82 insertions(+), 69 deletions(-)

diff --git a/docs/reference/telepathy-glib-docs.sgml b/docs/reference/telepathy-glib-docs.sgml
index 4651793..9549848 100644
--- a/docs/reference/telepathy-glib-docs.sgml
+++ b/docs/reference/telepathy-glib-docs.sgml
@@ -16,7 +16,6 @@
   <chapter id="ch-dbus">
     <title>General D-Bus support</title>
     <xi:include href="xml/proxy.xml"/>
-    <xi:include href="xml/proxy-dbus-core.xml"/>
     <xi:include href="xml/dbus.xml"/>
     <xi:include href="xml/asv.xml"/>
     <xi:include href="xml/proxy-subclass.xml"/>
@@ -25,64 +24,26 @@
     <title>The Telepathy protocol</title>
     <xi:include href="xml/defs.xml"/>
     <xi:include href="xml/handle.xml"/>
-    <xi:include href="xml/interfaces.xml"/>
     <xi:include href="xml/enums.xml"/>
     <xi:include href="xml/errors.xml"/>
-    <xi:include href="xml/gtypes.xml"/>
     <xi:include href="xml/channel-iface.xml"/>
   </chapter>
   <chapter id="ch-client">
     <title>Client-side proxies</title>
     <xi:include href="xml/connection-manager.xml"/>
-    <xi:include href="xml/cli-connection-manager.xml"/>
     <xi:include href="xml/protocol.xml"/>
     <xi:include href="xml/connection.xml"/>
     <xi:include href="xml/contact.xml"/>
     <xi:include href="xml/capabilities.xml"/>
-    <xi:include href="xml/cli-connection.xml"/>
-    <xi:include href="xml/connection-aliasing.xml"/>
-    <xi:include href="xml/connection-avatars.xml"/>
-    <xi:include href="xml/connection-balance.xml"/>
-    <xi:include href="xml/connection-client-types.xml"/>
-    <xi:include href="xml/connection-contacts.xml"/>
-    <xi:include href="xml/connection-contact-info.xml"/>
-    <xi:include href="xml/connection-contact-list.xml"/>
-    <xi:include href="xml/connection-caps.xml"/>
-    <xi:include href="xml/connection-location.xml"/>
-    <xi:include href="xml/connection-requests.xml"/>
-    <xi:include href="xml/connection-presence.xml"/>
-    <xi:include href="xml/connection-cellular.xml"/>
-    <xi:include href="xml/connection-mail.xml"/>
-    <xi:include href="xml/connection-powersaving.xml"/>
-    <xi:include href="xml/connection-addressing.xml"/>
     <xi:include href="xml/contact-search.xml"/>
     <xi:include href="xml/contact-search-result.xml"/>
     <xi:include href="xml/channel.xml"/>
-    <xi:include href="xml/cli-channel.xml"/>
-    <xi:include href="xml/channel-group.xml"/>
-    <xi:include href="xml/channel-room.xml"/>
-    <xi:include href="xml/channel-text.xml"/>
-    <xi:include href="xml/channel-media.xml"/>
-    <xi:include href="xml/channel-file-transfer.xml"/>
-    <xi:include href="xml/channel-tube.xml"/>
-    <xi:include href="xml/channel-roomlist.xml"/>
-    <xi:include href="xml/channel-contactsearch.xml"/>
-    <xi:include href="xml/channel-auth.xml"/>
-    <xi:include href="xml/cli-call-channel.xml"/>
-    <xi:include href="xml/cli-call-content.xml"/>
-    <xi:include href="xml/cli-call-stream.xml"/>
-    <xi:include href="xml/cli-call-misc.xml"/>
-    <xi:include href="xml/cli-anonymity.xml"/>
-    <xi:include href="xml/cli-service-point.xml"/>
     <xi:include href="xml/account-manager.xml"/>
-    <xi:include href="xml/cli-account-manager.xml"/>
     <xi:include href="xml/account.xml"/>
     <xi:include href="xml/channel-dispatcher.xml"/>
     <xi:include href="xml/channel-dispatch-operation.xml"/>
     <xi:include href="xml/channel-request.xml"/>
-    <xi:include href="xml/cli-channel-dispatcher.xml"/>
     <xi:include href="xml/client.xml"/>
-    <xi:include href="xml/cli-client.xml"/>
     <xi:include href="xml/account-channel-request.xml"/>
     <xi:include href="xml/stream-tube-channel.xml"/>
     <xi:include href="xml/stream-tube-connection.xml"/>
@@ -103,36 +64,6 @@
     <xi:include href="xml/room-info.xml"/>
   </chapter>
 
-  <chapter id="ch-service-dbus">
-    <title>Service-side D-Bus interfaces</title>
-    <xi:include href="tp-svc.xml"/>
-    <xi:include href="xml/svc-generic.xml"/>
-    <xi:include href="xml/svc-channel.xml"/>
-    <xi:include href="xml/svc-channel-group.xml"/>
-    <xi:include href="xml/svc-channel-room.xml"/>
-    <xi:include href="xml/svc-channel-contactsearch.xml"/>
-    <xi:include href="xml/svc-channel-text.xml"/>
-    <xi:include href="xml/svc-channel-file-transfer.xml"/>
-    <xi:include href="xml/svc-channel-ft-metadata.xml"/>
-    <xi:include href="xml/svc-channel-tube.xml"/>
-    <xi:include href="xml/svc-channel-roomlist.xml"/>
-    <xi:include href="xml/svc-channel-auth.xml"/>
-    <xi:include href="xml/svc-channel-securable.xml"/>
-    <xi:include href="xml/svc-channel-call.xml"/>
-    <xi:include href="xml/svc-debug.xml"/>
-    <xi:include href="xml/svc-connection.xml"/>
-    <xi:include href="xml/svc-anonymity.xml"/>
-    <xi:include href="xml/svc-service-point.xml"/>
-    <xi:include href="xml/svc-connection-manager.xml"/>
-    <xi:include href="xml/svc-protocol.xml"/>
-    <xi:include href="xml/svc-account-manager.xml"/>
-    <xi:include href="xml/svc-account.xml"/>
-    <xi:include href="xml/svc-channel-dispatcher.xml"/>
-    <xi:include href="xml/svc-channel-dispatch-operation.xml"/>
-    <xi:include href="xml/svc-channel-request.xml"/>
-    <xi:include href="xml/svc-client.xml"/>
-    <xi:include href="xml/svc-tls.xml"/>
-  </chapter>
   <chapter id="ch-service-base">
     <title>Service-side implementation</title>
     <xi:include href="xml/run.xml"/>
@@ -187,5 +118,87 @@
     <xi:include href="xml/heap.xml"/>
   </chapter>
 
+  <chapter id="ch-codegen">
+    <title>Low-level generated code - common</title>
+    <xi:include href="xml/gtypes.xml"/>
+    <xi:include href="xml/interfaces.xml"/>
+  </chapter>
+
+  <chapter id="ch-cli">
+    <title>Low-level generated code - client-side</title>
+    <xi:include href="xml/cli-channel.xml"/>
+    <xi:include href="xml/channel-group.xml"/>
+    <xi:include href="xml/channel-room.xml"/>
+    <xi:include href="xml/channel-text.xml"/>
+    <xi:include href="xml/channel-media.xml"/>
+    <xi:include href="xml/channel-file-transfer.xml"/>
+    <xi:include href="xml/channel-tube.xml"/>
+    <xi:include href="xml/channel-roomlist.xml"/>
+    <xi:include href="xml/channel-contactsearch.xml"/>
+    <xi:include href="xml/channel-auth.xml"/>
+    <xi:include href="xml/cli-call-channel.xml"/>
+    <xi:include href="xml/cli-call-content.xml"/>
+    <xi:include href="xml/cli-call-stream.xml"/>
+    <xi:include href="xml/cli-call-misc.xml"/>
+
+    <xi:include href="xml/cli-connection.xml"/>
+    <xi:include href="xml/connection-aliasing.xml"/>
+    <xi:include href="xml/connection-avatars.xml"/>
+    <xi:include href="xml/connection-balance.xml"/>
+    <xi:include href="xml/connection-client-types.xml"/>
+    <xi:include href="xml/connection-contacts.xml"/>
+    <xi:include href="xml/connection-contact-info.xml"/>
+    <xi:include href="xml/connection-contact-list.xml"/>
+    <xi:include href="xml/connection-caps.xml"/>
+    <xi:include href="xml/connection-location.xml"/>
+    <xi:include href="xml/connection-requests.xml"/>
+    <xi:include href="xml/connection-presence.xml"/>
+    <xi:include href="xml/connection-cellular.xml"/>
+    <xi:include href="xml/connection-mail.xml"/>
+    <xi:include href="xml/connection-powersaving.xml"/>
+    <xi:include href="xml/connection-addressing.xml"/>
+
+    <xi:include href="xml/proxy-dbus-core.xml"/>
+    <xi:include href="xml/cli-account-manager.xml"/>
+    <xi:include href="xml/cli-channel-dispatcher.xml"/>
+    <xi:include href="xml/cli-client.xml"/>
+    <xi:include href="xml/cli-connection-manager.xml"/>
+    <xi:include href="xml/cli-anonymity.xml"/>
+    <xi:include href="xml/cli-service-point.xml"/>
+  </chapter>
+
+  <chapter id="ch-service-dbus">
+    <title>Low-level generated code - service-side</title>
+      <xi:include href="tp-svc.xml"/>
+
+      <xi:include href="xml/svc-channel.xml"/>
+      <xi:include href="xml/svc-channel-group.xml"/>
+      <xi:include href="xml/svc-channel-room.xml"/>
+      <xi:include href="xml/svc-channel-contactsearch.xml"/>
+      <xi:include href="xml/svc-channel-text.xml"/>
+      <xi:include href="xml/svc-channel-file-transfer.xml"/>
+      <xi:include href="xml/svc-channel-ft-metadata.xml"/>
+      <xi:include href="xml/svc-channel-tube.xml"/>
+      <xi:include href="xml/svc-channel-roomlist.xml"/>
+      <xi:include href="xml/svc-channel-auth.xml"/>
+      <xi:include href="xml/svc-channel-securable.xml"/>
+      <xi:include href="xml/svc-channel-call.xml"/>
+
+      <xi:include href="xml/svc-generic.xml"/>
+      <xi:include href="xml/svc-connection.xml"/>
+      <xi:include href="xml/svc-debug.xml"/>
+      <xi:include href="xml/svc-anonymity.xml"/>
+      <xi:include href="xml/svc-service-point.xml"/>
+      <xi:include href="xml/svc-connection-manager.xml"/>
+      <xi:include href="xml/svc-protocol.xml"/>
+      <xi:include href="xml/svc-account-manager.xml"/>
+      <xi:include href="xml/svc-account.xml"/>
+      <xi:include href="xml/svc-channel-dispatcher.xml"/>
+      <xi:include href="xml/svc-channel-dispatch-operation.xml"/>
+      <xi:include href="xml/svc-channel-request.xml"/>
+      <xi:include href="xml/svc-client.xml"/>
+      <xi:include href="xml/svc-tls.xml"/>
+  </chapter>
+
   <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
 </book>



More information about the telepathy-commits mailing list