summaryrefslogtreecommitdiff
path: root/gio/src/dbusproxy.hg
diff options
context:
space:
mode:
authorJosé Alburquerque <jaalburqu@svn.gnome.org>2010-12-13 23:08:40 -0500
committerJosé Alburquerque <jaalburqu@svn.gnome.org>2010-12-13 23:46:29 -0500
commit6c56522dddbb9a2c2d130ae94b9f951899a3a37c (patch)
treead56684a427a1be31bca0743a7640e20505b2a03 /gio/src/dbusproxy.hg
parent74b5b1c55bdc1f9e44489c142e8657dce824e836 (diff)
downloadglibmm-6c56522dddbb9a2c2d130ae94b9f951899a3a37c.tar.gz
DBusProxy: Reorder the parameters so that "name" is second in methods.
* gio/src/dbusproxy.{ccg,hg}: Reorder the parameters so that the "name" parameter comes before the "object_path" parameter as in the C API which is probably more natural. Add _IMPLEMENTS_INTERFACE() for the Initable and AsyncInitable interfaces that it implements. (class docs): Removed some sentences in the class docs that only apply to the C API. Made it clear that the docs is adapted from the C API in case the paragraph about sub-classing does not apply. (constructor properties): Corrected the "name" property to the correct name "g_name" in constructors. * gio/giomm.h: Added all the missing dbus includes.
Diffstat (limited to 'gio/src/dbusproxy.hg')
-rw-r--r--gio/src/dbusproxy.hg27
1 files changed, 13 insertions, 14 deletions
diff --git a/gio/src/dbusproxy.hg b/gio/src/dbusproxy.hg
index 74a2a2f1..de4f6bcc 100644
--- a/gio/src/dbusproxy.hg
+++ b/gio/src/dbusproxy.hg
@@ -47,18 +47,15 @@ class DBusInterfaceInfo;
* appears.
*
* If a DBusProxy is used for a well-known name, the owner of the name is
- * tracked and can be read from property_g_name_owner(). Connect to the
- * signal_notify() signal to get notified of changes. Additionally, only
- * signals and property changes emitted from the current name owner are
- * considered. This avoids a number of race conditions when the name is lost
- * by one owner and claimed by another.
+ * tracked and can be read from property_g_name_owner().
*
* The generic signal_g_properties_changed() and signal_g_signal() signals are
* not very convenient to work with. Therefore, the recommended way of working
* with proxies is to subclass DBusProxy, and have more natural properties and
* signals in your derived class.
*
- * The C API docs has more information and an example.
+ * This documentation was adapted from the C API documentation. The C API docs
+ * has more information and an example.
*
* @newin{2,28}
* @ingroup DBus
@@ -69,38 +66,40 @@ class DBusProxy
public AsyncInitable
{
_CLASS_GOBJECT(DBusProxy, GDBusProxy, G_DBUS_PROXY, Glib::Object, GObject)
+ _IMPLEMENTS_INTERFACE(Initable)
+ _IMPLEMENTS_INTERFACE(AsyncInitable)
protected:
DBusProxy(const Glib::RefPtr<DBusConnection>& connection,
+ const Glib::ustring& name,
const Glib::ustring& object_path,
const Glib::ustring& interface_name,
const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable,
- const Glib::ustring& name = Glib::ustring(),
const Glib::RefPtr<DBusInterfaceInfo>& info = Glib::RefPtr<DBusInterfaceInfo>(),
DBusProxyFlags flags = DBUS_PROXY_FLAGS_NONE);
DBusProxy(const Glib::RefPtr<DBusConnection>& connection,
+ const Glib::ustring& name,
const Glib::ustring& object_path,
const Glib::ustring& interface_name,
const SlotAsyncReady& slot,
- const Glib::ustring& name = Glib::ustring(),
const Glib::RefPtr<DBusInterfaceInfo>& info = Glib::RefPtr<DBusInterfaceInfo>(),
DBusProxyFlags flags = DBUS_PROXY_FLAGS_NONE);
DBusProxy(const Glib::RefPtr<DBusConnection>& connection,
+ const Glib::ustring& name,
const Glib::ustring& object_path,
const Glib::ustring& interface_name,
const Glib::RefPtr<Cancellable>& cancellable,
- const Glib::ustring& name = Glib::ustring(),
const Glib::RefPtr<DBusInterfaceInfo>& info = Glib::RefPtr<DBusInterfaceInfo>(),
DBusProxyFlags flags = DBUS_PROXY_FLAGS_NONE);
DBusProxy(const Glib::RefPtr<DBusConnection>& connection,
+ const Glib::ustring& name,
const Glib::ustring& object_path,
const Glib::ustring& interface_name,
- const Glib::ustring& name = Glib::ustring(),
const Glib::RefPtr<DBusInterfaceInfo>& info = Glib::RefPtr<DBusInterfaceInfo>(),
DBusProxyFlags flags = DBUS_PROXY_FLAGS_NONE);
@@ -140,20 +139,20 @@ public:
_WRAP_METHOD_DOCS_ONLY(g_dbus_proxy_new)
static void create(const Glib::RefPtr<DBusConnection>& connection,
+ const Glib::ustring& name,
const Glib::ustring& object_path,
const Glib::ustring& interface_name,
const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable,
- const Glib::ustring& name = Glib::ustring(),
const Glib::RefPtr<DBusInterfaceInfo>& info = Glib::RefPtr<DBusInterfaceInfo>(),
DBusProxyFlags flags = DBUS_PROXY_FLAGS_NONE);
/// Non-cancellable version of create().
static void create(const Glib::RefPtr<DBusConnection>& connection,
+ const Glib::ustring& name,
const Glib::ustring& object_path,
const Glib::ustring& interface_name,
const SlotAsyncReady& slot,
- const Glib::ustring& name = Glib::ustring(),
const Glib::RefPtr<DBusInterfaceInfo>& info = Glib::RefPtr<DBusInterfaceInfo>(),
DBusProxyFlags flags = DBUS_PROXY_FLAGS_NONE);
@@ -164,19 +163,19 @@ public:
_WRAP_METHOD_DOCS_ONLY(g_dbus_proxy_new_sync)
static Glib::RefPtr<DBusProxy>
create_sync(const Glib::RefPtr<DBusConnection>& connection,
+ const Glib::ustring& name,
const Glib::ustring& object_path,
const Glib::ustring& interface_name,
const Glib::RefPtr<Cancellable>& cancellable,
- const Glib::ustring& name = Glib::ustring(),
const Glib::RefPtr<DBusInterfaceInfo>& info = Glib::RefPtr<DBusInterfaceInfo>(),
DBusProxyFlags flags = DBUS_PROXY_FLAGS_NONE);
/// Non-cancellable version of create_sync().
static Glib::RefPtr<DBusProxy>
create_sync(const Glib::RefPtr<DBusConnection>& connection,
+ const Glib::ustring& name,
const Glib::ustring& object_path,
const Glib::ustring& interface_name,
- const Glib::ustring& name = Glib::ustring(),
const Glib::RefPtr<DBusInterfaceInfo>& info = Glib::RefPtr<DBusInterfaceInfo>(),
DBusProxyFlags flags = DBUS_PROXY_FLAGS_NONE);