am 376e93fc: am 7859c184: Merge "Improving PictureListener deprecating comments" into ics-mr1
* commit '376e93fcea19cd491af59631f3934ab036e1e846':
Improving PictureListener deprecating comments
diff --git a/core/java/android/webkit/WebView.java b/core/java/android/webkit/WebView.java
index 5f1f286..3ec7e2f 100644
--- a/core/java/android/webkit/WebView.java
+++ b/core/java/android/webkit/WebView.java
@@ -936,7 +936,11 @@
* Notify the listener that the picture has changed.
* @param view The WebView that owns the picture.
* @param picture The new picture.
- * @deprecated This method is now obsolete.
+ * @deprecated Due to internal changes, the picture does not include
+ * composited layers such as fixed position elements or scrollable divs.
+ * While the PictureListener API can still be used to detect changes in
+ * the WebView content, you are advised against its usage until a replacement
+ * is provided in a future Android release
*/
@Deprecated
public void onNewPicture(WebView view, Picture picture);