[glib] docs: Clarify user_data behavior for bind_property_full()

[Emmanuele Bassi <ebassi src gnome org>]

commit 5e1c4b18a806cd8a0f259b314f64f3d99e824773
Author: Emmanuele Bassi <ebassi linux intel com>
Date:   Tue Aug 3 10:34:59 2010 +0100

    docs: Clarify user_data behavior for bind_property_full()

 gobject/gbinding.c |    6 ++++++
 1 files changed, 6 insertions(+), 0 deletions(-)
---
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.