 {
 import mx.core.mx_internal;
 
+/**
+ *  The GradientStroke class lets you specify a gradient filled stroke.
+ *  You use the GradientStroke class, along with the GradientEntry class,
+ *  to define a gradient stroke.
+ *  
+ *  @see mx.graphics.Stroke
+ *  @see mx.graphics.GradientEntry
+ *  @see flash.display.Graphics
+ */
 public class GradientStroke extends GradientBase
 {
-	public function GradientStroke(weight:Number = 0,
+    /**
+     *  Constructor.
+     *
+     *  @param weight Specifies the line weight, in pixels.
+     *  This parameter is optional,
+     *  with a default value of <code>0</code>. 
+     *
+     *  @param pixelHinting A Boolean value that specifies
+     *  whether to hint strokes to full pixels.
+     *  This affects both the position of anchors of a curve
+     *  and the line stroke size itself.
+     *  With <code>pixelHinting</code> set to <code>true</code>,
+     *  Flash Player and AIR hint line widths to full pixel widths.
+     *  With <code>pixelHinting</code> set to <code>false</code>,
+     *  disjoints can  appear for curves and straight lines. 
+     *  This parameter is optional,
+     *  with a default value of <code>false</code>. 
+     *
+     *  @param scaleMode A value from the LineScaleMode class
+     *  that specifies which scale mode to use.
+     *  Valid values are <code>LineScaleMode.HORIZONTAL</code>,
+     *  <code>LineScaleMode.NONE</code>, <code>LineScaleMode.NORMAL</code>,
+     *  and <code>LineScaleMode.VERTICAL</code>.
+     *  This parameter is optional,
+     *  with a default value of <code>LineScaleMode.NONE</code>. 
+     *
+     *  @param caps A value from the CapsStyle class
+     *  that specifies the type of caps at the end of lines.
+     *  Valid values are <code>CapsStyle.NONE</code>,
+     *  <code>CapsStyle.ROUND</code>, and <code>CapsStyle.SQUARE</code>.
+     *  A <code>null</code> value is equivalent to
+     *  <code>CapsStyle.ROUND</code>.
+     *  This parameter is optional,
+     *  with a default value of <code>null</code>. 
+     *
+     *  @param joints A value from the JointStyle class
+     *  that specifies the type of joint appearance used at angles.
+     *  Valid values are <code>JointStyle.BEVEL</code>,
+     *  <code>JointStyle.MITER</code>, and <code>JointStyle.ROUND</code>.
+     *  A <code>null</code> value is equivalent to
+     *  <code>JoinStyle.ROUND</code>.
+     *  This parameter is optional,
+     *  with a default value of <code>null</code>. 
+     *
+     *  @param miterLimit A number that indicates the limit
+     *  at which a miter is cut off. 
+     *  Valid values range from 1 to 255
+     *  (and values outside of that range are rounded to 1 or 255). 
+     *  This value is only used if the <code>jointStyle</code> property 
+     *  is set to <code>miter</code>.
+     *  The <code>miterLimit</code> value represents the length that a miter
+     *  can extend beyond the point at which the lines meet to form a joint.
+     *  The value expresses a factor of the line <code>thickness</code>.
+     *  For example, with a <code>miterLimit</code> factor of 2.5 and a 
+     *  <code>thickness</code> of 10 pixels, the miter is cut off at 25 pixels. 
+     *  This parameter is optional,
+     *  with a default value of <code>0</code>.
+     */
+    public function GradientStroke(weight:Number = 0,
                                      pixelHinting:Boolean = false,
                                      scaleMode:String = "normal",
                                      caps:String = null,

        this.joints = joints;
        this.miterLimit = miterLimit;
    }
	
	//----------------------------------
    //  caps
    //----------------------------------


                                "caps", oldValue, value);
        }
    }
        
    //----------------------------------
    //  joints
    //----------------------------------

