     
     
 /**
- * This class is used to hold the name of a property and the values that
- * that property will assume over time for instances of the Animate
- * effect, or subclasses of that effect. This class is a simple utility
- * subclass of MotionPath, setting up two keyframes to hold the 
- * <code>valueFrom</code>, <code>valueTo</code>, and
- * <code>valueBy</code> properties.
+ *  The SimpleMotionPath class specifies the name of a property, and the values that
+ *  that property takes over time, for instances of the Animate
+ *  effect. 
+ * 
+ *  <p>This class is a simple subclass of MotionPath for defining 
+ *  two keyframes to hold the <code>valueFrom</code>, <code>valueTo</code>, and
+ *  <code>valueBy</code> properties. 
+ *  The MotionPath class itself can define any number of keyframes.</p>
+ *
+ *  @see MotionPath
  *  
  *  @langversion 3.0
  *  @playerversion Flash 10

    }

    /**
     * The value that the named property will animate to.
     * 
     * <p>Null or NaN (in the case of Numbers) element values indicate that a
     * value must be determined dynamically at runtime, either by
     * getting the value from the target property directly or calculating
     * it if the other value is valid and there is also a valid <code>valueBy</code>
     * value supplied.</p>
     *  
     *  @langversion 3.0
     *  @playerversion Flash 10

    //--------------------------------------------------------------------------

    /**
     *  Constructor. You can specify both the <code>valueFrom</code> and <code>valueTo</code> parameters, 
     *  or specify the <code>valueBy</code> parameter and either the <code>valueFrom</code> 
     *  or <code>valueTo</code> parameter. 
     *  If you omit these parameters, Flex calculates them from the effect target.
     * 
     *  @param property The name of the property being animated.
     *
     *  @param valueFrom The initial value of the property.
     *  
     *  @param valueTo The final value of the property.
     *  
     *  @param duration The time, in milliseconds, of the animation.
     *  
     *  @param valueBy An optional parameter that specifies the delta with
     *  which to calculate either the from or to values, if one is omitted. 
     */    
    public function SimpleMotionPath(property:String = null, 
        valueFrom:Object = null, valueTo:Object = null, 
