From 8cf456cea9d7459e34de81c16e17b8c1823ecc81 Mon Sep 17 00:00:00 2001
From: Jan Tomljanovic <jtomljanovic@google.com>
Date: Wed, 9 Jun 2021 10:56:22 +0100
Subject: [PATCH] Expand toast javadoc to include rate limiting info.

Test: N/A just adding javadoc
Bug: 190468866
Change-Id: I0a1ab865f5db7a990c1a667b729df52c4735a38c
---
 core/java/android/widget/Toast.java | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/core/java/android/widget/Toast.java b/core/java/android/widget/Toast.java
index b35eb065e3fbb..862829bf9b55a 100644
--- a/core/java/android/widget/Toast.java
+++ b/core/java/android/widget/Toast.java
@@ -71,6 +71,9 @@ import java.util.List;
  * Note that
  * <a href="{@docRoot}reference/com/google/android/material/snackbar/Snackbar">Snackbars</a> are
  * preferred for brief messages while the app is in the foreground.
+ * <p>
+ * Note that toasts being sent from the background are rate limited, so avoid sending such toasts
+ * in quick succession.
  *
  * <div class="special reference">
  * <h3>Developer Guides</h3>