Final doco updates for 1.1.0.

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

documentation/Fl_Text_Buffer.html

@@ -31,80 +31,88 @@ excellent NEdit text editor engine - see
 
 <H3>Methods</H3>
 
-<UL>
+<TABLE CELLPADDING="10">
+<TR VALIGN="TOP"><TD><UL>
 
-	<H4><A HREF="#Fl_Text_Buffer.Fl_Text_Buffer">Fl_Text_Buffer</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.Fl_Text_Buffer">Fl_Text_Buffer</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.~Fl_Text_Buffer">~Fl_Text_Buffer</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.~Fl_Text_Buffer">~Fl_Text_Buffer</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.add_modify_callback">add_modify_callback</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.add_modify_callback">add_modify_callback</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.append">append</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.append">append</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.appendfile">appendfile</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.appendfile">appendfile</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.call_modify_callbacks">call_modify_callbacks</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.call_modify_callbacks">call_modify_callbacks</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.character">character</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.character">character</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.character_width">character_width</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.character_width">character_width</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.clear_rectangular">clear_rectangular</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.clear_rectangular">clear_rectangular</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.copy">copy</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.copy">copy</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.count_displayed_characters">count_displayed_characters</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.count_displayed_characters">count_displayed_characters</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.count_lines">count_lines</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.count_lines">count_lines</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.expand_character">expand_character</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.expand_character">expand_character</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.findchar_backward">findchar_backward</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.findchar_backward">findchar_backward</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.findchar_forward">findchar_forward</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.findchar_forward">findchar_forward</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.findchars_backward">findchars_backward</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.findchars_backward">findchars_backward</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.findchars_forward">findchars_forward</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.findchars_forward">findchars_forward</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.highlight">highlight</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.highlight">highlight</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.highlight_position">highlight_position</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.highlight_position">highlight_position</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.highlight_rectangular">highlight_rectangular</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.highlight_rectangular">highlight_rectangular</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.highlight_selection">highlight_selection</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.highlight_selection">highlight_selection</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.highlight_text">highlight_text</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.highlight_text">highlight_text</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.insert_column">insert_column</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.insert_column">insert_column</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.insertfile">insertfile</A></H4>
+	<LI><A HREF="#Fl_Text_Buffer.insertfile">insertfile</A></LI>
-	<H4><A HREF="#Fl_Text_Buffer.insert">insert</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.length">length</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.line_end">line_end</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.line_start">line_start</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.line_text">line_text</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.loadfile">loadfile</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.null_substitution_character">null_substitution_character</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.outputfile">outputfile</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.overlay_rectangular">overlay_rectangular</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.primary_selection">primary_selection</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.remove_modify_callback">remove_modify_callback</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.remove_rectangular">remove_rectangular</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.remove">remove</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.remove_secondary_selection">remove_secondary_selection</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.remove_selection">remove_selection</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.replace_rectangular">replace_rectangular</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.replace">replace</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.replace_secondary_selection">replace_secondary_selection</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.replace_selection">replace_selection</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.rewind_lines">rewind_lines</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.savefile">savefile</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.search_backward">search_backward</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.search_forward">search_forward</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.secondary_selection_position">secondary_selection_position</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.secondary_selection">secondary_selection</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.secondary_selection_text">secondary_selection_text</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.secondary_select_rectangular">secondary_select_rectangular</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.secondary_select">secondary_select</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.secondary_unselect">secondary_unselect</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.selected">selected</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.selection_position">selection_position</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.selection_text">selection_text</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.select_rectangular">select_rectangular</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.select">select</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.skip_displayed_characters">skip_displayed_characters</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.skip_lines">skip_lines</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.substitute_null_characters">substitute_null_characters</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.tab_distance">tab_distance</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.text_in_rectangle">text_in_rectangle</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.text_range">text_range</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.text">text</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.unhighlight">unhighlight</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.unselect">unselect</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.unsubstitute_null_characters">unsubstitute_null_characters</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.word_end">word_end</A></H4>
-	<H4><A HREF="#Fl_Text_Buffer.word_start">word_start</A></H4>
 
