Documentation updates galore (up to chapter 7, still need to do chapter

8 and 9, tweek the appendices, and recapture the screenshots...)


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

1 files changed, 61 insertions, 61 deletions

diff --git a/documentation/Fl_Input.html b/documentation/Fl_Input.html
index a99da8d93..5474d5e37 100644
--- a/documentation/Fl_Input.html
+++ b/documentation/Fl_Input.html
@@ -20,13 +20,13 @@
 </PRE>
 </UL>
 <H3>Description</H3>
-<P>This is the FLTK text input widget.  It displays a single line of text 
-and lets the user edit it.  Normally it is drawn with an inset box and 
-a white background.  The text may contain any characters (even 0), and 
-will correctly display anything, using ^X notation for unprintable 
-control characters and \nnn notation for unprintable characters with 
-the high bit set. It assumes the font can draw any characters in the 
-ISO-8859-1 character set. 
+<P>This is the FLTK text input widget.  It displays a single line of text
+and lets the user edit it.  Normally it is drawn with an inset box and
+a white background.  The text may contain any characters (even 0), and
+will correctly display anything, using ^X notation for unprintable
+control characters and \nnn notation for unprintable characters with
+the high bit set. It assumes the font can draw any characters in the
+ISO-8859-1 character set.
 
 <CENTER><TABLE border=1 WIDTH=90% summary="Fl_Input keyboard and mouse bindings.">
 
@@ -43,32 +43,32 @@ clipboard by selecting the region with mouse button 2.
 
 <TR><TD><B>Mouse button 3</B></TD><TD>Currently acts like button 1.</TD></TR>
 
-<TR><TD><B>Backspace</B></TD><TD>Deletes one character to the left, or 
+<TR><TD><B>Backspace</B></TD><TD>Deletes one character to the left, or
 deletes the selected region.</TD></TR>
 <TR><TD><B>Enter</B></TD><TD>May cause the callback, see when().</TD></TR>
 <TR><TD><B>^A or Home</B></TD><TD>Go to start of line.</TD></TR>
 <TR><TD><B>^B or Left</B></TD><TD>Move left</TD></TR>
 <TR><TD><B>^C</B></TD><TD>Copy the selection to the clipboard</TD></TR>
-<TR><TD><B>^D or Delete</B></TD><TD>Deletes one character to the right 
+<TR><TD><B>^D or Delete</B></TD><TD>Deletes one character to the right
 or deletes the selected region.</TD></TR>
 <TR><TD><B>^E or End</B></TD><TD>Go to the end of line.</TD></TR>
 <TR><TD><B>^F or Right</B></TD><TD>Move right</TD></TR>
-<TR><TD><B>^K</B></TD><TD>Delete to the end of line (next \n character) 
-or deletes a single \n character.  These deletions are all concatenated 
+<TR><TD><B>^K</B></TD><TD>Delete to the end of line (next \n character)
+or deletes a single \n character.  These deletions are all concatenated
 into the clipboard.</TD></TR>
