Reorganization of the Doxygen docs of some Fl_Image class functions.

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

FL/Fl_Image.H

@@ -3,7 +3,7 @@
 //
 // Image header file for the Fast Light Tool Kit (FLTK).
 //
-// Copyright 1998-2010 by Bill Spitzak and others.
+// Copyright 1998-2011 by Bill Spitzak and others.
 //
 // This library is free software; you can redistribute it and/or
 // modify it under the terms of the GNU Library General Public
@@ -59,33 +59,24 @@ class FL_EXPORT Fl_Image {
   protected:
 
   /**
-    The first form of the w() method returns the current
-    image width in pixels.</P>
-    
-    <P>The second form is a protected method that sets the current
-    image width.
+    Sets the current image width in pixels.
   */
   void w(int W) {w_ = W;}
   /**
-    The first form of the h() method returns the current
-    image height in pixels.</P>
-    
-    <P>The second form is a protected method that sets the current
-    image height.
+    Sets the current image height in pixels.
   */
   void h(int H) {h_ = H;}
   /**
-    The first form of the d() method returns the current
-    image depth. The return value will be 0 for bitmaps, 1 for
-    pixmaps, and 1 to 4 for color images.</P>
-    
-    <P>The second form is a protected method that sets the current
-    image depth.
+    Sets the current image depth.
   */
   void d(int D) {d_ = D;}
-  /**    See int ld()  */
+  /**
+   Sets the current line data size in bytes.
+   */
   void ld(int LD) {ld_ = LD;}
-  /**    See const char * const *data()  */
+  /** 
+   Sets the current array pointer and count of pointers in the array.
+   */
   void data(const char * const *p, int c) {data_ = p; count_ = c;}
   void draw_empty(int X, int Y);
 
@@ -94,26 +85,23 @@ class FL_EXPORT Fl_Image {
 
   public:
 
-  /** See void Fl_Image::w(int) */
+  /** 
+   Returns the current image width in pixels.
+  */
   int w() const {return w_;}
-  /** See void Fl_Image::h(int) */
+  /**     Returns the current image height in pixels.
+   */
   int h() const {return h_;}
   /**
-    The first form of the d() method returns the current
-    image depth. The return value will be 0 for bitmaps, 1 for
+    Returns the current image depth. 
+   The return value will be 0 for bitmaps, 1 for
     pixmaps, and 1 to 4 for color images.</P>
-    
-    <P>The second form is a protected method that sets the current
-    image depth.
   */
   int d() const {return d_;}
   /**
-    The first form of the ld() method returns the current
-    line data size in bytes. Line data is extra data that is included
-    after each line of color image data and is normally not present.</P>
-    
-    <P>The second form is a protected method that sets the current
-    line data size in bytes.
+    Returns the current line data size in bytes. 
+    Line data is extra data that is included
+    after each line of color image data and is normally not present.
   */
   int ld() const {return ld_;}
   /**
@@ -124,12 +112,8 @@ class FL_EXPORT Fl_Image {
   */
   int count() const {return count_;}
   /**
-    The first form of the data() method returns a
-    pointer to the current image data array. Use the
-    count() method to find the size of the data array.</P>
-    
-    <P>The second form is a protected method that sets the current
-    array pointer and count of pointers in the array.
+    Returns a pointer to the current image data array. 
+    Use the count() method to find the size of the data array.
   */
   const char * const *data() const {return data_;}
   
@@ -162,15 +146,16 @@ class FL_EXPORT Fl_Image {
   virtual void label(Fl_Widget*w);
   virtual void label(Fl_Menu_Item*m);
   /**
-    The draw() methods draw the image. This form specifies
+    Draws the image with a bounding box. 
+    This form specifies
     a bounding box for the image, with the origin
     (upper-lefthand corner) of the image offset by the cx
     and cy arguments.
   */
   virtual void draw(int X, int Y, int W, int H, int cx=0, int cy=0); // platform dependent
   /**
-    The draw() methods draw the image. This form
-    specifies the upper-lefthand corner of the image
+    Draws the image. 
+    This form specifies the upper-lefthand corner of the image.
   */
   void draw(int X, int Y) {draw(X, Y, w(), h(), 0, 0);} // platform dependent
   virtual void uncache();