From 7694e5601ac6a8bce73c1499bc3e3505db1c25d8 Mon Sep 17 00:00:00 2001
From: Greg Ercolano <erco@seriss.com>
Date: Sat, 19 Sep 2009 22:09:00 +0000
Subject: Updated docs for Fl_Multiline_XXX to reference 'new' Fl_Text_XXXX
 widgets which have scrollbars and per-character color controls.

This solves part of STR #2226 (item submitted 02:26 Jul 24, 2009).



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6889 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
---
 FL/Fl_Multiline_Input.H  | 14 +++++++++-----
 FL/Fl_Multiline_Output.H |  8 ++++++++
 2 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/FL/Fl_Multiline_Input.H b/FL/Fl_Multiline_Input.H
index 656513e3e..609f8cc31 100644
--- a/FL/Fl_Multiline_Input.H
+++ b/FL/Fl_Multiline_Input.H
@@ -38,11 +38,15 @@
   This input field displays '\n' characters as new lines rather than ^J,
   and accepts the Return, Tab, and up and down arrow keys.  This is for
   editing multiline text.
-  <P>This is far from the nirvana of text editors, and is probably only
-  good for small bits of text, 10 lines at most.  I think FLTK can be
-  used to write a powerful text editor, but it is not going to be a
-  built-in feature.  Powerful text editors in a toolkit are a big source
-  of bloat.
+  <P>
+  This is far from the nirvana of text editors, and is probably only
+  good for small bits of text, 10 lines at most. Note that this widget
+  does not support scrollbars or per-character color control.
+  <P>
+  If you are presenting large amounts of text and need scrollbars
+  or full color control of characters, you probably want Fl_Text_Editor
+  instead.
+  <P>
 */
 class Fl_Multiline_Input : public Fl_Input {
 public:
diff --git a/FL/Fl_Multiline_Output.H b/FL/Fl_Multiline_Output.H
index 4d58edb6f..04f89b6d5 100644
--- a/FL/Fl_Multiline_Output.H
+++ b/FL/Fl_Multiline_Output.H
@@ -37,6 +37,14 @@
   This widget is a subclass of Fl_Output that displays multiple
   lines of text. It also displays tab characters as whitespace to the
   next column.
+  <P>
+  Note that this widget does not support scrollbars, or per-character
+  color control.
+  <P>
+  If you are presenting large amounts of read-only text 
+  and need scrollbars, or full color control of characters,
+  then use Fl_Text_Display. If you want to display HTML text,
+  use Fl_Help_View.
 */
 class Fl_Multiline_Output : public Fl_Output {
 public:
-- 
cgit v1.2.3