Doco updates.

Reset cursor when changing the current pane in an Fl_Wizard widget.


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

1 files changed, 54 insertions, 0 deletions

diff --git a/documentation/Fl_Text_Display.html b/documentation/Fl_Text_Display.html
index 56cd69570..8d17db109 100644
--- a/documentation/Fl_Text_Display.html
+++ b/documentation/Fl_Text_Display.html
@@ -72,98 +72,152 @@ class.
 
 <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>
 
+<P>Creates a new text display widget.
 
 <H4><A NAME="Fl_Text_Display.~Fl_Text_Display">~Fl_Text_Display();</A></H4>
 
+<P>Destroys a text display widget.
 
 <H4><A NAME="Fl_Text_Display.buffer">void buffer(Fl_Text_Buffer* buf);<BR>
 void buffer(Fl_Text_Buffer&amp; buf);<BR>
 Fl_Text_Buffer* buffer();</A></H4>
 
+<P>Sets or gets the current text buffer associated with the text widget.
+Multiple text widgets can be associated with the same text buffer.
+
 <H4><A NAME="Fl_Text_Display.cursor_style">void cursor_style(int style);</A></H4>
 
+<P>Sets the text cursor style to one of the following:
+
+<UL>
+
+	<LI><CODE>Fl_Text_Display::NORMAL_CURSOR</CODE> - Shows an I beam.
+
+	<LI><CODE>Fl_Text_Display::CARET_CURSOR</CODE> - Shows a caret under the text.
+
+	<LI><CODE>Fl_Text_Display::DIM_CURSOR</CODE> - Shows a dimmed I beam.
+
+	<LI><CODE>Fl_Text_Display::BLOCK_CURSOR</CODE> - Shows an unfilled box around the current
+	character.
+
+	<LI><CODE>Fl_Text_Display::HEAVY_CURSOR</CODE> - Shows a thick I beam.
+
+</UL>
 
 <H4><A NAME="Fl_Text_Display.hide_cursor">void hide_cursor();</A></H4>
 
+<P>Hides the text cursor.
 
 <H4><A NAME="Fl_Text_Display.highlight_data">void highlight_data(Fl_Text_Buffer *styleBuffer,
 Style_Table_Entry *styleTable, int nStyles, char
 unfinishedStyle, Unfinished_Style_Cb unfinishedHighlightCB, void
 *cbArg);</A></H4>
 
+<P>Sets the text buffer, text styles, and callbacks to use when
+displaying text in the widget. Style buffers cannot be shared
+between widgets and are often used to do syntax highlighting.
+The editor example from <A HREF="editor.html">Chapter 4</A>
+shows how to use the <CODE>highlight_data()</CODE> method.
 
 <H4><A NAME="Fl_Text_Display.in_selection">int in_selection(int x, int y);</A></H4>
 
+<P>Returns non-zero if the specified mouse position is inside the current
+selection.
 
 <H4><A NAME="Fl_Text_Display.insert">void insert(const char* text);</A></H4>
 
+<P>Inserts text at the current insert position.
 
 <H4><A NAME="Fl_Text_Display.insert_position">void insert_position(int newPos);<BR>
 int insert_position()</A></H4>
 
+<P>Sets or gets the current insert position.
 
 <H4><A NAME="Fl_Text_Display.move_down">int move_down();</A></H4>
 
+<P>Moves the current insert position down one line.
 
 <H4><A NAME="Fl_Text_Display.move_left">int move_left();</A></H4>
 
+<P>Moves the current insert position left one character.
 
 <H4><A NAME="Fl_Text_Display.move_right">int move_right();</A></H4>
 
+<P>Moves the current insert position right one character.
 
 <H4><A NAME="Fl_Text_Display.move_up">int move_up();</A></H4>
 
+<P>Moves the current insert position up one line.
 
 <H4><A NAME="Fl_Text_Display.next_word">void next_word(void);</A></H4>
 
+<P>Moves the current insert position right one word.
 
 <H4><A NAME="Fl_Text_Display.overstrike">void overstrike(const char* text);</A></H4>
 
+<P>Replaces text at the current insert position.
 
 <H4><A NAME="Fl_Text_Display.position_style">int position_style(int lineStartPos, int lineLen, int lineIndex,
 int dispIndex);</A></H4>
 
+<P>Returns the style associated with the character at position
+<CODE>lineStartPos + lineIndex</CODE>.
 
 <H4><A NAME="Fl_Text_Display.previous_word">void previous_word(void);</A></H4>
 
+<P>Moves the current insert position left one word.
 
 <H4><A NAME="Fl_Text_Display.redisplay_range">void redisplay_range(int start, int end);</A></H4>
 
+<P>Marks text from <CODE>start</CODE> to <CODE>end</CODE> as needing a redraw.
 
 <H4><A NAME="Fl_Text_Display.scrollbar_align">void scrollbar_align(Fl_Align a);<BR>
 Fl_Align scrollbar_align();</A></H4>
 
+<P>Sets or gets where scrollbars are attached to the widget -
+<CODE>FL_ALIGN_LEFT</CODE> and <CODE>FL_ALIGN_RIGHT</CODE> for
+the vertical scrollbar and <CODE>FL_ALIGN_TOP</CODE> and
+<CODE>FL_ALIGN_BOTTOM</CODE> for the horizontal scrollbar.
 
 <H4><A NAME="Fl_Text_Display.scrollbar_width">void scrollbar_width(int w);<BR>
 int scrollbar_width();</A></H4>
 
+<P>Sets or gets the width/height of the scrollbars.
 
 <H4><A NAME="Fl_Text_Display.scroll">void scroll(int topLineNum, int horizOffset);</A></H4>
 
+<P>Scrolls the current buffer to start at the specified line and column.
 
 <H4><A NAME="Fl_Text_Display.show_cursor">void show_cursor(int b = 1);</A></H4>
 
+<P>Shows or hides the text cursor.
 
 <H4><A NAME="Fl_Text_Display.show_insert_position">void show_insert_position();</A></H4>
 
+<P>Scrolls the text buffer to show the current insert position.
 
 <H4><A NAME="Fl_Text_Display.textcolor">void textcolor(unsigned n);<BR>
 Fl_Color textcolor() const;</A></H4>
 
+<P>Sets or gets the default color of text in the widget.
 
 <H4><A NAME="Fl_Text_Display.textfont">void textfont(uchar s);<BR>
 Fl_Font textfont() const;</A></H4>
 
+<P>Sets or gets the default font used when drawing text in the widget.
 
 <H4><A NAME="Fl_Text_Display.textsize">void textsize(uchar s);<BR>
 uchar textsize() const;</A></H4>
 
+<P>Sets or gets the default size of text in the widget.
 
 <H4><A NAME="Fl_Text_Display.word_end">int word_end(int pos);</A></H4>
 
+<P>Moves the insert position to the end of the current word.
 
 <H4><A NAME="Fl_Text_Display.word_start">int word_start(int pos);</A></H4>
 
+<P>Moves the insert position to the beginning of the current word.
 
 </BODY>
 </HTML>