[gtk+] docs: Add more information to gtk_widget_set_realized()

[Benjamin Otte <otte src gnome org>]

commit fbf99febf3c686565a44f11553007d3d7eec68f2
Author: Benjamin Otte <otte redhat com>
Date:   Thu Mar 20 14:34:31 2014 +0100

    docs: Add more information to gtk_widget_set_realized()
    
    It's important to point out that widgets should only be marked as
    realized very late in the process. Even GTK widgets don't get this
    right.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=726717

 gtk/gtkwidget.c |    4 +++-
 1 files changed, 3 insertions(+), 1 deletions(-)
---
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 9541e59..b82819a 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -8609,7 +8609,9 @@ gtk_widget_get_realized (GtkWidget *widget)
  * @widget: a #GtkWidget
  * @realized: %TRUE to mark the widget as realized
  *
- * Marks the widget as being realized.
+ * Marks the widget as being realized. This function must only be 
+ * called after all #GdkWindows for the @widget have been created 
+ * and registered.
  *
  * This function should only ever be called in a derived widget's
  * “realize” or “unrealize” implementation.