      *  is past the end of the stream, or past the amount of file
      *  downloaded so far, then will attempt seek and when fails
      *  will recover.</p>
+     * 
+     *  <p>The <code>playheadTime</code> property might not have the expected value 
+     *  immediately after you call one of the seek methods or set  
+     *  <code>playheadTime</code> to cause seeking. For a progressive download,
+     *  you can seek only to a keyframe; therefore, a seek takes you to the 
+     *  time of the first keyframe after the specified time.</p>
+     *  
+     *  <p><strong>Note</strong>: When streaming, a seek always goes to the precise specified 
+     *  time even if the source FLV file doesn't have a keyframe there.</p>
+     *
+     *  <p>Seeking is asynchronous, so if you call a seek method or set the 
+     *  <code>playheadTime</code> property, <code>playheadTime</code> does not update immediately. 
+     *  To obtain the time after the seek is complete, listen for the <code>seek</code> event, 
+     *  which does not start until the <code>playheadTime</code> property is updated.</p>
      *
      *  @param time seconds
      *  

                sourceLastPlayed = sourceString;
            }
            
            wasPaused = false;
            
            // TODO (rfrishbe): how we handle startTime is pretty hacky.
            // Need to figure out if there's a better way or talk to Strobe 

    
    [Inspectable(category="General")]
    
    private var _playing:Boolean = false;
    
    [Bindable("playingChanged")]
    /**
     *  Returns true if the video is playing or is attempting to play.
     *  
