fix comments per @ahornace

Author: Vladimir Kotal

suggester/src/main/java/org/opengrok/suggest/Suggester.java

@@ -173,6 +173,12 @@ public void init(final Collection<NamedIndexDir> luceneIndexes) {
         }
     }
 
+    /**
+     * wait for initialization to finish.
+     * @param timeout timeout value
+     * @param unit timeout unit
+     * @throws InterruptedException
+     */
     public void waitForInit(long timeout, TimeUnit unit) throws InterruptedException {
         initDone.await(timeout, unit);
     }
@@ -249,7 +255,6 @@ public void rebuild(final Collection<NamedIndexDir> indexDirs) {
             return;
         }
 
-        // for testing
         rebuildLock.lock();
         rebuilding = true;
         rebuildLock.unlock();
@@ -272,7 +277,6 @@ public void rebuild(final Collection<NamedIndexDir> indexDirs) {
             shutdownAndAwaitTermination(executor, start, "Suggesters for " + indexDirs + " were successfully rebuilt");
         }
 
-        // for testing
         rebuildLock.lock();
         try {
             rebuilding = false;
@@ -282,7 +286,12 @@ public void rebuild(final Collection<NamedIndexDir> indexDirs) {
         }
     }
 
-    // for testing
+    /**
+     * wait for rebuild to finish.
+     * @param timeout timeout value
+     * @param unit timeout unit
+     * @throws InterruptedException
+     */
     public void waitForRebuild(long timeout, TimeUnit unit) throws InterruptedException {
         rebuildLock.lock();
         try {