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

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

Change-Id: I6f3c95c46c67553fb88c85032ab80b6d1f503926
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>

core/java/android/widget/Toast.java

@@ -189,6 +189,9 @@ public class Toast {
 
     /**
      * 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)) {