diff --git a/src/as/com/threerings/util/StreamableHashMap.as b/src/as/com/threerings/util/StreamableHashMap.as
index b65721db4..55591c1d6 100644
--- a/src/as/com/threerings/util/StreamableHashMap.as
+++ b/src/as/com/threerings/util/StreamableHashMap.as
@@ -40,6 +40,14 @@ import com.threerings.util.maps.ImmutableMap;
 public class StreamableHashMap extends ForwardingMap
     implements Streamable
 {
+    /**
+     * Creates a new StreamableHashMap.
+     *
+     * @param keyClazz The class to use as the map key. May be null, but this functionality is
+     * provided only for deserialization. A StreamableHashMap that has not been initialized
+     * properly by either a non-null keyClazz or via readObject will throw errors on write and
+     * always return null on read.
+     */
     public function StreamableHashMap (keyClazz :Class = null)
     {
         super(keyClazz == null ? DEFAULT_MAP : Maps.newMapOf(keyClazz));