Doxygen documentation: fixed all ambiguous methods signatures, fixed erroneous path test into ../test since the doxyfile move, fixed all intro dl,dt,dd related tags warnings in intro.dox .

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

7 files changed, 33 insertions, 40 deletions

diff --git a/FL/Fl_Browser.H b/FL/Fl_Browser.H
index a31149c03..0955d87bf 100644
--- a/FL/Fl_Browser.H
+++ b/FL/Fl_Browser.H
@@ -158,8 +158,8 @@ public:
     <UL>
     <LI><tt>'\@.'</tt> Print rest of line, don't look for more '\@' signs </LI>
     <LI><tt>'\@\@'</tt> Print rest of line starting with '\@' </LI>
-    <LI><tt>'\@l'</tt> Use a <BIG>large</BIG> (24 point) font </LI>
-    <LI><tt>'\@m'</tt> Use a <BIG>medium large</BIG> (18 point) font </LI>
+    <LI><tt>'\@l'</tt> Use a LARGE (24 point) font </LI>
+    <LI><tt>'\@m'</tt> Use a medium large (18 point) font </LI>
     <LI><tt>'\@s'</tt> Use a <SMALL>small</SMALL> (11 point) font </LI>
     <LI><tt>'\@b'</tt> Use a <B>bold</B> font (adds FL_BOLD to font) </LI>
     <LI><tt>'\@i'</tt> Use an <I>italic</I> font (adds FL_ITALIC to font) </LI>
diff --git a/FL/Fl_Output.H b/FL/Fl_Output.H
index b9ea12032..8e8bfeebd 100644
--- a/FL/Fl_Output.H
+++ b/FL/Fl_Output.H
@@ -38,7 +38,7 @@
   which is useful for program-generated values.  The user may select
   portions of the text using the mouse and paste the contents into other
   fields or programs.
-  <CENTER>\image html text.gif</CENTER>
+  <P align=CENTER>\image html text.gif</P>
   <P>There is a single subclass, 
   Fl_Multiline_Output, which allows you to display multiple lines of
   text. </P>
diff --git a/FL/Fl_Preferences.H b/FL/Fl_Preferences.H
index 6ed132f95..7ff43e9f5 100644
--- a/FL/Fl_Preferences.H
+++ b/FL/Fl_Preferences.H
@@ -151,10 +151,10 @@ public:
      order  of group names. The index must be within the range given
      by groups().
      
-     \param[in] index number indexing the requested group
+     \param[in] num_group number indexing the requested group
      \return cstring pointer to the group name
    */
-  const char *group( int index );
+  const char *group( int num_group );
   
   /**
      Returns non-zero if a group with this name exists.
@@ -162,10 +162,10 @@ public:
      "." describes the current node, "./" describes the topmost node.
      By preceding a groupname with a "./", its path becomes relative to the topmost node.
      
-     \param[in] group name of group that is searched for
+     \param[in] key name of group that is searched for
      \return 0 if group was not found
    */
-  char groupExists( const char *group );
+  char groupExists( const char *key );
 
   /**
      Deletes a group.
@@ -196,10 +196,10 @@ public:
   /**
      Returns non-zero if an entry with this name exists.
      
-     \param[in] entry name of entry that is searched for
+     \param[in] key name of entry that is searched for
      \return 0 if entry was not found
    */
-  char entryExists( const char *entry );
+  char entryExists( const char *key );
   
   /**
      Removes a single entry (name/value pair).
diff --git a/FL/Fl_Return_Button.H b/FL/Fl_Return_Button.H
index 06947ee58..c7e9813d9 100644
--- a/FL/Fl_Return_Button.H
+++ b/FL/Fl_Return_Button.H
@@ -45,8 +45,8 @@ public:
   int handle(int);
   /**
     Creates a new Fl_Return_Button widget using the given
-    position, size, and label string. The default boxtype is FL_UP_BOX
-    .
+    position, size, and label string. The default boxtype is FL_UP_BOX.
+    <P> The inherited destructor deletes the button.
   */
   Fl_Return_Button(int X, int Y, int W, int H,const char *l=0)
     : Fl_Button(X,Y,W,H,l) {}
diff --git a/FL/Fl_Spinner.H b/FL/Fl_Spinner.H
index 73e549f13..f91eadbf5 100644
--- a/FL/Fl_Spinner.H
+++ b/FL/Fl_Spinner.H
@@ -176,15 +176,15 @@ class Fl_Spinner : public Fl_Group
 
   /** Speling mistakes retained for source compatibility \deprecated */
   double	maxinum() const { return (maximum_); }
-  /** Sets or returns the maximum value of the widget. */
+  /** Gets the maximum value of the widget. */
   double	maximum() const { return (maximum_); }
-  /** Sets or returns the maximum value of the widget. */
+  /** Sets the maximum value of the widget. */
   void		maximum(double m) { maximum_ = m; }
   /** Speling mistakes retained for source compatibility \deprecated */
   double	mininum() const { return (minimum_); }
