From ca14ab7ac0d93b2ccd0977d905b19094e7317490 Mon Sep 17 00:00:00 2001 From: Ryan Lortie Date: Thu, 15 Jul 2010 16:47:32 -0400 Subject: [PATCH] Bug 624483: GDBusSubtreeEnumerateFunc clarification Clarify a couple of things in the docs: 1) you must return flat names (no slashes) 2) g_strfreev() will be called on the result 3) a benefit of using the DISPATCH_TO_UNENUMERATED flag --- gio/gdbusconnection.h | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/gio/gdbusconnection.h b/gio/gdbusconnection.h index b94e1ab..7d9642e 100644 --- a/gio/gdbusconnection.h +++ b/gio/gdbusconnection.h @@ -306,6 +306,16 @@ gboolean g_dbus_connection_unregister_object (GDBusConnection * * The type of the @enumerate function in #GDBusSubtreeVTable. * + * This function is called when generating introspection data and also + * when preparing to dispatch incoming messages in the event that the + * %G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is not + * specified (ie: to verify that the object path is valid). + * + * Hierarchies are not supported; the items that you return should not + * contain the '/' character. + * + * The return value will be freed with g_strfreev(). + * * Returns: A newly allocated array of strings for node names that are children of @object_path. * * Since: 2.26 -- 2.7.4