? docs.patch
Index: gtk/gtkwindow.c
===================================================================
RCS file: /cvs/gnome/gtk+/gtk/gtkwindow.c,v
retrieving revision 1.289
diff -u -r1.289 gtkwindow.c
--- gtk/gtkwindow.c	26 Mar 2005 05:49:15 -0000	1.289
+++ gtk/gtkwindow.c	10 Jun 2005 04:32:41 -0000
@@ -1596,7 +1596,9 @@
  * on top of main application windows, use
  * gtk_window_set_transient_for() to make the dialog transient for the
  * parent; most <link linkend="gtk-X11-arch">window managers</link>
- * will then disallow lowering the dialog below the parent.
+ * will then disallow lowering the dialog below the parent. If you have
+ * a modal dialog and would like to have a non-modal child of it, create
+ * a new #GtkWindowGroup and add the non-modal dialog to it.
  * 
  * 
  **/
@@ -6730,6 +6732,8 @@
  * 
  * Creates a new #GtkWindowGroup object. Grabs added with
  * gtk_grab_add() only affect windows within the same #GtkWindowGroup.
+ * You can use this to create child dialogs to an already modal dialog by
+ * adding the child dialogs to a new #GtkWindowGroup than the modal parent.
  * 
  * Return value: a new #GtkWindowGroup. 
  **/
