SI-8783 MultiMap documentation for addBinding is incorrect

Fixed documentation to state that addBinding will not replace a `value` that is equal (according to ==).

1 files changed, 3 insertions, 4 deletions

diff --git a/src/library/scala/collection/mutable/MultiMap.scala b/src/library/scala/collection/mutable/MultiMap.scala
index 78dfc35268..ac2ebf31d8 100644
--- a/src/library/scala/collection/mutable/MultiMap.scala
+++ b/src/library/scala/collection/mutable/MultiMap.scala
@@ -65,10 +65,9 @@ trait MultiMap[A, B] extends Map[A, Set[B]] {
    */
   protected def makeSet: Set[B] = new HashSet[B]
 
-  /** Assigns the specified `value` to a specified `key`, replacing
-   *  the existing value assigned to that `key` if it is equal to
-   *  the specified value. Otherwise, simply adds another binding to
-   *  the `key`.
+  /** Assigns the specified `value` to a specified `key`.  If the key
+   *  already has a binding to equal to `value`, nothing is changed;
+   *  otherwise a new binding is added for that `key`.
    *
    *  @param key    The key to which to bind the new value.
    *  @param value  The value to bind to the key.