diff --git a/src/java/com/samskivert/annotation/ReplacedBy.java b/src/java/com/samskivert/annotation/ReplacedBy.java
index 76f82a99..ddaaf95f 100644
--- a/src/java/com/samskivert/annotation/ReplacedBy.java
+++ b/src/java/com/samskivert/annotation/ReplacedBy.java
@@ -39,7 +39,12 @@ public @interface ReplacedBy
 {
     /**
      * A human-readable String containing a reference to the replacement Class, method, or field.
-     * It is suggested that you follow the "&at;see" javadoc semantics for specifying a reference.
+     * It is suggested that you follow the "@see" javadoc semantics for specifying a reference.
      */
     String value ();
+
+    /**
+     * The reason the replacement is suggested, in case it's not obvious.
+     */
+    String reason() default "";
 }
diff --git a/src/java/com/samskivert/util/IntMap.java b/src/java/com/samskivert/util/IntMap.java
index a27cfd6e..d34089e2 100644
--- a/src/java/com/samskivert/util/IntMap.java
+++ b/src/java/com/samskivert/util/IntMap.java
@@ -23,6 +23,8 @@ package com.samskivert.util;
 import java.util.Map;
 import java.util.Set;
 
+import com.samskivert.annotation.ReplacedBy;
+
 /**
  * An int map is a map that uses integers as keys and provides accessors
  * that eliminate the need to create and manipulate superfluous
@@ -30,6 +32,8 @@ import java.util.Set;
  * and therefore provides all of the standard accessors (for which
  * <code>Integer</code> objects should be supplied as keys).
  */
+@ReplacedBy(value="java.util.Map", reason="Boxing shouldn't be a major concern. " +
+    "The performance gain from using an IntMap probably isn't worth trouble.")
 public interface IntMap<V> extends Map<Integer,V>
 {
     /**