Generate Javadoc and JDiff for Guava 999.0.0-HEAD-jre-SNAPSHOT

Author: copybara-service[bot]

releases/snapshot-android/api/diffs/snapshot-android.xml

@@ -30432,7 +30432,9 @@
       <param name="factory" type="com.google.common.base.Supplier&lt;? extends java.util.Collection&lt;V&gt;&gt;"/>
       <doc>
       <![CDATA[Creates a new {@code Multimap} backed by {@code map}, whose internal value collections are
- generated by {@code factory}.
+ generated by {@code factory}. Most users should prefer {@link MultimapBuilder}, though a small
+ number of users will need this method to cover map or collection types that {@link
+ MultimapBuilder} does not support.
 
  <p><b>Warning: do not use</b> this method when the collections returned by {@code factory}
  implement either {@link List} or {@code Set}! Use the more specific method {@link
@@ -30475,7 +30477,9 @@
       <param name="factory" type="com.google.common.base.Supplier&lt;? extends java.util.List&lt;V&gt;&gt;"/>
       <doc>
       <![CDATA[Creates a new {@code ListMultimap} that uses the provided map and factory. It can generate a
- multimap based on arbitrary {@link Map} and {@link List} classes.
+ multimap based on arbitrary {@link Map} and {@link List} classes. Most users should prefer
+ {@link MultimapBuilder}, though a small number of users will need this method to cover map or
+ collection types that {@link MultimapBuilder} does not support.
 
  <p>The {@code factory}-generated and {@code map} classes determine the multimap iteration
  order. They also specify the behavior of the {@code equals}, {@code hashCode}, and {@code
@@ -30512,7 +30516,9 @@
       <param name="factory" type="com.google.common.base.Supplier&lt;? extends java.util.Set&lt;V&gt;&gt;"/>
       <doc>
       <![CDATA[Creates a new {@code SetMultimap} that uses the provided map and factory. It can generate a
- multimap based on arbitrary {@link Map} and {@link Set} classes.
+ multimap based on arbitrary {@link Map} and {@link Set} classes. Most users should prefer
+ {@link MultimapBuilder}, though a small number of users will need this method to cover map or
+ collection types that {@link MultimapBuilder} does not support.
 
  <p>The {@code factory}-generated and {@code map} classes determine the multimap iteration
  order. They also specify the behavior of the {@code equals}, {@code hashCode}, and {@code