Documentation updates (STR #505, STR #513)

The old source file "fl_set_gray.cxx" is not needed (STR #516)

Fl_Text_Display still called delete[] instead of free() in one
place (STR #503)

Fl_File_Chooser didn't correctly call isprint() and isspace()
when checking to see if the current file was text that can be
previewed (STR #517)

FLUID didn't compile with Borland C++ due to a compiler bug (STR
#496)

Fl_Positioner did not handle reversed min and max values (STR
#510)

fl_descent(), fl_height(), and fl_width() would crash a program
if you didn't call fl_font() first; they now return -1 if no
font is set (STR #500)


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

2 files changed, 21 insertions, 4 deletions

diff --git a/documentation/Fl_Group.html b/documentation/Fl_Group.html
index f4509b303..21d912d72 100644
--- a/documentation/Fl_Group.html
+++ b/documentation/Fl_Group.html
@@ -81,7 +81,12 @@ to the end of this group.
 
 <H4><A name="Fl_Group.clear">void Fl_Group::clear()</A></H4>
 
-<P>The <TT>clear()</TT> method deletes all child widgets recursively.
+<p>The <tt>clear()</tt> method deletes all child widgets from
+memory recursively.</p>
+
+<p>This method differs from the <a
+href='#Fl_Group.remove'><tt>remove()</tt></a> method in that it
+affects all child widgets and deletes them from memory.</p>
 
 <H4><A name="Fl_Group.init_sizes">void Fl_Group::init_sizes()</A></H4>
 
@@ -104,8 +109,15 @@ This does <tt>insert(w, find(beforethis))</tt>.  This will append the
 widget if <tt>beforethis</tt> is not in the group.
 
 <H4><A name=Fl_Group.remove>void Fl_Group::remove(Fl_Widget &amp;w)</A></H4>
-Removes a widget from the group. This does nothing if the widget is
-not currently a child of this group.
+
+<p>Removes a widget from the group but does not delete it. This
+method does nothing if the widget is not a child of the
+group.</p>
+
+<p>This method differs from the <a
+href='#Fl_Group.clear'><tt>clear()</tt></a> method in that it
+only affects a single widget and does not delete it from
+memory.</p>
 
 <H4><A name=Fl_Group.current>static Fl_Group *Fl_Group::current()
 <BR> static void Fl_Group::current(Fl_Group *w)</A></H4>
diff --git a/documentation/osissues.html b/documentation/osissues.html
index a140dc6b8..045921bbf 100644
--- a/documentation/osissues.html
+++ b/documentation/osissues.html
@@ -333,7 +333,7 @@ MyWindow::~MyWindow() {
 
 <H3>Setting the Icon of a Window</H3>
 
-<P>FLTK currently supports setting a window's icon *before* it
+<P>FLTK currently supports setting a window's icon <b>before</b> it
 is shown using the <TT>Fl_Window::icon()</TT> method.
 
 <H4>void Fl_Window::icon(char *)</H4>
@@ -358,6 +358,7 @@ window-&gt;icon((char *)p);
 should be used as follows:
 
 <UL><PRE>
+#include &lt;X11/xpm.h&gt;
 #include &quot;icon.xpm&quot;
 
 fl_opendisplay();                // needed if display has not been previously opened
@@ -370,6 +371,10 @@ XpmCreatePixmapFromData(fl_display, DefaultRootWindow(fl_display),
 window-&gt;icon((char *)p);
 </PRE></UL>
 
+<p>When using the Xpm library, be sure to include it in the list
+of libraries that are used to link the application (usually
+"-lXpm").</p>
+
 <CENTER><TABLE WIDTH="90%" BORDER="1" CELLPADDING="5" CELLSPACING="0" BGCOLOR="#cccccc">
 <TR>
 	<TD><B>NOTE:</B>