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

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

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

core/java/android/widget/Toast.java

@@ -188,6 +188,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)) {