From fd6874809a7d5383636cbe5e6d5b360118e4f972 Mon Sep 17 00:00:00 2001
From: olly <olly@google.com>
Date: Thu, 13 Dec 2018 16:17:14 +0000
Subject: [PATCH] Clarify that the shutter can prevent flicker

PiperOrigin-RevId: 225374071
---
 .../java/com/google/android/exoplayer2/ui/PlayerView.java    | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/library/ui/src/main/java/com/google/android/exoplayer2/ui/PlayerView.java b/library/ui/src/main/java/com/google/android/exoplayer2/ui/PlayerView.java
index bb8395b317..d9989370b4 100644
--- a/library/ui/src/main/java/com/google/android/exoplayer2/ui/PlayerView.java
+++ b/library/ui/src/main/java/com/google/android/exoplayer2/ui/PlayerView.java
@@ -186,8 +186,9 @@ import java.util.List;
  *         <li>Type: {@link AspectRatioFrameLayout}
  *       </ul>
  *   <li><b>{@code exo_shutter}</b> - A view that's made visible when video should be hidden. This
- *       view is typically an opaque view that covers the video surface view, thereby obscuring it
- *       when visible.
+ *       view is typically an opaque view that covers the video surface, thereby obscuring it when
+ *       visible. Obscuring the surface in this way also helps to prevent flicker at the start of
+ *       playback when {@code surface_type="surface_view"}
  *       <ul>
  *         <li>Type: {@link View}
  *       </ul>