diff --git a/guava/src/com/google/common/collect/ImmutableMultimap.java b/guava/src/com/google/common/collect/ImmutableMultimap.java index 24a8a1b1fb35..feeb919cb433 100644 --- a/guava/src/com/google/common/collect/ImmutableMultimap.java +++ b/guava/src/com/google/common/collect/ImmutableMultimap.java @@ -125,6 +125,10 @@ public static ImmutableMultimap of( /** * Returns a new builder. The generated builder is equivalent to the builder created by the {@link * Builder} constructor. + * + *

The returned builder always builds an {@link ImmutableListMultimap}. For clarity and to + * avoid the pitfalls described in the {@linkplain ImmutableMultimap class documentation}, prefer + * {@link ImmutableListMultimap#builder} or {@link ImmutableSetMultimap#builder}. */ public static Builder builder() { return new Builder<>(); @@ -360,7 +364,10 @@ Builder combine(Builder other) { return this; } - /** Returns a newly-created immutable multimap. */ + /** + * Returns a newly-created immutable multimap. The returned multimap is an {@link + * ImmutableListMultimap}. + */ public ImmutableMultimap build() { if (builderMap == null) { return ImmutableListMultimap.of();