[gtk+/gtk-3-10] docs: Add more information to gtk_widget_set_realized()

[Matthias Clasen <matthiasc src gnome org>]

commit 851b5d3c4cad39814b84b3958441a004dc20e532
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 a3ddfe8..5a7f1c0 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -8540,7 +8540,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.