Index: trunk/src/org/openstreetmap/josm/data/osm/Storage.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/osm/Storage.java	(revision 11341)
+++ trunk/src/org/openstreetmap/josm/data/osm/Storage.java	(revision 11342)
@@ -72,4 +72,7 @@
 public class Storage<T> extends AbstractSet<T> {
 
+    /**
+     * Hash for {@link PrimitiveId}.
+     */
     public static class PrimitiveIdHash implements Hash<PrimitiveId, PrimitiveId> {
 
@@ -111,20 +114,49 @@
     }
 
+    /**
+     * Constructs a new {@code Storage} with given hash.
+     * @param ha hash
+     */
     public Storage(Hash<? super T, ? super T> ha) {
         this(ha, DEFAULT_CAPACITY, false);
     }
 
+    /**
+     * Constructs a new {@code Storage}.
+     * @param safeIterator If set to false, you must not modify the Storage while iterating over it.
+     * If set to true, you can safely modify, but the read-only iteration will happen on a copy of the unmodified Storage.
+     * This is similar to CopyOnWriteArrayList.
+     */
     public Storage(boolean safeIterator) {
         this(Storage.<T>defaultHash(), DEFAULT_CAPACITY, safeIterator);
     }
 
+    /**
+     * Constructs a new {@code Storage} with given capacity.
+     * @param capacity capacity
+     * @param safeIterator If set to false, you must not modify the Storage while iterating over it.
+     * If set to true, you can safely modify, but the read-only iteration will happen on a copy of the unmodified Storage.
+     * This is similar to CopyOnWriteArrayList.
+     */
     public Storage(int capacity, boolean safeIterator) {
         this(Storage.<T>defaultHash(), capacity, safeIterator);
     }
 
+    /**
+     * Constructs a new {@code Storage} with given hash.
+     * @param ha hash
+     * @param safeIterator If set to false, you must not modify the Storage while iterating over it.
+     * If set to true, you can safely modify, but the read-only iteration will happen on a copy of the unmodified Storage.
+     * This is similar to CopyOnWriteArrayList.
+     */
     public Storage(Hash<? super T, ? super T> ha, boolean safeIterator) {
         this(ha, DEFAULT_CAPACITY, safeIterator);
     }
 
+    /**
+     * Constructs a new {@code Storage} with given hash and capacity.
+     * @param ha hash
+     * @param capacity capacity
+     */
     public Storage(Hash<? super T, ? super T> ha, int capacity) {
         this(ha, capacity, false);
@@ -132,12 +164,10 @@
 
     /**
-     * constructor
+     * Constructs a new {@code Storage} with given hash and capacity.
      * @param ha hash
      * @param capacity capacity
-     * @param safeIterator If set to false, you must not modify the Storage
-     *          while iterating over it. If set to true, you can safely
-     *          modify, but the read-only iteration will happen on a copy
-     *          of the unmodified Storage.
-     *          This is similar to CopyOnWriteArrayList.
+     * @param safeIterator If set to false, you must not modify the Storage while iterating over it.
+     * If set to true, you can safely modify, but the read-only iteration will happen on a copy of the unmodified Storage.
+     * This is similar to CopyOnWriteArrayList.
      */
     public Storage(Hash<? super T, ? super T> ha, int capacity, boolean safeIterator) {