-</UL>
+</UL></TD><TD><UL>
+
+	<LI><A HREF="#Fl_Text_Buffer.insert">insert</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.length">length</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.line_end">line_end</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.line_start">line_start</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.line_text">line_text</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.loadfile">loadfile</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.null_substitution_character">null_substitution_character</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.outputfile">outputfile</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.overlay_rectangular">overlay_rectangular</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.primary_selection">primary_selection</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.remove_modify_callback">remove_modify_callback</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.remove_rectangular">remove_rectangular</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.remove">remove</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.remove_secondary_selection">remove_secondary_selection</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.remove_selection">remove_selection</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.replace_rectangular">replace_rectangular</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.replace">replace</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.replace_secondary_selection">replace_secondary_selection</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.replace_selection">replace_selection</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.rewind_lines">rewind_lines</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.savefile">savefile</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.search_backward">search_backward</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.search_forward">search_forward</A></LI>
+
+</UL></TD><TD><UL>
+
+	<LI><A HREF="#Fl_Text_Buffer.secondary_selection_position">secondary_selection_position</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.secondary_selection">secondary_selection</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.secondary_selection_text">secondary_selection_text</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.secondary_select_rectangular">secondary_select_rectangular</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.secondary_select">secondary_select</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.secondary_unselect">secondary_unselect</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.selected">selected</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.selection_position">selection_position</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.selection_text">selection_text</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.select_rectangular">select_rectangular</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.select">select</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.skip_displayed_characters">skip_displayed_characters</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.skip_lines">skip_lines</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.substitute_null_characters">substitute_null_characters</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.tab_distance">tab_distance</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.text_in_rectangle">text_in_rectangle</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.text_range">text_range</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.text">text</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.unhighlight">unhighlight</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.unselect">unselect</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.unsubstitute_null_characters">unsubstitute_null_characters</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.word_end">word_end</A></LI>
+	<LI><A HREF="#Fl_Text_Buffer.word_start">word_start</A></LI>
+
+</UL></TD></TR>
+</TABLE>
 
 <H4><A NAME="Fl_Text_Buffer.Fl_Text_Buffer">Fl_Text_Buffer(int requestedSize = 0);</A></H4>
 

documentation/Fl_Text_Display.html

@@ -37,7 +37,8 @@ class.
 
 <H3>Methods</H3>
 
-<UL>
+<TABLE CELLPADDING="10">
+<TR VALIGN="TOP"><TD><UL>
 
 	<LI><A HREF="#Fl_Text_Display.Fl_Text_Display">Fl_Text_Display</A></LI>
 	<LI><A HREF="#Fl_Text_Display.~Fl_Text_Display">~Fl_Text_Display</A></LI>
@@ -49,6 +50,9 @@ class.
 	<LI><A HREF="#Fl_Text_Display.insert">insert</A></LI>
 	<LI><A HREF="#Fl_Text_Display.insert_position">insert_position</A></LI>
 	<LI><A HREF="#Fl_Text_Display.move_down">move_down</A></LI>
+
+</UL></TD><TD><UL>
+
 	<LI><A HREF="#Fl_Text_Display.move_left">move_left</A></LI>
 	<LI><A HREF="#Fl_Text_Display.move_right">move_right</A></LI>
 	<LI><A HREF="#Fl_Text_Display.move_up">move_up</A></LI>
@@ -58,6 +62,9 @@ class.
 	<LI><A HREF="#Fl_Text_Display.previous_word">previous_word</A></LI>
 	<LI><A HREF="#Fl_Text_Display.redisplay_range">redisplay_range</A></LI>
 	<LI><A HREF="#Fl_Text_Display.scrollbar_align">scrollbar_align</A></LI>
+
+</UL></TD><TD><UL>
+
 	<LI><A HREF="#Fl_Text_Display.scrollbar_width">scrollbar_width</A></LI>
 	<LI><A HREF="#Fl_Text_Display.scroll">scroll</A></LI>
 	<LI><A HREF="#Fl_Text_Display.show_cursor">show_cursor</A></LI>
@@ -68,7 +75,8 @@ class.
 	<LI><A HREF="#Fl_Text_Display.word_end">word_end</A></LI>
 	<LI><A HREF="#Fl_Text_Display.word_start">word_start</A></LI>
 
-</UL>
+</UL></TD></TR>
+</TABLE>
 
 <H4><A NAME="Fl_Text_Display.Fl_Text_Display">Fl_Text_Display(int X, int Y, int W, int H, const char *l = 0);</A></H4>
 

documentation/Fl_Text_Editor.html

@@ -35,7 +35,8 @@ class.
 
 <H3>Methods</H3>
 
-<UL>
+<TABLE CELLPADDING="10">
+<TR VALIGN="TOP"><TD><UL>
 
 	<LI><A HREF="#Fl_Text_Editor.Fl_Text_Editor">Fl_Text_Editor</A></LI>
 	<LI><A HREF="#Fl_Text_Editor.~Fl_Text_Editor">~Fl_Text_Editor</A></LI>
