updated Fl_Scrollbar::value() description (STR #2156 - part 1)

further rework needed on Fl_Slider::scrollvalue() description



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

1 files changed, 8 insertions, 5 deletions

diff --git a/src/Fl_Slider.cxx b/src/Fl_Slider.cxx
index a74362d03..b3969ceb8 100644
--- a/src/Fl_Slider.cxx
+++ b/src/Fl_Slider.cxx
@@ -79,12 +79,15 @@ void Fl_Slider::bounds(double a, double b) {
   }
 }
 
-/**  Returns   Fl_Scrollbar::value(). */
+/**
+  Sets the size and position of the sliding knob in the box.
+  \param[in] p position, first line displayed
+  \param[in] W window, number of lines displayed
+  \param[in] t top, number of first line
+  \param[in] l length, total number of lines
+  Returns Fl_Valuator::value(p)
+ */
 int Fl_Slider::scrollvalue(int p, int W, int t, int l) {
-//	p = position, first line displayed
-//	w = window, number of lines displayed
-//	t = top, number of first line
-//	l = length, total number of lines
   step(1, 1);
   if (p+W > t+l) l = p+W-t;
   slider_size(W >= l ? 1.0 : double(W)/double(l));