Merge "Add Toast#show() specific javadoc" into android13-tests-dev am: 1d8b567ae1 am: f8ba53d9c9 am: 532379563a

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

Change-Id: Idfb45d95320bbb8bf0209a5fc73d275c1174ac2f
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
diff --git a/core/java/android/widget/Toast.java b/core/java/android/widget/Toast.java
index ca57c84..fceee4e 100644
--- a/core/java/android/widget/Toast.java
+++ b/core/java/android/widget/Toast.java
@@ -189,6 +189,9 @@
 
     /**
      * Show the view for the specified duration.
+     *
+     * <p>Note that toasts being sent from the background are rate limited, so avoid sending such
+     * toasts in quick succession.
      */
     public void show() {
         if (Compatibility.isChangeEnabled(CHANGE_TEXT_TOASTS_IN_THE_SYSTEM)) {