Merge "Add some comments about thread-safety" am: d0c6e0fa08

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1503391

MUST ONLY BE SUBMITTED BY AUTOMERGER

Change-Id: I547e6031e095b5d70e288332dd451635b048333f

core/java/android/os/ParcelableHolder.java

@@ -63,6 +63,8 @@ import android.util.MathUtils;
  * op.y = ...;
  * ap.extension.setParcelable(op);}</pre>
  *
+ * <p class="note">ParcelableHolder is <strong>not</strong> thread-safe.</p>
+ *
  * @hide
  */
 @SystemApi
@@ -120,6 +122,7 @@ public final class ParcelableHolder implements Parcelable {
 
     /**
      * Write a parcelable into ParcelableHolder, the previous parcelable will be removed.
+     * (@link #setParcelable} and (@link #getParcelable} are not thread-safe.
      * @throws BadParcelableException if the parcelable's stability is more unstable
      *         ParcelableHolder.
      */
@@ -139,6 +142,8 @@ public final class ParcelableHolder implements Parcelable {
     }
 
     /**
+     * Read a parcelable from ParcelableHolder.
+     * (@link #setParcelable} and (@link #getParcelable} are not thread-safe.
      * @return the parcelable that was written by {@link #setParcelable} or {@link #readFromParcel},
      *         or {@code null} if the parcelable has not been written.
      * @throws BadParcelableException if T is different from the type written by