From 6ee192f4e981845db5fdff127bf2ee990cd05dbf Mon Sep 17 00:00:00 2001
From: Chris Craik <ccraik@google.com>
Date: Tue, 17 May 2016 14:29:10 -0700
Subject: Document that SurfaceView is synchronous in N

bug:28821062

Change-Id: I1c17949d93de3d1f89c504fc061f7d20dd451a4d
---
 core/java/android/view/SurfaceView.java | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/core/java/android/view/SurfaceView.java b/core/java/android/view/SurfaceView.java
index ccb5ec467b1e..d59c8acb9107 100644
--- a/core/java/android/view/SurfaceView.java
+++ b/core/java/android/view/SurfaceView.java
@@ -82,6 +82,13 @@ import java.util.concurrent.locks.ReentrantLock;
  * and
  * {@link SurfaceHolder.Callback#surfaceDestroyed SurfaceHolder.Callback.surfaceDestroyed()}.
  * </ul>
+ *
+ * <p class="note"><strong>Note:</strong> Starting in platform version
+ * {@link android.os.Build.VERSION_CODES#N}, SurfaceView's window position is
+ * updated synchronously with other View rendering. This means that translating
+ * and scaling a SurfaceView on screen will not cause rendering artifacts. Such
+ * artifacts may occur on previous versions of the platform when its window is
+ * positioned asynchronously.</p>
  */
 public class SurfaceView extends View {
     static private final String TAG = "SurfaceView";
-- 
cgit v1.2.3-59-g8ed1b