From f6de9c9692cf13e8df8dc980c2a5e7c73773a432 Mon Sep 17 00:00:00 2001
From: Matthias Melcher <fltk@matthiasm.com>
Date: Sat, 6 Oct 2007 17:42:05 +0000
Subject: Updated Fl_Menu_ documentation with a warning to not change the
 structure of a menu during a callback by itself.

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@5943 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
---
 documentation/Fl_Menu_.html | 9 +++++++++
 1 file changed, 9 insertions(+)

(limited to 'documentation')

diff --git a/documentation/Fl_Menu_.html b/documentation/Fl_Menu_.html
index 9f04267f7..64eaacbd9 100644
--- a/documentation/Fl_Menu_.html
+++ b/documentation/Fl_Menu_.html
@@ -144,6 +144,9 @@ Text shortcuts are converted to integer shortcut by calling
 
 <P>The return value is the index into the array that the entry was put. </P>
 
+<P>No items must be added to a menu during a callback to the same menu.</P>
+
+
 <h4>int Fl_Menu_::add(const char *)</H4>
 
 <P>The passed string is split at any '|' characters and then
@@ -153,11 +156,15 @@ with Forms and other GL programs. The section strings use the
 same special characters as described for the long version of <a
 href='#Fl_Menu_.add'><tt>add()</tt></a></p>
 
+<P>No items must be added to a menu during a callback to the same menu.</P>
+
 
 <H4><A name=Fl_Menu_.clear>void Fl_Menu_::clear()</A></H4>
 Same as <tt>menu(NULL)</tt>, set the array pointer to null, indicating
 a zero-length menu.
 
+<P>Menus must no be cleared during a callback to the same menu.</P>
+
 
 <H4><A name=Fl_Menu_.copy>void Fl_Menu_::copy(const
 Fl_Menu_Item*, void* user_data = 0)</A></H4>
@@ -233,6 +240,8 @@ const</a></h4>
 Deletes item <TT>n</TT> from the menu.  If the menu array was directly
 set with menu(x) then copy() is done to make a private array.
 
+<P>No items must be removed from a menu during a callback to the same menu.</P>
+
 
 <H4><A name=Fl_Menu_.replace>void Fl_Menu_::replace(int n, const char *)</A>
 </H4>
-- 
cgit v1.2.3