-  /** Sets or returns the minimum value of the widget. */
+  /** Gets the minimum value of the widget. */
   double	minimum() const { return (minimum_); }
-  /** Sets or returns the minimum value of the widget. */
+  /** Sets the minimum value of the widget. */
   void		minimum(double m) { minimum_ = m; }
   /** Sets the minimum and maximum values for the widget. */
   void		range(double a, double b) { minimum_ = a; maximum_ = b; }
@@ -209,31 +209,31 @@ class Fl_Spinner : public Fl_Group
 		  else input_.type(FL_INT_INPUT);
 		  update();
 		}
-  /** Sets or Gets the color of the text in the input field. */
+  /** Gets the color of the text in the input field. */
   Fl_Color	textcolor() const {
 		  return (input_.textcolor());
 		}
-  /** Sets or Gets the color of the text in the input field. */
+  /** Sets the color of the text in the input field. */
   void		textcolor(Fl_Color c) {
 		  input_.textcolor(c);
 		}
-  /** Sets or Gets the font of the text in the input field. */
+  /** Gets the font of the text in the input field. */
   Fl_Font       textfont() const {
 		  return (input_.textfont());
 		}
-  /** Sets or Gets the font of the text in the input field. */
+  /** Sets the font of the text in the input field. */
   void		textfont(Fl_Font f) {
 		  input_.textfont(f);
 		}
-  /** Sets or Gets the size of the text in the input field. */
+  /** Gets the size of the text in the input field. */
   Fl_Fontsize  textsize() const {
 		  return (input_.textsize());
 		}
-  /** Sets or Gets the size of the text in the input field. */
+  /** Sets the size of the text in the input field. */
   void		textsize(Fl_Fontsize s) {
 		  input_.textsize(s);
 		}
-  /** Sets or returns the numeric representation in the input field.
+  /** Sets or Gets the numeric representation in the input field.
     Valid values are FL_INT_INPUT and FL_FLOAT_INPUT.
     The first form also changes the format() template.
     Setting a new spinner type via a superclass pointer will not work.
@@ -249,13 +249,13 @@ class Fl_Spinner : public Fl_Group
                   }
                   input_.type(v); 
                 }
+  /** Gets the current value of the widget. */
+  double	value() const { return (value_); }
   /**
-    Sets or returns the current value of the widget.
+    Sets the current value of the widget.
     Before setting value to a non-integer value, the spinner 
     type() should be changed to floating point. 
   */
-  double	value() const { return (value_); }
-  /** See double Fl_Spinner::value() const */
   void		value(double v) { value_ = v; update(); }
 };
 
diff --git a/FL/Fl_Valuator.H b/FL/Fl_Valuator.H
index a90e60223..eb2d8a814 100644
--- a/FL/Fl_Valuator.H
+++ b/FL/Fl_Valuator.H
@@ -43,14 +43,13 @@
   The Fl_Valuator class controls a single floating-point value
   and provides a consistent interface to set the value, range, and step,
   and insures that callbacks are done the same for every object.
-  <P>There are probably more of these classes in FLTK than any others: </P>
+  <P>There are probably more of these classes in FLTK than any others:
   <P ALIGN=CENTER>\image html  valuators.gif</P>
   <P>In the above diagram each box surrounds an actual subclass.  These
-  are further differentiated by setting the 
-  type() of the widget to the symbolic value labeling the
-  widget.  The ones labelled "0" are the default versions with a 
-  type(0).  For consistency the symbol FL_VERTICAL is
-  defined as zero.
+  are further differentiated by setting the type() of the widget t
+  o the symbolic value labeling the widget.  
+  The ones labelled "0" are the default versions with a type(0).  
+  For consistency the symbol FL_VERTICAL is defined as zero.
 */
 class FL_EXPORT Fl_Valuator : public Fl_Widget {
 
@@ -124,13 +123,7 @@ public:
   double step() const {return A/B;}
   void precision(int);
 
-  /**
-    Gets or sets the current value. The new value is <I>not</I>
-    clamped or otherwise changed before storing it. Use
-    clamp() or round() to modify the value before
-    calling value(). The widget is redrawn if the new value
-    is different than the current one. The initial value is zero.
-  */
+  /** Gets the floating point(double) value. See int value(double) */
   double value() const {return value_;}
   int value(double);
 
diff --git a/FL/Fl_Widget.H b/FL/Fl_Widget.H
index 67741b228..fbdd61524 100644
--- a/FL/Fl_Widget.H
+++ b/FL/Fl_Widget.H
@@ -249,9 +249,9 @@ public:
   int damage_resize(int,int,int,int);
 
   /** Reposition the window or widget.
-   *  position(x,y) is a shortcut for resize(x,y,w(),h()).
+   *  position(X,Y) is a shortcut for resize(X,Y,w(),h()).
    *
-   *  \param[in] x, y new position relative to the parent window 
+   *  \param[in] X, Y new position relative to the parent window 
    *  \see resize(int, int, int, int), size(int, int)
    */
   void position(int X,int Y) {resize(X,Y,w_,h_);}