 import spark.effects.supportClasses.AnimateTransformInstance;
     
 /**
- * This class is a utility wrapper around the AnimateTransform effect, exposing the
- * properties that make sense for someone wishing to merely scale a target object
- * in the x and y directions around some transform center.
+ *  The AnimateTransformScale effect scales a target object
+ *  in the x and y directions around the transform center.
+ *  A scale of 2.0 means the object has been magnified by a factor of 2, 
+ *  and a scale of 0.5 means the object has been reduced by a factor of 2.
  * 
- * <p>Like all AnimateTransform-based effects, this effect will only work on subclasses
- * of UIComponent and GraphicElement, as these effects depend on specific
- * transform functions in those classes. Also, all of these effects run one single
- * effect instance on any given target at a time, which means that they will
- * share the transform center set by any of the contributing effects.</p>
+ *  <p>Like all AnimateTransform-based effects, this effect will only work on subclasses
+ *  of UIComponent and GraphicElement, as these effects depend on specific
+ *  transform functions in those classes. </p>
+ *  
+ *  @mxml
+ *
+ *  <p>The <code>&lt;mx:AnimateTransformScale&gt;</code> tag
+ *  inherits all of the tag attributes of its of its superclass,
+ *  and adds the following tag attributes:</p>
+ *  
+ *  <pre>
+ *  &lt;mx:AnimateTransformScale
+ *    id="ID"
+ *    scaleXBy="val"
+ *    scaleXFrom="val"
+ *    scaleXTo="val"
+ *    scaleYBy="val"
+ *    scaleYFrom="val"
+ *    scaleYTo="val"
+ *   /&gt;
+ *  </pre>
+ *
+ *  @langversion 3.0
+ *  @playerversion Flash 10
+ *  @playerversion AIR 1.5
+ *  @productversion Flex 4
  */   
 public class AnimateTransformScale extends AnimateTransform
 {
     include "../core/Version.as";
     
+    /**
+     *  Constructor.
+     *
+     *  @param target The Object to animate with this effect.
+     *
+     *  @langversion 3.0
+     *  @playerversion Flash 10
+     *  @playerversion AIR 1.5
+     *  @productversion Flex 4
+     */
     public function AnimateTransformScale(target:Object=null)
     {
         super(target);

     * of the other from/to values to specify the delta to add to the
     * from value or to derive the from value by subtracting from the
     * to value.
     */
    public var scaleXBy:Number;



    /**
     * The ending scale factor in the y direction.
     *
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 1.5
     *  @productversion Flex 4
     */
    public var scaleYTo:Number;
            
