glib/docs/reference/gio/migrating-dbus-glib.xml

<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>
    More hints for migrating from dbus-glib to GDBus will appear here shortly...
  </para>
</chapter>