Expand MapAdaptor javadoc

This fixes a few warnings around javadoc completes of MapAdaptor.

Change-Id: I6bb7b6354530b4ad47a07b4b0358c720b80b4230
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>
(cherry picked from commit 45c0f0b3468741c1b26f8d65f79f722c43e5e3c9)

diff --git a/common/util/src/main/java/org/opendaylight/yangtools/util/MapAdaptor.java b/common/util/src/main/java/org/opendaylight/yangtools/util/MapAdaptor.java
index 1198df67acd0e2533ad281f86304af29757ace64..c5e4ff48980bcd6694425bb7b7b0837d3772dfde 100644 (file)
--- a/common/util/src/main/java/org/opendaylight/yangtools/util/MapAdaptor.java
+++ b/common/util/src/main/java/org/opendaylight/yangtools/util/MapAdaptor.java
@@ -80,8 +80,7 @@ public final class MapAdaptor {
     }
 
     /**
-     * Creates an initial snapshot. The backing map is selected according to
-     * the expected size.
+     * Creates an initial snapshot. The backing map is selected according to the expected size.
      *
      * @param expectedSize Expected map size
      * @return An empty mutable map.
@@ -103,6 +102,10 @@ public final class MapAdaptor {
 
     /**
      * Input is treated is supposed to be left unmodified, result must be mutable.
+     *
+     * @param input input map
+     * @return An isolated, read-write snapshot of input map
+     * @throws NullPointerException if input is null
      */
     @SuppressWarnings("static-method")
     public <K, V> Map<K, V> takeSnapshot(final Map<K, V> input) {
@@ -158,7 +161,8 @@ public final class MapAdaptor {
      * {@link #takeSnapshot(Map)} purposes.
      *
      * @param input non-optimized (read-write) map
-     * @return  optimized read-only map
+     * @return optimized read-only map
+     * @throws NullPointerException if input is null
      */
     public <K, V> Map<K, V> optimize(final Map<K, V> input) {
         if (input instanceof ReadOnlyTrieMap) {