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.

diff --git a/gtk/gtkaccessible.c b/gtk/gtkaccessible.c
index ebb9e3478b51163ba829ae8eeab31f6e9b8b5ea0..eb318e1cc1a7e95e7f5a3634cae320150a695f8a 100644 (file)
--- 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