@@ -48,6 +49,9 @@ class.
 	<LI><A HREF="#Fl_Text_Editor.kf_copy">kf_copy</A></LI>
 	<LI><A HREF="#Fl_Text_Editor.kf_c_s_move">kf_c_s_move</A></LI>
 	<LI><A HREF="#Fl_Text_Editor.kf_ctrl_move">kf_ctrl_move</A></LI>
+
+</UL></TD><TD><UL>
+
 	<LI><A HREF="#Fl_Text_Editor.kf_cut">kf_cut</A></LI>
 	<LI><A HREF="#Fl_Text_Editor.kf_default">kf_default</A></LI>
 	<LI><A HREF="#Fl_Text_Editor.kf_delete">kf_delete</A></LI>
@@ -58,6 +62,9 @@ class.
 	<LI><A HREF="#Fl_Text_Editor.kf_ignore">kf_ignore</A></LI>
 	<LI><A HREF="#Fl_Text_Editor.kf_insert">kf_insert</A></LI>
 	<LI><A HREF="#Fl_Text_Editor.kf_left">kf_left</A></LI>
+
+</UL></TD><TD><UL>
+
 	<LI><A HREF="#Fl_Text_Editor.kf_move">kf_move</A></LI>
 	<LI><A HREF="#Fl_Text_Editor.kf_page_down">kf_page_down</A></LI>
 	<LI><A HREF="#Fl_Text_Editor.kf_page_up">kf_page_up</A></LI>
@@ -69,7 +76,8 @@ class.
 	<LI><A HREF="#Fl_Text_Editor.remove_all_key_bindings">remove_all_key_bindings</A></LI>
 	<LI><A HREF="#Fl_Text_Editor.remove_key_binding">remove_key_binding</A></LI>
 
-</UL>
+</UL></TD></TR>
+</TABLE>
 
 <H4><A NAME="Fl_Text_Editor.Fl_Text_Editor">Fl_Text_Editor(int X, int Y, int W, int H, const char* l = 0);</A></H4>
 

documentation/basics.html

@@ -33,6 +33,8 @@ int main(int argc, char **argv) {
 }
 </PRE></UL>
 
+<!-- NEED 2in -->
+
 <P>After including the required header files, the program then creates a
 window:</P>
 
@@ -114,11 +116,12 @@ of the form "type&nbsp;name()&nbsp;const".</P>
 <H3>Redrawing After Changing Attributes</H3>
 
 <P>Almost all of the set/get pairs are very fast, short inline
-functions and thus very efficient. However, <i>the "set"
+functions and thus very efficient. However, <i>the "set" methods
-methods do not call <TT>redraw()</TT></i> - you have to call it
+do not call <TT>redraw()</TT></i> - you have to call it
-yourself. This greatly reduces code size and execution time.
+yourself. This greatly reduces code size and execution time. The
-The only common exception is <tt>value()</tt> which calls
+only common exceptions are <tt>value()</tt> which calls
-<TT>redraw()</TT> if necessary.</P>
+<TT>redraw()</TT> and <tt>label()</tt> which calls
+<TT>redraw_label()</TT> if necessary.</P>
 
 <H3>Labels</H3>
 
@@ -239,14 +242,30 @@ used to get the options that are required by your linker:</P>
 CC ... `fltk-config --ldflags`
 </PRE></UL>
 
+<!-- NEED 2in -->
+
+<P>The forms, GL, and images libraries are included with the "--use-foo"
+options, as follows:
+
+<UL><PRE>
+CC ... `fltk-config --use-forms --ldflags`
+CC ... `fltk-config --use-gl --ldflags`
+CC ... `fltk-config --use-images --ldflags`
+CC ... `fltk-config --use-forms --use-gl --use-images --ldflags`
+</PRE></UL>
+
 <P>Finally, you can use the <TT>fltk-config</TT> script to
 compile a single source file as a FLTK program:
 
 <UL><PRE>
 fltk-config --compile filename.cpp
+fltk-config --use-forms --compile filename.cpp
+fltk-config --use-gl --compile filename.cpp
+fltk-config --use-images --compile filename.cpp
+fltk-config --use-forms --use-gl --use-images --compile filename.cpp
 </PRE></UL>
 
-<P>This will create an executable named <TT>filename</TT>.
+<P>Any of these will create an executable named <TT>filename</TT>.
 
 <H2>Compiling Programs with Microsoft Visual C++</H2>
 
@@ -288,6 +307,8 @@ better and can be used with the "optimized for speed" setting.</P>
 
 </UL>
 
