diff --git a/src/as/com/threerings/flash/video/VideoPlayer.as b/src/as/com/threerings/flash/video/VideoPlayer.as
index 1c0b59ce..5c2e169e 100644
--- a/src/as/com/threerings/flash/video/VideoPlayer.as
+++ b/src/as/com/threerings/flash/video/VideoPlayer.as
@@ -12,30 +12,41 @@ import flash.geom.Point;
 import com.threerings.util.ValueEvent;
 
 /**
+ * Dispatched when the state of the videoplayer changes, usually in response to commands
+ * such as play/pause, etc.
+ * <b>value</b>: an int state. @see VideoPlayerCodes
  *
  * @eventType com.threerings.flash.video.VideoPlayerCodes.STATE
  */
 [Event(name="state", type="com.threerings.util.ValueEvent")]
 
 /**
+ * Dispatched when the total duration of the video is known.
+ * <b>value</b>: a Number expressing the duration in seconds.
  *
  * @eventType com.threerings.flash.video.VideoPlayerCodes.DURATION
  */
 [Event(name="duration", type="com.threerings.util.ValueEvent")]
 
 /**
+ * Dispatched periodically as the position is updated, during playback.
+ * <b>value</b>: a Number expressing the position in seconds.
  *
  * @eventType com.threerings.flash.video.VideoPlayerCodes.POSITION
  */
 [Event(name="position", type="com.threerings.util.ValueEvent")]
 
 /**
+ * Disptached when the size of the video is known.
+ * <b>value</b>: a Point expressing the width/height.
  *
  * @eventType com.threerings.flash.video.VideoPlayerCodes.SIZE
  */
 [Event(name="size", type="com.threerings.util.ValueEvent")]
 
 /**
+ * Dispatched when there's a problem.
+ * <b>value</b>: a String error code/message.
  *
  * @eventType com.threerings.flash.video.VideoPlayerCodes.ERROR
  */
@@ -61,17 +72,23 @@ public interface VideoPlayer extends IEventDispatcher
      */
     function getSize () :Point;
 
+    /**
+     * Play the video, if not already.
+     */
     function play () :void;
 
+    /**
+     * Pause the video, if not already.
+     */
     function pause () :void;
 
     /**
-     * Get the duration of the video, or NaN if not yet known.
+     * Get the duration of the video, in seconds, or NaN if not yet known.
      */
     function getDuration () :Number;
 
     /**
-     * Get the position of the video, or NaN if not yet ready.
+     * Get the position of the video, in seconds, or NaN if not yet ready.
      */
     function getPosition () :Number;