Merge pull request #272 from apache/FixJavadocWarningsMain

Fix javadoc warnings main

Author: leerho

src/main/java/com/yahoo/sketches/ByteArrayUtil.java

@@ -19,6 +19,10 @@
 
 package com.yahoo.sketches;
 
+/**
+ * Useful methods for byte arrays.
+ * @author Lee Rhodes
+ */
 public final class ByteArrayUtil {
 
   /**

src/main/java/com/yahoo/sketches/cpc/CpcSketch.java

@@ -64,6 +64,10 @@
 public final class CpcSketch {
   private static final String LS = System.getProperty("line.separator");
   private static final double[] kxpByteLookup = new double[256];
+
+  /**
+   * The default Log_base2 of K
+   */
   public static final int DEFAULT_LG_K = 11;
   final long seed;
   //common variables

src/main/java/com/yahoo/sketches/fdt/Group.java

@@ -38,12 +38,11 @@ public class Group implements Comparable<Group> {
   private final static String hfmt =
       "%12s"  + "%15s"    + "%15s"    + "%15s"    + "%12s"   + "%12s"   + " %s";
 
+  /**
+   * Construct an empty Group
+   */
   public Group() { }
 
-  public Group copy() {
-    return new Group();
-  }
-
   /**
    * Specifies the parameters to be listed as columns
    * @param priKey the primary key of the FDT sketch
@@ -117,7 +116,7 @@ public String toString() {
   /**
    * Note: this class has a natural ordering that is inconsistent with equals.
    * Ignore FindBugs EQ_COMPARETO_USE_OBJECT_EQUALS warning.
-   * @param that the Group to compare to
+   * @param that The Group to compare to
    */
   @Override
   public int compareTo(final Group that) {

src/main/java/com/yahoo/sketches/fdt/PostProcessor.java

@@ -140,7 +140,7 @@ private List<Group> populateList(final int numStdDev, final int limit) {
         final double lb = sketch.getLowerBound(numStdDev, count);
         final double thresh = (double) count / sketch.getRetainedEntries();
         final double rse = (sketch.getUpperBound(1, count) / est) - 1.0;
-        final Group gp = group.copy();
+        final Group gp = new Group();
         gp.init(priKey, count, est, ub, lb, thresh, rse);
         list.add(gp);
       }

src/main/java/com/yahoo/sketches/hash/XxHash.java

@@ -47,7 +47,14 @@ public class XxHash {
   private static final long P4 = -8796714831421723037L;
   private static final long P5 =  2870177450012600261L;
 
-
+  /**
+   * Compute the has of the given Memory object.
+   * @param mem The given Memory object
+   * @param offsetBytes Starting at this offset in bytes
+   * @param lengthBytes Continuing for this number of bytes
+   * @param seed use this seed for the hash function
+   * @return return the resulting 64-bit hash value.
+   */
   public static long hash(final Memory mem, final long offsetBytes, final long lengthBytes,
       final long seed) {
     return mem.xxHash64(offsetBytes, lengthBytes, seed);

src/main/java/com/yahoo/sketches/hll/HllSketch.java

@@ -63,7 +63,15 @@
  * @author Kevin Lang
  */
 public class HllSketch extends BaseHllSketch {
+
+  /**
+   * The default Log_base2 of K
+   */
   public static final int DEFAULT_LG_K = 12;
+
+  /**
+   * The default HLL-TYPE is HLL_4
+   */
   public static final TgtHllType DEFAULT_HLL_TYPE = TgtHllType.HLL_4;
 
   private static final String LS = System.getProperty("line.separator");

src/main/java/com/yahoo/sketches/hll/TgtHllType.java

@@ -51,6 +51,7 @@
 
  * @author Lee Rhodes
  */
+@SuppressWarnings("javadoc")
 public enum TgtHllType { HLL_4, HLL_6, HLL_8;
 
   static final TgtHllType values[] = values();

src/main/java/com/yahoo/sketches/kll/KllFloatsSketch.java

@@ -150,6 +150,9 @@
  */
 public class KllFloatsSketch {
 
+  /**
+   * The default value of K.
+   */
   public static final int DEFAULT_K = 200;
   static final int DEFAULT_M = 8;
   static final int MIN_K = DEFAULT_M;
@@ -479,7 +482,7 @@ public float[] getQuantiles(final double[] fractions) {
     final float[] quantiles = new float[fractions.length];
     for (int i = 0; i < fractions.length; i++) {
       final double fraction = fractions[i];
-      if (fraction < 0.0 || fraction > 1.0) {
+      if ((fraction < 0.0) || (fraction > 1.0)) {
         throw new SketchesArgumentException("Fraction cannot be less than zero or greater than 1.0");
       }
       if      (fraction == 0.0) { quantiles[i] = minValue_; }
@@ -848,6 +851,9 @@ public static KllFloatsSketch heapify(final Memory mem) {
     return new KllFloatsSketch(mem);
   }
 
+  /**
+   * @return the iterator for this class
+   */
   public KllFloatsSketchIterator iterator() {
     return new KllFloatsSketchIterator(items_, levels_, numLevels_);
   }

src/main/java/com/yahoo/sketches/quantiles/DoublesSketch.java

@@ -720,6 +720,9 @@ public void putMemory(final WritableMemory dstMem, final boolean compact) {
     }
   }
 
+  /**
+   * @return the iterator for this class
+   */
   public DoublesSketchIterator iterator() {
     return new DoublesSketchIterator(this, getBitPattern());
   }

src/main/java/com/yahoo/sketches/quantiles/ItemsSketch.java

@@ -567,11 +567,17 @@ public boolean isEmpty() {
    return getN() == 0;
   }
 
+  /**
+   * @return true if this sketch is off-heap
+   */
   @SuppressWarnings("static-method")
   public boolean isDirect() {
     return false;
   }
 
+  /**
+   * @return true if in estimation mode
+   */
   public boolean isEstimationMode() {
     return getN() >= (2L * k_);
   }
@@ -684,6 +690,9 @@ public void putMemory(final WritableMemory dstMem, final ArrayOfItemsSerDe<T> se
     dstMem.putByteArray(0, byteArr, 0, byteArr.length);
   }
 
+  /**
+   * @return the iterator for this class
+   */
   public ItemsSketchIterator<T> iterator() {
     return new ItemsSketchIterator<>(this, bitPattern_);
   }