minor wording amendments

Author: paulk-asert

src/main/java/org/apache/commons/collections4/MultiMapUtils.java

@@ -178,18 +178,18 @@ public static boolean isEmpty(final MultiValuedMap<?, ?> map) {
      * {@link MultiValuedMap#inverted()}.
      *
      * @param source take key-to-value mappings from here
-     * @param dest add value-to-key mappings here
-     * @param <K> the dest key type
-     * @param <V> the dest value type
-     * @param <M> the dest multimap
-     * @return the destination
+     * @param collector add value-to-key mappings here
+     * @param <K> the collector key type
+     * @param <V> the collector value type
+     * @param <M> the collector multimap
+     * @return the updated collector
      */
     public static <K, V, M extends MultiValuedMap<K, V>>
-    M invertInto(MultiValuedMap<? extends V, ? extends K> source, M dest) {
+    M invertInto(MultiValuedMap<? extends V, ? extends K> source, M collector) {
         for (Map.Entry<? extends V, ? extends K> e : source.entries()) {
-            dest.put(e.getValue(), e.getKey());
+            collector.put(e.getValue(), e.getKey());
         }
-        return dest;
+        return collector;
     }
 
     /**

src/main/java/org/apache/commons/collections4/MultiValuedMap.java

@@ -141,11 +141,11 @@ public interface MultiValuedMap<K, V> {
     Collection<V> get(K key);
 
     /**
-     * Returns the inverse MultiValuedMap with inverted mappings.
+     * Returns a new MultiValuedMap with inverted mappings.
      * The new multimap will have a value-to-key mapping
      * for each key-to-value mapping in the original.
      *
-     * @return the inverse MultiValuedMap
+     * @return a new MultiValuedMap with inverted mappings
      */
     default MultiValuedMap<V, K> inverted() {
         throw new UnsupportedOperationException();