[gtk+] Added docs to gtk_widget_set_parent_window.

[Tristan Van Berkom <tvb src gnome org>]

commit 6299f61ee7d88adfef6a554fad0e0b89f734aa2f
Author: Tristan Van Berkom <tristan van berkom gmail com>
Date:   Fri Dec 24 02:09:41 2010 +0900

    Added docs to gtk_widget_set_parent_window.
    
    Also stop setting the resize mode of the window.

 gtk/gtkwidget.c |   17 ++++++++++++-----
 1 files changed, 12 insertions(+), 5 deletions(-)
---
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index cd40ab8..9aa0865 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -9069,6 +9069,16 @@ gtk_widget_render_icon (GtkWidget      *widget,
  * @parent_window: the new parent window.
  *
  * Sets a non default parent window for @widget.
+ *
+ * For GtkWindow classes, setting a @parent_window effects whether 
+ * the window is a toplevel window or can be embedded into other
+ * widgets.
+ *
+ * <note><para>
+ * For GtkWindow classes, this needs to be called before the
+ * window is realized.
+ * </para></note>
+ * 
  **/
 void
 gtk_widget_set_parent_window   (GtkWidget           *widget,
@@ -9094,11 +9104,8 @@ gtk_widget_set_parent_window   (GtkWidget           *widget,
        * this is the primary entry point to allow toplevels to be
        * embeddable.
        */
-      if (GTK_IS_WINDOW (widget))
-	{
-	  _gtk_window_set_is_toplevel (GTK_WINDOW (widget), FALSE);
-	  gtk_container_set_resize_mode (GTK_CONTAINER (widget), GTK_RESIZE_PARENT);
-	}
+      if (GTK_IS_WINDOW (widget) && !GTK_IS_PLUG (widget))
+	_gtk_window_set_is_toplevel (GTK_WINDOW (widget), parent_window == NULL);
     }
 }