/**
 * <p>The hll package contains a very compact implementation of Phillipe Flajolet's
 * HLL sketch but with significantly improved error behavior.  If the ONLY use case for sketching is
 * counting uniques and merging, the HLL sketch is the highest performing in terms of accuracy for 
 * space consumed.  For large counts, this HLL version will be 16 times smaller for the same 
 * accuracy than the Theta Sketches mentioned above.</p>
 * 
 * <p>However, large data with many dimensions and dimension coordinates are often highly skewed 
 * in their distribution of unique values. 
 * In this case many sketches tend to have only a few entries. Averaged over all the sketches of 
 * this data, the size advantage of the HLL can be significantly reduced down to near parity with 
 * theta sketches. This property is strictly a function of the distribution of the input data so it
 * is advisable to understand and measure this phenomenon.
 * The HLL sketch is not recommended if you anticipate the need of performing set intersection 
 * or difference operations with reasonable accuracy, 
 * or if you anticipate the need to merge sketches that were constructed with different 
 * values of <i>k</i> or <i>Nominal Entries</i>.  HLL sketches do not retain any of the sampled
 * hash values of the associated unique identifiers, so if there is any anticipation of the need
 * to leverage associations with these sampled hash values, Theta Sketches would be a better choice.
 * HLL sketches cannot be intermixed or merged in any way with Theta Sketches.
 * </p>
 * 
 * @author Lee Rhodes
 */
package com.yahoo.sketches.hll;
@@ -348,16 +348,22 @@
 l be 16 
+to 32 
 times sm
@@ -548,16 +548,45 @@
 %0A * 
-in their
+creating a %22long-tailed%22 or power-law
  dis
@@ -611,16 +611,27 @@
 e values
+ per sketch
 . %0A * In
@@ -641,20 +641,29 @@
 is case 
-many
+a majority of
  sketche
@@ -699,60 +699,147 @@
 ries
-. Averaged over all the sketches of %0A * this data, t
+ and it is this long tail of%0A * the distribution of sketch sizes that will dominate the overall storage cost for all of the %0A * sketches. T
 he s
@@ -863,19 +863,20 @@
 the HLL 
-can
+will
  be sign
@@ -905,28 +905,47 @@
  to 
-near parity with %0A *
+a factor of %0A * two to four compared to
  the
@@ -966,16 +966,16 @@
 his 
-property
+behavior
  is 
@@ -997,24 +997,28 @@
 tion of the 
+%0A * 
 distribution
@@ -1041,19 +1041,16 @@
 ta so it
-%0A *
  is advi
@@ -1096,21 +1096,54 @@
 enomenon
-.%0A * 
+ with%0A * your own data.%3C/p%3E%0A * %0A * %3Cp%3E
 The HLL 
@@ -1419,18 +1419,31 @@
 ies%3C/i%3E.
-  
+%3C/p%3E%0A * %0A * %3Cp%3E
 HLL sket
@@ -1475,19 +1475,8 @@
  the
- sampled%0A *
  has
@@ -1522,16 +1522,20 @@
 ifiers, 
+%0A * 
 so if th
@@ -1565,19 +1565,21 @@
  of 
-th
+a futur
 e need
-%0A *
  to 
@@ -1615,13 +1615,18 @@
 ese 
-sampl
+%0A * retain
 ed h
@@ -1677,20 +1677,31 @@
  choice.
-%0A * 
+%3C/p%3E%0A * %0A * %3Cp%3E
 HLL sket

Update HLL package-info