From 43a5328c8377aa29acd51098d915503e87f13a9a Mon Sep 17 00:00:00 2001
From: John Reck <jreck@google.com>
Date: Thu, 23 Oct 2014 13:56:03 -0700
Subject: [PATCH] Improve documentation

Bug: 17440886

Change-Id: I3f5c0dab6e08c0097fe60eb269e7fffe7b48b563
---
 core/java/android/view/Surface.java | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/core/java/android/view/Surface.java b/core/java/android/view/Surface.java
index 132e25cb99fa3..562d13866984c 100644
--- a/core/java/android/view/Surface.java
+++ b/core/java/android/view/Surface.java
@@ -311,7 +311,10 @@ public class Surface implements Parcelable {
      * Unlike {@link #lockCanvas(Rect)} this will return a hardware-accelerated
      * canvas. See the <a href="{@docRoot}guide/topics/graphics/hardware-accel.html#unsupported">
      * unsupported drawing operations</a> for a list of what is and isn't
-     * supported in a hardware-accelerated canvas.
+     * supported in a hardware-accelerated canvas. It is also required to
+     * fully cover the surface every time {@link #lockHardwareCanvas()} is
+     * called as the buffer is not preserved between frames. Partial updates
+     * are not supported.
      *
      * @return A canvas for drawing into the surface.
      *