Fixed javadoc warnings & added a few deprecations.

Change-Id: I89205b08bc5fcbfed769c489609a46d420ee227e
diff --git a/utils/misc/src/main/java/org/onlab/util/Tools.java b/utils/misc/src/main/java/org/onlab/util/Tools.java
index b12d15c..abc48cc 100644
--- a/utils/misc/src/main/java/org/onlab/util/Tools.java
+++ b/utils/misc/src/main/java/org/onlab/util/Tools.java
@@ -236,6 +236,8 @@
      * @param maxDelayBetweenRetries max delay between successive retries. The actual delay is randomly picked from
      * the interval (0, maxDelayBetweenRetries]
      * @return function
+     * @param <U> type of function input
+     * @param <V> type of function output
      */
     public static <U, V> Function<U, V> retryable(Function<U, V> base,
             Class<? extends Throwable> exceptionClass,
@@ -252,6 +254,7 @@
      * @param maxDelayBetweenRetries max delay between successive retries. The actual delay is randomly picked from
      * the interval (0, maxDelayBetweenRetries]
      * @return supplier
+     * @param <V> type of supplied result
      */
     public static <V> Supplier<V> retryable(Supplier<V> base,
             Class<? extends Throwable> exceptionClass,