A quick cheat sheet

diff --git a/docs/reference/gio/migrating-dbus-glib.xml b/docs/reference/gio/migrating-dbus-glib.xml
index 2dda37e..a8863d1 100644 (file)
--- 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>