diff --git a/MobilePlayer/MobilePlayerViewController.swift b/MobilePlayer/MobilePlayerViewController.swift
index 9121c6c..d9c2bf7 100644
--- a/MobilePlayer/MobilePlayerViewController.swift
+++ b/MobilePlayer/MobilePlayerViewController.swift
@@ -286,11 +286,16 @@ public class MobilePlayerViewController: MPMoviePlayerViewController {
   }
 
   /// Initiates playback of current content.
+  ///
+  /// Starting playback causes dismiss to be called on prerollViewController, pauseOverlayViewController
+  /// and postrollViewController.
   public func play() {
     moviePlayer.play()
   }
 
   /// Pauses playback of current content.
+  ///
+  /// Pausing playback causes pauseOverlayViewController to be shown.
   public func pause() {
     moviePlayer.pause()
   }