From 66cd477d7725f909f4c595e2b479a2fbaee31960 Mon Sep 17 00:00:00 2001
From: Hao Ke <haok@google.com>
Date: Wed, 9 Feb 2022 15:19:54 +0000
Subject: [PATCH] Update JavaDoc to replace deprecated Parcel read APIs.

Bug: 195622897
Change-Id: I5f6444dcc87ad76bf6f6312eea68891aa07604cb
Test: None
---
 core/java/android/os/Parcel.java | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/core/java/android/os/Parcel.java b/core/java/android/os/Parcel.java
index 13d1d96fadc81..eed7571b663d5 100644
--- a/core/java/android/os/Parcel.java
+++ b/core/java/android/os/Parcel.java
@@ -198,7 +198,7 @@ import java.util.function.Supplier;
  * The methods to use are {@link #writeFileDescriptor(FileDescriptor)},
  * {@link #readFileDescriptor()}.
  *
- * <h3>Untyped Containers</h3>
+  * <h3>Parcelable Containers</h3>
  *
  * <p>A final class of methods are for writing and reading standard Java
  * containers of arbitrary types.  These all revolve around the
@@ -210,6 +210,19 @@ import java.util.function.Supplier;
  * {@link #writeMap(Map)}, {@link #readMap(Map, ClassLoader)},
  * {@link #writeSparseArray(SparseArray)},
  * {@link #readSparseArray(ClassLoader)}.
+ *
+ * <h3>Restricted Parcelable Containers</h3>
+ *
+ * <p>A final class of methods are for reading standard Java containers of restricted types.
+ * These methods replace methods for reading containers of arbitrary types from previous section
+ * starting from Android {@link Build.VERSION_CODES#TIRAMISU}. The pairing writing methods are
+ * still the same from previous section.
+ * These methods accepts additional {@code clazz} parameters as the required types.
+ * The Restricted Parcelable container methods are {@link #readArray(ClassLoader, Class)},
+ * {@link #readList(List, ClassLoader, Class)},
+ * {@link #readArrayList(ClassLoader, Class)},
+ * {@link #readMap(Map, ClassLoader, Class, Class)},
+ * {@link #readSparseArray(ClassLoader, Class)}.
  */
 public final class Parcel {