3 files changed, 34 insertions, 16 deletions
diff --git a/documentation/Fl_Input_.html b/documentation/Fl_Input_.html
index 72792528f..5123405f3 100644
--- a/documentation/Fl_Input_.html
+++ b/documentation/Fl_Input_.html
@@ -223,12 +223,13 @@ l=0)</A></H4>
 leave the mark and position after it. If <TT>l</TT> is not zero
 then it is assumed to be <TT>strlen(t)</TT>.
 
-<H4><A name="Fl_Input_.copy">int Fl_Input_::copy()</A></H4>
+<H4><A name="Fl_Input_.copy">int Fl_Input_::copy(int clipboard)</A></H4>
 
 <P>Put the current selection between <TT>mark()</TT> and
-<TT>position()</TT> into the clipboard.  Does not replace the
-old clipboard contents if <TT>position()</TT> and
-<TT>mark()</TT> are equal.
+<TT>position()</TT> into the specified clipboard.  Does not
+replace the old clipboard contents if <TT>position()</TT> and
+<TT>mark()</TT> are equal. Clipboard 0 maps to the current text
+selection and clipboard 1 maps to the cut/paste clipboard.
 
 <H4><A name="Fl_Input_.undo">int Fl_Input_::undo()</A></H4>
 
diff --git a/documentation/Fl_Menu_.html b/documentation/Fl_Menu_.html
index 7a1bbe7f5..19aebbe7d 100644
--- a/documentation/Fl_Menu_.html
+++ b/documentation/Fl_Menu_.html
@@ -50,22 +50,23 @@ be "private": a dynamically allocated array managed by the Fl_Menu_.
 </TD><TD align=left valign=top>
 <UL>
 <LI><A href=#Fl_Menu_.mode>mode</A></LI>
+<LI><A href=#Fl_Menu_.mvalue>mvalue</A></LI>
 <LI><A href=#Fl_Menu_.remove>remove</A></LI>
 <LI><A href=#Fl_Menu_.replace>replace</A></LI>
-<LI><A href=#Fl_Menu_.shortcut>shortcut</A></LI>
 </UL>
 </TD><TD align=left valign=top>
 <UL>
+<LI><A href=#Fl_Menu_.shortcut>shortcut</A></LI>
 <LI><A href=#Fl_Menu_.size>size</A></LI>
 <LI><A href=#Fl_Menu_.test_shortcut>test_shortcut</A></LI>
 <LI><A href=#Fl_Menu_.text>text</A></LI>
-<LI><A href=#Fl_Menu_.textcolor>textcolor</A></LI>
 </UL>
 </TD><TD align=left valign=top>
 <UL>
 <LI><A href=#Fl_Menu_.textfont>textfont</A></LI>
 <LI><A href=#Fl_Menu_.textsize>textsize</A></LI>
 <LI><A href=#Fl_Menu_.value>value</A></LI>
+<LI><A href=#Fl_Menu_.textcolor>textcolor</A></LI>
 </UL>
 </TD></TR>
 </TABLE>
@@ -93,10 +94,19 @@ deleted.  <tt>NULL</tt> is allowed and acts the same as a zero-length
 menu.  If you try to modify the array (with add(), replace(), or
 delete()) a private copy is automatically done.
 
+<H4><A name=Fl_Menu_.mvalue>const Fl_Menu_Item* Fl_Menu_::mvalue()
+const</a></h4>
+
+<P>Returns a pointer to the last menu item that was picked.
+
 <H4><A name=Fl_Menu_.copy>void Fl_Menu_::copy(const
-Fl_Menu_Item*)</A></H4>
-The menu is set to a private copy of the passed Fl_Menu_Item array.
-This is useful if you want to modify the flags of the menu items.
+Fl_Menu_Item*, void* user_data = 0)</A></H4>
+
+<P>The menu is set to a private copy of the passed Fl_Menu_Item
+array. This is useful if you want to modify the flags of the
+menu items. If the <tt>user_data</tt> argument is non-NULL, then
+the <tt>user_data</tt> members of the menu items are set to the
+given value.
 
 <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
diff --git a/documentation/Fl_Text_Buffer.html b/documentation/Fl_Text_Buffer.html
index a7629e26b..5fe02c47c 100644
--- a/documentation/Fl_Text_Buffer.html
+++ b/documentation/Fl_Text_Buffer.html
@@ -223,7 +223,8 @@ int* rectEnd);</A></H4>
 
 <H4><A NAME="Fl_Text_Buffer.highlight_text">const char* highlight_text();</A></H4>
 
-<P>Returns the highlighted text.
+<P>Returns the highlighted text. When you are done with the
+text, free it using the <tt>free()</tt> function.
 
 <H4><A NAME="Fl_Text_Buffer.insert_column">void insert_column(int column, int startPos, const char* text,
 int* charsInserted, int* charsDeleted);</A></H4>
@@ -253,7 +254,8 @@ int* charsInserted, int* charsDeleted);</A></H4>
 <H4><A NAME="Fl_Text_Buffer.line_text">const char* line_text(int pos);</A></H4>
 
 <P>Returns the text for the line containing the specified
-character position.
+character position. When you are done with the text, free it
+using the <tt>free()</tt> function.
 
 <H4><A NAME="Fl_Text_Buffer.loadfile">int loadfile(const char *file, int buflen = 128*1024);</A></H4>
 
@@ -340,7 +342,8 @@ int* rectStart, int* rectEnd);</A></H4>
 
 <H4><A NAME="Fl_Text_Buffer.secondary_selection_text">const char* secondary_selection_text();</A></H4>
 
-<P>Returns the text in the secondary selection.
+<P>Returns the text in the secondary selection. When you are
+done with the text, free it using the <tt>free()</tt> function.
 
 <H4><A NAME="Fl_Text_Buffer.secondary_select_rectangular">void secondary_select_rectangular(int start, int end, int rectStart,
 int rectEnd);</A></H4>
@@ -367,7 +370,8 @@ int selection_position(int* start, int* end, int* isRect, int* rectStart, int* r
 
 <H4><A NAME="Fl_Text_Buffer.selection_text">const char* selection_text();</A></H4>
 
-<P>Returns the currently selected text.
+<P>Returns the currently selected text. When you are done with
+the text, free it using the <tt>free()</tt> function.
 
 <H4><A NAME="Fl_Text_Buffer.select_rectangular">void select_rectangular(int start, int end, int rectStart, int rectEnd);</A></H4>
 
@@ -399,16 +403,19 @@ void tab_distance(int tabDist);</A></H4>
 
 <H4><A NAME="Fl_Text_Buffer.text_in_rectangle">const char* text_in_rectangle(int start, int end, int rectStart, int rectEnd);</A></H4>
 
-<P>Returns the text from the given rectangle.
+<P>Returns the text from the given rectangle. When you are done
+with the text, free it using the <tt>free()</tt> function.
 
 <H4><A NAME="Fl_Text_Buffer.text_range">const char* text_range(int start, int end);</A></H4>
 
-<P>Returns the text from the range of characters.
+<P>Returns the text from the range of characters. When you are
+done with the text, free it using the <tt>free()</tt> function.
 
 <H4><A NAME="Fl_Text_Buffer.text">const char* text();<BR>
 void text(const char* text);</A></H4>
 
-<P>Gets or sets the text in the buffer.
+<P>Gets or sets the text in the buffer. When you are done with
+the text, free it using the <tt>free()</tt> function.
 
 <H4><A NAME="Fl_Text_Buffer.unhighlight">void unhighlight();</A></H4>