diff --git a/android/guava/src/com/google/common/collect/Iterables.java b/android/guava/src/com/google/common/collect/Iterables.java index 639339d7f5cc..d99e4124f766 100644 --- a/android/guava/src/com/google/common/collect/Iterables.java +++ b/android/guava/src/com/google/common/collect/Iterables.java @@ -1061,8 +1061,9 @@ public static boolean isEmpty(Iterable> iterable) { *
Callers must ensure that the source {@code iterables} are in non-descending order as this * method does not sort its input. * - *
For any equivalent elements across all {@code iterables}, it is undefined which element is - * returned first. + *
For any equivalent elements across all {@code iterables}, elements are returned in the order + * of their source iterables. That is, if element A from iterable 1 and element B from iterable 2 + * compare as equal, A will be returned before B if iterable 1 was passed before iterable 2. * * @since 11.0 */ diff --git a/guava/src/com/google/common/collect/Iterables.java b/guava/src/com/google/common/collect/Iterables.java index 8ce6531a28d7..01e5b0bd363b 100644 --- a/guava/src/com/google/common/collect/Iterables.java +++ b/guava/src/com/google/common/collect/Iterables.java @@ -1067,8 +1067,9 @@ public static boolean isEmpty(Iterable> iterable) { *
Callers must ensure that the source {@code iterables} are in non-descending order as this * method does not sort its input. * - *
For any equivalent elements across all {@code iterables}, it is undefined which element is - * returned first. + *
For any equivalent elements across all {@code iterables}, elements are returned in the order + * of their source iterables. That is, if element A from iterable 1 and element B from iterable 2 + * compare as equal, A will be returned before B if iterable 1 was passed before iterable 2. * * @since 11.0 */