Bug 1314524. Part 7 - fix comments about dormant. r=kaku

MozReview-Commit-ID: 5qFuMRMLqEr

--HG--
extra : rebase_source : 1a387cda06c78b9bc952c4548c0e008c67b0cc2c
extra : intermediate-source : a2d08118ac9ab3f01d0f4cf5604197c17687537c
extra : source : 03f79104b7b0e5848636f47129c7b5249dc46382

dom/media/MediaDecoderStateMachine.cpp

@@ -276,7 +276,6 @@ protected:
  * Transition to other states when decoding metadata is done:
  *   SHUTDOWN if failing to decode metadata.
  *   WAIT_FOR_CDM if the media is encrypted and CDM is not available.
- *   DORMANT if any pending dormant request.
  *   DECODING_FIRSTFRAME otherwise.
  */
 class MediaDecoderStateMachine::DecodeMetadataState
@@ -350,7 +349,6 @@ private:
  * Purpose: wait for the CDM to start decoding.
  *
  * Transition to other states when CDM is ready:
- *   DORMANT if any pending dormant request.
  *   DECODING_FIRSTFRAME otherwise.
  */
 class MediaDecoderStateMachine::WaitForCDMState
@@ -458,7 +456,6 @@ private:
  * Purpose: decode the 1st audio and video frames to fire the 'loadeddata' event.
  *
  * Transition to:
- *   DORMANT if any dormant request.
  *   SHUTDOWN if any decode error.
  *   SEEKING if any pending seek and seek is possible.
  *   DECODING when the 'loadeddata' event is fired.
@@ -473,7 +470,7 @@ public:
 
   void Exit() override
   {
-    // mPendingSeek is either moved before transition to SEEKING or DORMANT,
+    // mPendingSeek is either moved before transition to SEEKING,
     // or should be rejected here before transition to SHUTDOWN.
     mPendingSeek.RejectIfExists(__func__);
   }
@@ -528,7 +525,7 @@ private:
  * Purpose: decode audio/video data for playback.
  *
  * Transition to:
- *   DORMANT if any dormant request.
+ *   DORMANT if playback is paused for a while.
  *   SEEKING if any seek request.
  *   SHUTDOWN if any decode error.
  *   BUFFERING if playback can't continue due to lack of decoded data.
@@ -761,7 +758,6 @@ private:
  * Purpose: seek to a particular new playback position.
  *
  * Transition to:
- *   DORMANT if any dormant request.
  *   SEEKING if any new seek request.
  *   SHUTDOWN if seek failed.
  *   COMPLETED if the new playback position is the end of the media resource.
@@ -937,7 +933,6 @@ private:
  * Purpose: stop playback until enough data is decoded to continue playback.
  *
  * Transition to:
- *   DORMANT if any dormant request.
  *   SEEKING if any seek request.
  *   SHUTDOWN if any decode error.
  *   COMPLETED when having decoded all audio/video data.
@@ -1015,7 +1010,6 @@ private:
  * Purpose: play all the decoded data and fire the 'ended' event.
  *
  * Transition to:
- *   DORMANT if any dormant request.
  *   SEEKING if any seek request.
  */
 class MediaDecoderStateMachine::CompletedState