[gtk+] accessible: At an important note to the docs

[Benjamin Otte <otte src gnome org>]

commit 50431be274dbc969fb03d6c4b1cbc62bffeacac7
Author: Benjamin Otte <otte redhat com>
Date:   Sun Dec 18 12:49:06 2011 +0100

    accessible: At an important note to the docs
    
    I wanted to use weak refs to ensure this instead, but it's a performance
    problem when used in the treeview and each and every cell adds a weak
    ref to the treeview.

 gtk/gtkaccessible.c |    6 +++++-
 1 files changed, 5 insertions(+), 1 deletions(-)
---
diff --git a/gtk/gtkaccessible.c b/gtk/gtkaccessible.c
index ebb9e34..eb318e1 100644
--- a/gtk/gtkaccessible.c
+++ b/gtk/gtkaccessible.c
@@ -127,10 +127,14 @@ gtk_accessible_class_init (GtkAccessibleClass *klass)
 /**
  * gtk_accessible_set_widget:
  * @accessible: a #GtkAccessible
- * @widget: a #GtkWidget
+ * @widget: (allow-none): a #GtkWidget or %NULL to unset
  *
  * Sets the #GtkWidget corresponding to the #GtkAccessible.
  *
+ * <note><para>@accessible will not hold a reference to @widget.
+ * It is the caller's responsibility to ensure that when @widget
+ * is destroyed, the widget is unset by calling this function
+ * again with @widget set to %NULL.</para></note>
  * Since: 2.22
  */
 void