     //  playheadTime
     //----------------------------------
     
-    /**
-     *  @copy mx.effects.IEffectInstance#playheadTime
+    // TODO (chaase): This property should be in an interface, to
+    // allow it to be called easily through an interface instead of
+    // having to import Effect just to call it
+    // TODO (chaase): Consider renaming this property; playheadTime
+    // is very video-specific
+    /**
+     *  The current position of the effect, in milliseconds. 
+     *  This value is between 0 and the value of the
+     *  <code>duration</code> property.
+     *  Use the <code>seek()</code> method to change the position of the effect.
      */
     public function get playheadTime():Number 
     {

        if (delayTimer)
            delayTimer.reset();
        stopRepeat = true;
        finishEffect();
    }
    

        if (repeatCount > 0)
        {
            value = duration * repeatCount +
                    (repeatDelay * (repeatCount - 1)) + startDelay;
        }
        
        return value;
