[glib/gdbus-merge] A quick cheat sheet

[Matthias Clasen <matthiasc src gnome org>]

commit 1ddda12d646f67fcb558399dce20ecff2405bf20
Author: Matthias Clasen <mclasen redhat com>
Date:   Thu May 6 20:54:04 2010 -0400

    A quick cheat sheet

 docs/reference/gio/migrating-dbus-glib.xml |   30 +++++++++++++++++++++++++++-
 1 files changed, 29 insertions(+), 1 deletions(-)
---
diff --git a/docs/reference/gio/migrating-dbus-glib.xml b/docs/reference/gio/migrating-dbus-glib.xml
index 2dda37e..a8863d1 100644
--- a/docs/reference/gio/migrating-dbus-glib.xml
+++ b/docs/reference/gio/migrating-dbus-glib.xml
@@ -1,7 +1,35 @@
 <chapter>
   <title>Migrating from dbus-glib to GDBus</title>
 
+  <table id="dbus-glib-vs-gdbus">
+    <title>dbus-glib functions and their GDBus counterparts</title>
+    <tgroup cols="2">
+      <thead>
+        <row><entry>dbus-glib</entry><entry>GDBus</entry></row>
+      </thead>
+      <tbody>
+        <row><entry>dbus_g_bus_get()</entry><entry>g_bus_get_sync(), also see
+             g_bus_get()</entry></row>
+        <row><entry>dbus_g_proxy_new_for_name()</entry><entry>g_dbus_proxy_new_sync(), also see
+             g_dbus_proxy_new()</entry></row>
+        <row><entry>dbus_g_proxy_add_signal()</entry><entry>not needed, use the generic #GDBusProxy::g-signal</entry></row>
+        <row><entry>dbus_g_proxy_connect_signal()</entry><entry>use g_signal_connect() with #GDBusProxy::g-signal</entry></row>
+        <row><entry>dbus_g_connection_register_g_object()</entry><entry>g_dbus_connection_register_object()</entry></row>
+        <row><entry>dbus_g_connection_unregister_g_object()</entry><entry>g_dbus_connection_unregister_object()</entry></row>
+        <row><entry>dbus_g_object_type_install_info()</entry><entry>introspection data is installed while registering
+             an object, see g_dbus_connection_register_object()</entry></row>
+        <row><entry>dbus_g_proxy_begin_call()</entry><entry>g_dbus_proxy_invoke_method()</entry></row>
+        <row><entry>dbus_g_proxy_end_call()</entry><entry>g_dbus_proxy_invoke_method_finish()</entry></row>
+        <row><entry>dbus_g_proxy_call()</entry><entry>g_dbus_proxy_invoke_method_sync()</entry></row>
+        <row><entry>dbus_g_error_domain_register()</entry><entry>g_dbus_error_register_error_domain()</entry></row>
+        <row><entry>dbus_g_error_has_name()</entry><entry>no direct equivalent, see g_dbus_error_get_remote_error()</entry></row>
+        <row><entry>dbus_g_method_return()</entry><entry>g_dbus_method_invocation_return_value()</entry></row>
+        <row><entry>dbus_g_method_return_error()</entry><entry>g_dbus_method_invocation_return_error() and variants</entry></row>
+        <row><entry>dbus_g_method_get_sender()</entry><entry>g_dbus_method_invocation_get_sender()</entry></row>
+      </tbody>
+    </tgroup>
+  </table>
   <para>
-    Hints for migrating from dbus-glib to GDBus will appear here shortly...
+    More hints for migrating from dbus-glib to GDBus will appear here shortly...
   </para>
 </chapter>