From c9a00f311ad2759baccaa874e21c0d313034d63a Mon Sep 17 00:00:00 2001 From: Lucas De Marchi Date: Tue, 2 Oct 2012 21:42:02 +0000 Subject: [PATCH] edbus: Improve doc of name_owner_changed_callback_add() Explain the reason for the extra flag on this function. SVN revision: 77339 --- src/lib/edbus_freedesktop.h | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/lib/edbus_freedesktop.h b/src/lib/edbus_freedesktop.h index 639fc9a..9709425 100644 --- a/src/lib/edbus_freedesktop.h +++ b/src/lib/edbus_freedesktop.h @@ -40,6 +40,12 @@ typedef void (*EDBus_Name_Owner_Changed_Cb)(void *data, const char *bus, const c /** * Add a callback to be called when unique id of a bus name changed. * + * This function implicitly calls edbus_name_owner_get() in order to be able to + * monitor the name. If the only interest is to receive notifications when the + * name in fact changes, pass EINA_FALSE to @param allow_initial_call so your + * callback will not be called on first retrieval of name owner. If the + * initial state is important, pass EINA_TRUE to this parameter. + * * @param conn connection * @param bus name of bus * @param cb callback -- 2.7.4