     
     
 /**
- * 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 starting value for the property during the animation.
     * 
     * <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

    }

    /**
     *  Optional property which specifies the delta used to calculate
     *  either the <code>valueFrom</code> or <code>valueTo</code> value.
     *  Providing this optional property lets the effect 
     *  calculate the necessary from/to values if either
     *  are not provided or are to be determined dynamically when the animation 
     *  begins.
     * 
     *  <p>The way that the <code>valueBy</code> value is used depends on which of the
     *  other values are set. If neither are set, then the <code>valueFrom</code> 
     *  value is determined from the current property value in the target, 
     *  and the <code>valueTo</code> value is <code>valueFrom + valueBy</code>. 
     *  If one or the other is set, but not both, then
     *  the unset value is calculated by the other value: 
     *  <code>valueTo = valueFrom + valueBy</code> or  
     *  <code>valueFrom = valueTo - valueBy</code>). If both are set, then the
     *  <code>valueBy</code> property is ignored.</p>
     * 
     *  <p>Note that since <code>valueBy</code> is of type
     *  Object, the effect cannot directly calculate the other values
     *  from it. It uses the effect's interpolator
     *  to calculate the values by calling the interpolator's <code>increment()</code> 
     *  and <code>decrement()</code> methods.
     *  If no interpolator is set, then it will use NumberInterpolator by default.</p>
     *  
     *  @langversion 3.0
     *  @playerversion Flash 10
