Some clarification regarding modality. (#112903, Dave Bordoley)

2005-01-03  Matthias Clasen  <mclasen@redhat.com>

	* gtk/gtkdialog.c (gtk_dialog_run): Some clarification
	regarding modality.  (#112903, Dave Bordoley)

ChangeLog

 2005-01-03  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/gtkdialog.c (gtk_dialog_run): Some clarification
+	regarding modality.  (#112903, Dave Bordoley)
+
 	* gtk/gtkfixed.c (gtk_fixed_set_has_window): 
 	Add a little motivation.  (#145556, Tommi Komulainen)
 

ChangeLog.pre-2-10

 2005-01-03  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/gtkdialog.c (gtk_dialog_run): Some clarification
+	regarding modality.  (#112903, Dave Bordoley)
+
 	* gtk/gtkfixed.c (gtk_fixed_set_has_window): 
 	Add a little motivation.  (#145556, Tommi Komulainen)
 

ChangeLog.pre-2-6

 2005-01-03  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/gtkdialog.c (gtk_dialog_run): Some clarification
+	regarding modality.  (#112903, Dave Bordoley)
+
 	* gtk/gtkfixed.c (gtk_fixed_set_has_window): 
 	Add a little motivation.  (#145556, Tommi Komulainen)
 

ChangeLog.pre-2-8

 2005-01-03  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/gtkdialog.c (gtk_dialog_run): Some clarification
+	regarding modality.  (#112903, Dave Bordoley)
+
 	* gtk/gtkfixed.c (gtk_fixed_set_has_window): 
 	Add a little motivation.  (#145556, Tommi Komulainen)
 

gtk/gtkdialog.c

@@ -967,6 +967,12 @@ run_destroy_handler (GtkDialog *dialog, gpointer data)
  *   gtk_widget_destroy (dialog);
  * </programlisting></informalexample>
  * 
+ * Note that even though the recursive main loop gives the effect of a
+ * modal dialog (it prevents the user from interacting with other 
+ * windows while the dialog is run), callbacks such as timeouts, 
+ * IO channel watches, DND drops, etc, <emphasis>will</emphasis> be 
+ * triggered during a gtk_dialog_run() call.
+ * 
  * Return value: response ID
  **/
 gint