STR 1306: udated documentation to reflect limitation in Fl::delete_widget(). For a different bug, I was forced to implement an automated widget deletion system which seems to work well. I would like to reuse that for all cases that depend on 'delete_widget', making 'delete_widget' obsolete. I will change the STR accordingly.

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@5195 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

CHANGES

@@ -1,5 +1,7 @@
 CHANGES IN FLTK 1.1.8
 
+	- Updated documentation to reflect limitation of 
+	  Fl::delete_widget() (STR #1306)
 	- Fixed line wrapping in Fl_Text_Display (STR #1227)
 	- New function Fl::event_original_key() returns key 
 	  code before NumLock handling.

documentation/Fl.html

@@ -501,9 +501,14 @@ window and then calls the default widget callback.</p>
 
 <H4><A NAME="Fl.delete_widget">void delete_widget(Fl_Widget*);</A></H4>
 
-<p>Schedules a widget for deletion when it is safe to do so. Use
+<p>Schedules a widget for deletion at the next call to the event loop.
-this method to delete a widget inside a callback function. When
+Use this method to delete a widget inside a callback function. 
-deleting groups or windows, you must only delete the group or
+To avoid early deletion of widgets, this function
+should be called toward the end of a callback and only after any call 
+to the event loop (<tt>Fl:wait()</tt>, <tt>Fl::flush()</tt>, 
+<tt>fl_ask()</tt>, etc).</p>
+
+<p>When deleting groups or windows, you must only delete the group or
 window widget and not the individual child widgets.</p>
 
 <H4><A NAME="Fl.display">void display(const char*);</A></H4>