diff --git a/router/java/src/net/i2p/router/peermanager/PeerManager.java b/router/java/src/net/i2p/router/peermanager/PeerManager.java
index 146e6a3f9b05e7622a605d1bb970f9d9225205f2..7086f1cfc643e62ba308fc38f14adce085c1e681 100644
--- a/router/java/src/net/i2p/router/peermanager/PeerManager.java
+++ b/router/java/src/net/i2p/router/peermanager/PeerManager.java
@@ -30,6 +30,16 @@ import net.i2p.util.SimpleTimer;
 /**
  * Manage the current state of the statistics
  *
+ * All the capabilities methods appear to be almost unused -
+ * TunnelPeerSelector just looks for unreachables, and that's it?
+ * If so, a lot of this can go away, including the array of 26 ArrayLists,
+ * and a lot of synchronization on _capabilitiesByPeer.
+ *
+ * We don't trust any published capabilities except for 'K' and 'U'.
+ * This should be cleaned up.
+ *
+ * setCapabilities() and removeCapabilities() can just add/remove the profile and that's it.
+ *
  */
 class PeerManager {
     private Log _log;