summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--CHANGES2
-rw-r--r--documentation/Fl.html11
2 files changed, 10 insertions, 3 deletions
diff --git a/CHANGES b/CHANGES
index d8bd5cf45..0dbee1bbf 100644
--- a/CHANGES
+++ b/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.
diff --git a/documentation/Fl.html b/documentation/Fl.html
index ac42de887..a20e913d4 100644
--- a/documentation/Fl.html
+++ b/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
-this method to delete a widget inside a callback function. When
-deleting groups or windows, you must only delete the group or
+<p>Schedules a widget for deletion at the next call to the event loop.
+Use this method to delete a widget inside a callback function.
+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>