+<!-- NEED 5in -->
+
 <H2>Header Files</H2>
 
 <P>The proper way to include FLTK header files is:</P>
@@ -296,10 +317,14 @@ better and can be used with the "optimized for speed" setting.</P>
 #include &lt;FL/Fl_xyz.H&gt;
 </PRE></UL>
 
-<P><B>Microsoft Windows developers please note:</B> case *is*
+<CENTER><TABLE BORDER="1" CELLPADDING="10" BGCOLOR="#cccccc">
-significant under other operating systems, and the C standard
+<TR>
-uses the forward  slash (/) to separate directories. <i>Do not
+	<TD><B>Note:</B>
-use any of the following include lines:</i></P>
+
+	<P>Case <I>is</I> significant on many operating systems,
+	and the C standard uses the forward slash (/) to
+	separate directories. <i>Do not use any of the following
+	include lines:</i></P>
 
 	<UL><PRE>
 	#include &lt;FL\Fl_xyz.H&gt;
@@ -307,5 +332,9 @@ use any of the following include lines:</i></P>
 	#include &lt;Fl/fl_xyz.h&gt;
 	</PRE></UL>
 
+	</TD>
+</TR>
+</TABLE></CENTER>
+
 </BODY>
 </HTML>

documentation/common.html

@@ -118,6 +118,8 @@ the <tt>value()</tt> of the widget.</P>
 widgets use an associated <TT>Fl_Text_Buffer</TT> class for the
 value, instead of a simple string.</P>
 
+<!-- NEED 4in -->
+
 <H2>Valuators</H2>
 
 <P>Unlike text widgets, valuators keep track of numbers instead of
@@ -150,6 +152,8 @@ and <A href="Fl_Valuator.html#Fl_Valuator.maximum"><TT>maximum()</TT></A>
 methods set the range of values that are reported by the
 widget.</P>
 
+<!-- NEED 5in -->
+
 <H2>Groups</H2>
 
 <P>The <TT>Fl_Group</TT> widget class is used as a general
@@ -224,9 +228,9 @@ fixed contents.</P>
 
 	<LI><TT>FL_CYAN</TT></LI>
 
-	<LI><TT>FL_WHITE</TT> (this is the default background color of text widgets)</LI>
+	<LI><TT>FL_WHITE</TT></LI>
 
-	<LI><TT>FL_GRAY</TT> (this is the default background color of most widgets)</LI>
+	<LI><TT>FL_GRAY</TT> (this is the default color of most widgets)</LI>
 </UL>
 
 <P>RGB colors can be set using the <A HREF="functions.html#fl_rgb_color"><TT>fl_rgb_color()</TT></A>
@@ -288,6 +292,8 @@ void xyz_draw(int x, int y, int w, int h, Fl_Color c) {
 }
 </PRE></UL>
 
+<!-- NEED 3in -->
+
 <P>A simple drawing function might fill a rectangle with the
 given color and then draw a black outline:</P>
 
@@ -331,6 +337,8 @@ sign. Figure 3-4 shows the available symbols.</P>
 <P ALIGN="CENTER"><A name="symbols"><IMG src="symbols.gif" ALT="FLTK Symbols"><BR>
 <I>Figure 3-4: FLTK label symbols</I></A></P>
 
+<!-- NEED 2in -->
+
 <P>The @ sign may also be followed by the following optional
 &quot;formatting&quot; characters, in this order:</P>
 

documentation/drawing.html

@@ -228,6 +228,8 @@ system-defined default of whatever value is fastest.
 Zero results in the system-defined default, which on both X and
 Windows is somewhat different and nicer than 1.
 
+<!-- NEED 4in -->
+
 <P><i>dashes</i> is a pointer to an array of dash lengths, measured in
 pixels.  The first location is how long to draw a solid portion, the
 next is how long to draw the gap, then the solid, etc.  It is

documentation/editor.html

@@ -23,6 +23,8 @@ lets define what we want our text editor to do:
 
 </OL>
 
+<!-- NEED 4in -->
+
 <H2>Designing the Main Window</H2>
 
 <P>Now that we've outlined the goals for our editor, we can begin with

documentation/events.html

@@ -241,6 +241,8 @@ indicate the possible drop position.
 the widget. If the widget returns 1, it will receive the data in
 the immediatly following FL_PASTE event.
 
+<!-- NEED 6in -->
+
 <H2><A name="event_xxx">Fl::event_*() methods</A></H2>
 
 <P>FLTK keeps the information about the most recent event in