diff --git a/RELEASE-NOTES.html b/RELEASE-NOTES.html
index b0fc45cfb..6fd71aef1 100644
--- a/RELEASE-NOTES.html
+++ b/RELEASE-NOTES.html
@@ -38,11 +38,18 @@ This release is fully source and binary compatible with v3.1.
 Please check the bug fixes to ensure you weren't relying on the behaviour of a bug.
 </p>
 <p>
-There is one new <i>deprecation</i>:<br />
+There are two new <i>deprecations</i>:<br />
 BeanMap is now deprecated and will be removed in v4.0.
 The class is now available in commons-beanutils (full jar version).
 This change was made to ensure that all bean related collections were in one place (ie. beanutils).
-If this causes major headaches to anyone please contact commons-dev at jakarta.apache.org
+If this causes major headaches to anyone please contact commons-dev at jakarta.apache.org.
+</p>
+<p>
+MultiHashMap is now deprecated and will be removed in v4.0.
+The class is now available as MultiValueMap in the map subpackage.
+This new version of the class is a decorator and can wrap maps other than HashMap
+making it much more flexible.
+If this causes major headaches to anyone please contact commons-dev at jakarta.apache.org.
 </p>
 
 <center><h3>NEW CLASSES</h3></center>
diff --git a/src/java/org/apache/commons/collections/MultiHashMap.java b/src/java/org/apache/commons/collections/MultiHashMap.java
index de411397b..bb0026173 100644
--- a/src/java/org/apache/commons/collections/MultiHashMap.java
+++ b/src/java/org/apache/commons/collections/MultiHashMap.java
@@ -51,6 +51,9 @@ import org.apache.commons.collections.iterators.EmptyIterator;
  * <p>
  * <code>list</code> will be a list containing "A", "B", "C".
  *
+ * @deprecated Class now available as MultiValueMap in map subpackage.
+ * This version is due to be removed in collections v4.0.
+ *
  * @since Commons Collections 2.0
  * @version $Revision$ $Date$
  *