         startValue:Object, endValue:Object):Object;   
 
     /**
-     * Given a base value and a value to add to it, this function
-     * returns the result of that increment operation. For example,
-     * if the objects are simple Numbers, the result would be
-     * <code>Number(baseValue) + Number(incrementValue)</code>.
-     * This function is called by the animation system when it
-     * needs to dynamically calculate a value given some starting
-     * value and a 'by' value that should be added to it, both of
-     * which are of type Object and cannot simply be added together.
+     *  Given a base value and a value to add to it, 
+     *  return the result of that operation. 
+     *  For example, if the objects are simple Numbers, the result is a 
+     *  <code>Number(baseValue) + Number(incrementValue)</code>.
+     *  This method is called by the animation system when it
+     *  needs to dynamically calculate a value given some starting
+     *  value and a 'by' value that should be added to it. Both of
+     *  the arguments are of type Object and cannot simply be added together.
+     *
+     *  @param baseValue The start value of the interpolation.
+     *
+     *  @param incrementValue The change to apply to the <code>baseValue</code>.
+     *
+     *  @return The interpolated value.
      *  
      *  @langversion 3.0
      *  @playerversion Flash 10

public interface IInterpolator
{
    /**
     * Returns the type that an implementor can handle
     *  
     *  @langversion 3.0
     *  @playerversion Flash 10

    function get interpolatedType():Class;
    
    /**
     *  Given an elapsed fraction of an animation, between 0.0 and 1.0,
     *  and start and end values to interpolate, return the interpolated value.
     *
     *  @param fraction The fraction elapsed of the 
     *  animation, between 0.0 and 1.0.
     *
     *  @param startValue The start value of the interpolation.
     *
     *  @param endValue The end value of the interpolation.
     *
     *  @return The interpolated value.
     *  
     *  @langversion 3.0
     *  @playerversion Flash 10
