         _easer = value;
     }
     
-    // TODO: rethink reversal
     /**
      *  If <code>true</code>, play the animation in reverse.
+     *  If the animation is currently playing in the opposite
+     *  direction to the specified value of <code>playReversed</code>,
+     *  the animation will change direction dynamically.
      *
      *  @default false
      *

        {
            Animation.removeAnimationAt(id);
            id = -1;
            _doReverse = false
            _invertValues = false;
            _isPlaying = false;
        }

        this.duration = duration;
        if (property != null && (startValue !== null || endValue !== null))
        {
            motionPaths = new <MotionPath>[new MotionPath(property)];
            motionPaths[0].keyframes = new <Keyframe>[new Keyframe(0, startValue), 
                new Keyframe(duration, endValue)];
        }
    }
    