-<TR><TD><B>^N or Down</B></TD><TD>Move down (for Fl_Multiline_Input 
+<TR><TD><B>^N or Down</B></TD><TD>Move down (for Fl_Multiline_Input
 only, otherwise it moves to the next input field).</TD></TR>
-<TR><TD><B>^P or Up</B></TD><TD>Move up (for Fl_Multiline_Input only, 
+<TR><TD><B>^P or Up</B></TD><TD>Move up (for Fl_Multiline_Input only,
 otherwise it moves to the previous input field).</TD></TR>
 <TR><TD><B>^U</B></TD><TD>Delete everything.</TD></TR>
 <TR><TD><B>^V or ^Y</B></TD><TD>Paste the clipboard</TD></TR>
-<TR><TD><B>^X or ^W</B></TD><TD>Copy the region to the clipboard and 
+<TR><TD><B>^X or ^W</B></TD><TD>Copy the region to the clipboard and
 delete it.</TD></TR>
-<TR><TD><B>^Z or ^_</B></TD><TD>Undo.  This is a single-level undo 
-mechanism, but all adjacent deletions and insertions are concatenated 
-into a single &quot;undo&quot;.  Often this will undo a lot more than you 
+<TR><TD><B>^Z or ^_</B></TD><TD>Undo.  This is a single-level undo
+mechanism, but all adjacent deletions and insertions are concatenated
+into a single &quot;undo&quot;.  Often this will undo a lot more than you
 expected.</TD></TR>
-<TR><TD><B>Shift+move</B></TD><TD>Move the cursor but also extend the 
+<TR><TD><B>Shift+move</B></TD><TD>Move the cursor but also extend the
 selection.</TD></TR>
 
 <TR><TD><B>RightCtrl or
@@ -259,76 +259,76 @@ inserted.
 </TD></TR>
 </TABLE>
 </CENTER>
-<H4><A name=Fl_Input.Fl_Input>Fl_Input::Fl_Input(int x, int y, int w, 
+<H4><A name=Fl_Input.Fl_Input>Fl_Input::Fl_Input(int x, int y, int w,
 int h, const char *label = 0)</A></H4>
- Creates a new <TT>Fl_Input</TT> widget using the given position, size, 
-and label string. The default boxtype is <TT>FL_DOWN_BOX</TT>. 
+ Creates a new <TT>Fl_Input</TT> widget using the given position, size,
+and label string. The default boxtype is <TT>FL_DOWN_BOX</TT>.
 <H4><A name=Fl_Input.~Fl_Input>virtual Fl_Input::~Fl_Input()</A></H4>
- Destroys the widget and any value associated with it. 
+ Destroys the widget and any value associated with it.
 <H4><A name=Fl_Input.value>const char *Fl_Input::value() const
 <BR> int Fl_Input::value(const char*)
 <BR> int Fl_Input::value(const char*, int)</A></H4>
- The first form returns the current value, which is a pointer to the 
-internal buffer and is valid only until the next event is handled. 
-<P>The second two forms change the text and set the mark and the point 
+ The first form returns the current value, which is a pointer to the
+internal buffer and is valid only until the next event is handled.
+<P>The second two forms change the text and set the mark and the point
 to the end of it. The string is copied to the internal buffer.  Passing <TT>
-NULL</TT> is the same as &quot;&quot;.  This returns non-zero if the new value is 
-different than the current one.  You can use the second version to 
-directly set the length if you know it already or want to put nul's in 
+NULL</TT> is the same as &quot;&quot;.  This returns non-zero if the new value is
+different than the current one.  You can use the second version to
+directly set the length if you know it already or want to put nul's in
 the text. </P>
-<H4><A name=Fl_Input.static_value>int Fl_Input::static_value(const 
+<H4><A name=Fl_Input.static_value>int Fl_Input::static_value(const
 char*)
 <BR> int Fl_Input::static_value(const char*, int)</A></H4>
- Change the text and set the mark and the point to the end of it.  The 
-string is <I>not</I> copied.  If the user edits the string it is copied 
-to the internal buffer then.  This can save a great deal of time and 
-memory if your program is rapidly changing the values of text fields, 
-but this will only work if the passed string remains unchanged until 
-either the <TT>Fl_Input</TT> is destroyed or <TT>value()</TT> is called 
-again. 
+ Change the text and set the mark and the point to the end of it.  The
+string is <I>not</I> copied.  If the user edits the string it is copied
+to the internal buffer then.  This can save a great deal of time and
+memory if your program is rapidly changing the values of text fields,
+but this will only work if the passed string remains unchanged until
+either the <TT>Fl_Input</TT> is destroyed or <TT>value()</TT> is called
+again.
 <H4><A name=Fl_Input.size>int Fl_Input::size() const</A></H4>
- Returns the number of characters in <TT>value()</TT>.  This may be 
-greater than <TT>strlen(value())</TT> if there are nul characters in 
-it. 
+ Returns the number of characters in <TT>value()</TT>.  This may be
+greater than <TT>strlen(value())</TT> if there are nul characters in
+it.
 <H4><A name=Fl_Input.index>char Fl_Input::index(int) const</A></H4>
- Same as <TT>value()[n]</TT>, but may be faster in plausible 
-implementations. No bounds checking is done. 
+ Same as <TT>value()[n]</TT>, but may be faster in plausible
+implementations. No bounds checking is done.
 <H4><A name=Fl_Input.when>Fl_When Fl_Widget::when() const
 <BR> void Fl_Widget::when(Fl_When)</A></H4>
- Controls when callbacks are done.  The following values are useful, 
-the default value is <TT>FL_WHEN_RELEASE</TT>: 
+ Controls when callbacks are done.  The following values are useful,
+the default value is <TT>FL_WHEN_RELEASE</TT>:
 <UL>
-<LI><TT>0</TT>: The callback is not done, but <TT>changed()</TT> is 
+<LI><TT>0</TT>: The callback is not done, but <TT>changed()</TT> is
  turned on. </LI>
-<LI><TT>FL_WHEN_CHANGED</TT>: The callback is done each time the  text 
+<LI><TT>FL_WHEN_CHANGED</TT>: The callback is done each time the  text
 is changed by the user. </LI>
-<LI><TT>FL_WHEN_RELEASE</TT>: The callback will  be done when this 
-widget loses the focus, including when the window is  unmapped.  This 
-is a useful value for text fields in a panel where  doing the callback 
-on every change is wasteful.  However the callback  will also happen if 
-the mouse is moved out of the window, which means  it should not do 
-anything visible (like pop up an error message).  You  might do better 
+<LI><TT>FL_WHEN_RELEASE</TT>: The callback will  be done when this
+widget loses the focus, including when the window is  unmapped.  This
+is a useful value for text fields in a panel where  doing the callback
+on every change is wasteful.  However the callback  will also happen if
+the mouse is moved out of the window, which means  it should not do
+anything visible (like pop up an error message).  You  might do better
 setting this to zero, and scanning all the items for <TT>changed()</TT>
  when the OK button on a panel is pressed. </LI>
-<LI><TT>FL_WHEN_ENTER_KEY</TT>: If the user types the Enter  key, the 
-entire text is selected, and the callback is done if  the text has 
-changed.  Normally the Enter key will navigate to  the next field (or 
-insert a newline for a <TT>Fl_Mulitline_Input</TT>), this changes the 
+<LI><TT>FL_WHEN_ENTER_KEY</TT>: If the user types the Enter  key, the
+entire text is selected, and the callback is done if  the text has
+changed.  Normally the Enter key will navigate to  the next field (or
+insert a newline for a <TT>Fl_Mulitline_Input</TT>), this changes the
 behavior. </LI>
-<LI><TT>FL_WHEN_ENTER_KEY|FL_WHEN_NOT_CHANGED</TT>: The Enter key  will 
-do the callback even if the text has not changed.  Useful for  command 
+<LI><TT>FL_WHEN_ENTER_KEY|FL_WHEN_NOT_CHANGED</TT>: The Enter key  will
+do the callback even if the text has not changed.  Useful for  command
 fields. </LI>
 </UL>
 <H4><A name=Fl_Input.textcolor>Fl_Color Fl_Input::textcolor() const
 <BR> void Fl_Input::textcolor(Fl_Color)</A></H4>
- Gets or sets the color of the text in the input field. 
+ Gets or sets the color of the text in the input field.
 <H4><A name=Fl_Input.textfont>Fl_Font Fl_Input::textfont() const
 <BR> void Fl_Input::textfont(Fl_Font)</A></H4>
- Gets or sets the font of the text in the input field. 
+ Gets or sets the font of the text in the input field.
 <H4><A name=Fl_Input.textsize>uchar Fl_Input::textsize() const
 <BR> void Fl_Input::textsize(uchar)</A></H4>
- Gets or sets the size of the text in the input field. 
-<H4><A name=Fl_Input.cursor_color>Fl_Color Fl_Input::cursor_color() 
+ Gets or sets the size of the text in the input field.
+<H4><A name=Fl_Input.cursor_color>Fl_Color Fl_Input::cursor_color()
 const
 <BR> void Fl_Input::cursor_color(Fl_Color)</A></H4>
  Get or set the color of the cursor.  This is black by default.