From: Emmanuele Bassi <ebassi@linux.intel.com>
Date: Tue, 3 Aug 2010 09:34:59 +0000 (+0100)
Subject: docs: Clarify user_data behavior for bind_property_full()
X-Git-Tag: 2.25.13~45
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=5e1c4b18a806cd8a0f259b314f64f3d99e824773;p=platform%2Fupstream%2Fglib.git

docs: Clarify user_data behavior for bind_property_full()
---

diff --git a/gobject/gbinding.c b/gobject/gbinding.c
index 0388d07..06273ac 100644
--- a/gobject/gbinding.c
+++ b/gobject/gbinding.c
@@ -802,6 +802,12 @@ g_binding_get_target_property (GBinding *binding)
  *
  * A #GObject can have multiple bindings.
  *
+ * <note>The same @user_data parameter will be used for both @transform_to
+ * and @transform_from transformation functions; the @notify function will
+ * be called once, when the binding is removed. If you need different data
+ * for each transformation function, please use
+ * g_object_bind_property_with_closures() instead.</note>
+ *
  * Return value: (transfer none): the #GBinding instance representing the
  *   binding between the two #GObject instances. The binding is released
  *   whenever the #GBinding reference count reaches zero.