Add documentation for maximum list size exceeded
Bug: 213240962
Test: n/a
Change-Id: I3e15d623c9b7ffac3ff9ca592ad2e5113d3bfb9c
diff --git a/framework/java/android/util/StatsEvent.java b/framework/java/android/util/StatsEvent.java
index a1988b8..51676f9 100644
--- a/framework/java/android/util/StatsEvent.java
+++ b/framework/java/android/util/StatsEvent.java
@@ -586,7 +586,9 @@
/**
* Write a repeated boolean field to this StatsEvent.
*
- * The list size must not exceed 127.
+ * The list size must not exceed 127. Otherwise, the array isn't written
+ * to the StatsEvent and ERROR_LIST_TOO_LONG is appended to the
+ * StatsEvent errors field.
*
* @param elements array of booleans.
**/
@@ -607,7 +609,9 @@
/**
* Write a repeated int field to this StatsEvent.
*
- * The list size must not exceed 127.
+ * The list size must not exceed 127. Otherwise, the array isn't written
+ * to the StatsEvent and ERROR_LIST_TOO_LONG is appended to the
+ * StatsEvent errors field.
*
* @param elements array of ints.
**/
@@ -628,7 +632,9 @@
/**
* Write a repeated long field to this StatsEvent.
*
- * The list size must not exceed 127.
+ * The list size must not exceed 127. Otherwise, the array isn't written
+ * to the StatsEvent and ERROR_LIST_TOO_LONG is appended to the
+ * StatsEvent errors field.
*
* @param elements array of longs.
**/
@@ -649,7 +655,9 @@
/**
* Write a repeated float field to this StatsEvent.
*
- * The list size must not exceed 127.
+ * The list size must not exceed 127. Otherwise, the array isn't written
+ * to the StatsEvent and ERROR_LIST_TOO_LONG is appended to the
+ * StatsEvent errors field.
*
* @param elements array of floats.
**/
@@ -670,7 +678,9 @@
/**
* Write a repeated string field to this StatsEvent.
*
- * The list size must not exceed 127.
+ * The list size must not exceed 127. Otherwise, the array isn't written
+ * to the StatsEvent and ERROR_LIST_TOO_LONG is appended to the
+ * StatsEvent errors field.
*
* @param elements array of strings.
**/
