incubator-blur-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From amccu...@apache.org
Subject [11/17] git commit: More documentation and small apit cleanup changes.
Date Fri, 16 Aug 2013 20:09:10 GMT
More documentation and small apit cleanup changes.


Project: http://git-wip-us.apache.org/repos/asf/incubator-blur/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-blur/commit/ee933e4c
Tree: http://git-wip-us.apache.org/repos/asf/incubator-blur/tree/ee933e4c
Diff: http://git-wip-us.apache.org/repos/asf/incubator-blur/diff/ee933e4c

Branch: refs/heads/master
Commit: ee933e4c48512ebc361792615e50a9b9676c3d5e
Parents: 42c1afe
Author: Aaron McCurry <amccurry@gmail.com>
Authored: Fri Aug 16 14:03:50 2013 -0400
Committer: Aaron McCurry <amccurry@gmail.com>
Committed: Fri Aug 16 14:03:50 2013 -0400

----------------------------------------------------------------------
 .../org/apache/blur/manager/IndexManager.java   |   2 +-
 .../clusterstatus/ZookeeperClusterStatus.java   |   2 +-
 .../java/org/apache/blur/thrift/TableAdmin.java |   2 +-
 .../ZookeeperClusterStatusTest.java             |   2 +-
 .../apache/blur/jdbc/BlurDatabaseMetaData.java  |   2 +-
 .../apache/blur/shell/DescribeTableCommand.java |   2 +-
 .../apache/blur/shell/TruncateTableCommand.java |   2 +-
 .../org/apache/blur/thrift/generated/Blur.java  | 235 +++++++++++++++++--
 .../blur/thrift/generated/ColumnDefinition.java |   3 +
 .../apache/blur/thrift/generated/Metric.java    |  51 ++++
 .../blur/thrift/generated/TableDescriptor.java  | 106 ++++-----
 .../thrift/util/CreateInsertQueryRepeating.java |   2 +-
 .../src/main/scripts/interface/Blur.thrift      |  69 +++---
 .../main/scripts/interface/gen-html/Blur.html   |  96 ++++++--
 .../org/apache/blur/thrift/generated/Blur.java  | 235 +++++++++++++++++--
 .../blur/thrift/generated/ColumnDefinition.java |   3 +
 .../apache/blur/thrift/generated/Metric.java    |  51 ++++
 .../blur/thrift/generated/TableDescriptor.java  | 106 ++++-----
 .../main/scripts/interface/gen-js/Blur_types.js |  14 +-
 .../scripts/interface/gen-perl/Blur/Types.pm    |  16 +-
 .../src/main/scripts/interface/gen-rb/blur.rb   |  15 ++
 .../main/scripts/interface/gen-rb/blur_types.rb |  12 +-
 22 files changed, 803 insertions(+), 225 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/blur-core/src/main/java/org/apache/blur/manager/IndexManager.java
----------------------------------------------------------------------
diff --git a/blur-core/src/main/java/org/apache/blur/manager/IndexManager.java b/blur-core/src/main/java/org/apache/blur/manager/IndexManager.java
index dc2902c..dd2ffb9 100644
--- a/blur-core/src/main/java/org/apache/blur/manager/IndexManager.java
+++ b/blur-core/src/main/java/org/apache/blur/manager/IndexManager.java
@@ -733,7 +733,7 @@ public class IndexManager {
 
   private static Term getTerm(String columnFamily, String columnName, String value) {
     if (columnName == null) {
-      throw new NullPointerException("ColumnName cannot both be null.");
+      throw new NullPointerException("ColumnName cannot be null.");
     }
     if (columnFamily == null) {
       return new Term(columnName, value);

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/blur-core/src/main/java/org/apache/blur/manager/clusterstatus/ZookeeperClusterStatus.java
----------------------------------------------------------------------
diff --git a/blur-core/src/main/java/org/apache/blur/manager/clusterstatus/ZookeeperClusterStatus.java b/blur-core/src/main/java/org/apache/blur/manager/clusterstatus/ZookeeperClusterStatus.java
index 4ef858d..7ef482d 100644
--- a/blur-core/src/main/java/org/apache/blur/manager/clusterstatus/ZookeeperClusterStatus.java
+++ b/blur-core/src/main/java/org/apache/blur/manager/clusterstatus/ZookeeperClusterStatus.java
@@ -462,7 +462,7 @@ public class ZookeeperClusterStatus extends ClusterStatus {
   private void updateReadOnlyAndEnabled(boolean useCache, TableDescriptor tableDescriptor, String cluster, String table) {
     if (tableDescriptor != null) {
       tableDescriptor.setReadOnly(isReadOnly(useCache, cluster, table));
-      tableDescriptor.setIsEnabled(isEnabled(useCache, cluster, table));
+      tableDescriptor.setEnabled(isEnabled(useCache, cluster, table));
     }
   }
 

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/blur-core/src/main/java/org/apache/blur/thrift/TableAdmin.java
----------------------------------------------------------------------
diff --git a/blur-core/src/main/java/org/apache/blur/thrift/TableAdmin.java b/blur-core/src/main/java/org/apache/blur/thrift/TableAdmin.java
index b1813e6..ea404d9 100644
--- a/blur-core/src/main/java/org/apache/blur/thrift/TableAdmin.java
+++ b/blur-core/src/main/java/org/apache/blur/thrift/TableAdmin.java
@@ -104,7 +104,7 @@ public abstract class TableAdmin implements Iface {
           tableDescriptor);
       throw new BException(e.getMessage(), e);
     }
-    if (tableDescriptor.isEnabled) {
+    if (tableDescriptor.isEnabled()) {
       enableTable(tableDescriptor.getName());
     }
   }

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/blur-core/src/test/java/org/apache/blur/manager/clusterstatus/ZookeeperClusterStatusTest.java
----------------------------------------------------------------------
diff --git a/blur-core/src/test/java/org/apache/blur/manager/clusterstatus/ZookeeperClusterStatusTest.java b/blur-core/src/test/java/org/apache/blur/manager/clusterstatus/ZookeeperClusterStatusTest.java
index d867941..52307f0 100644
--- a/blur-core/src/test/java/org/apache/blur/manager/clusterstatus/ZookeeperClusterStatusTest.java
+++ b/blur-core/src/test/java/org/apache/blur/manager/clusterstatus/ZookeeperClusterStatusTest.java
@@ -198,7 +198,7 @@ public class ZookeeperClusterStatusTest {
     TableDescriptor tableDescriptor = new TableDescriptor();
     tableDescriptor.setName(name);
     tableDescriptor.setTableUri("./target/tmp/zk_test_hdfs");
-    tableDescriptor.setIsEnabled(enabled);
+    tableDescriptor.setEnabled(enabled);
     clusterStatus.createTable(tableDescriptor);
     if (enabled) {
       clusterStatus.enableTable(tableDescriptor.getCluster(), name);

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/blur-jdbc/src/main/java/org/apache/blur/jdbc/BlurDatabaseMetaData.java
----------------------------------------------------------------------
diff --git a/blur-jdbc/src/main/java/org/apache/blur/jdbc/BlurDatabaseMetaData.java b/blur-jdbc/src/main/java/org/apache/blur/jdbc/BlurDatabaseMetaData.java
index 1c6b020..18a97ec 100644
--- a/blur-jdbc/src/main/java/org/apache/blur/jdbc/BlurDatabaseMetaData.java
+++ b/blur-jdbc/src/main/java/org/apache/blur/jdbc/BlurDatabaseMetaData.java
@@ -71,7 +71,7 @@ public class BlurDatabaseMetaData extends AbstractBlurDatabaseMetaData {
           tables = client.tableList();
           for (String table : tables) {
             TableDescriptor descriptor = client.describe(table);
-            if (descriptor.isEnabled) {
+            if (descriptor.isEnabled()) {
               schemaMap.put(table, client.schema(table));
             }
           }

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/blur-shell/src/main/java/org/apache/blur/shell/DescribeTableCommand.java
----------------------------------------------------------------------
diff --git a/blur-shell/src/main/java/org/apache/blur/shell/DescribeTableCommand.java b/blur-shell/src/main/java/org/apache/blur/shell/DescribeTableCommand.java
index d7a1a3b..0a59cc8 100644
--- a/blur-shell/src/main/java/org/apache/blur/shell/DescribeTableCommand.java
+++ b/blur-shell/src/main/java/org/apache/blur/shell/DescribeTableCommand.java
@@ -37,7 +37,7 @@ public class DescribeTableCommand extends Command {
     TableDescriptor describe = client.describe(tablename);
     out.println("cluster                          : " + describe.cluster);
     out.println("name                             : " + describe.name);
-    out.println("enabled                          : " + describe.isEnabled);
+    out.println("enabled                          : " + describe.enabled);
     out.println("tableUri                         : " + describe.tableUri);
     out.println("shardCount                       : " + describe.shardCount);
     out.println("readOnly                         : " + describe.readOnly);

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/blur-shell/src/main/java/org/apache/blur/shell/TruncateTableCommand.java
----------------------------------------------------------------------
diff --git a/blur-shell/src/main/java/org/apache/blur/shell/TruncateTableCommand.java b/blur-shell/src/main/java/org/apache/blur/shell/TruncateTableCommand.java
index 2b5e7b8..807f8b9 100644
--- a/blur-shell/src/main/java/org/apache/blur/shell/TruncateTableCommand.java
+++ b/blur-shell/src/main/java/org/apache/blur/shell/TruncateTableCommand.java
@@ -40,7 +40,7 @@ public class TruncateTableCommand extends Command {
       return;
     }
     TableDescriptor tableDescriptor = client.describe(tablename);
-    if (tableDescriptor.isIsEnabled()) {
+    if (tableDescriptor.isEnabled()) {
       out.println("Disabling table.");
       out.flush();
       client.disableTable(tablename);

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/blur-thrift/src/main/java/org/apache/blur/thrift/generated/Blur.java
----------------------------------------------------------------------
diff --git a/blur-thrift/src/main/java/org/apache/blur/thrift/generated/Blur.java b/blur-thrift/src/main/java/org/apache/blur/thrift/generated/Blur.java
index 53c3634..360f8b2 100644
--- a/blur-thrift/src/main/java/org/apache/blur/thrift/generated/Blur.java
+++ b/blur-thrift/src/main/java/org/apache/blur/thrift/generated/Blur.java
@@ -184,59 +184,74 @@ public class Blur {
     public BlurQueryStatus queryStatusById(String table, long uuid) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Gets the schema for a given table.
+     * @return Schema.
      * 
-     * 
-     * @param table
+     * @param table the table name.
      */
     public Schema schema(String table) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Gets the table stats for the given table.
+     * @return TableStats.
      * 
-     * 
-     * @param table
+     * @param table the table name.
      */
     public TableStats tableStats(String table) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Gets the terms list from the index for the given table, family, column using the
+     * startWith value to page through the results.  This method only makes sense to use with
+     * string and text field types.
+     * @return the list of terms for the given column.
+     * 
+     * @param table the table name.
+     * 
+     * @param columnFamily the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     * 
+     * @param columnName the column name.
      * 
+     * @param startWith the term to start with assuming that you paging through the term list.
      * 
-     * @param table
-     * @param columnFamily
-     * @param columnName
-     * @param startWith
-     * @param size
+     * @param size the number to fetch at once.
      */
     public List<String> terms(String table, String columnFamily, String columnName, String startWith, short size) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Gets the record frequency for the provided table, family, column and value.
+     * @return the count for the entire table.
+     * 
+     * @param table the table name.
      * 
+     * @param columnFamily the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
      * 
-     * @param table
-     * @param columnFamily
-     * @param columnName
-     * @param value
+     * @param columnName the column name.
+     * 
+     * @param value the value.
      */
     public long recordFrequency(String table, String columnFamily, String columnName, String value) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Fetches a Row or a Record in the given table with the given Selector.
+     * @return the FetchResult.
      * 
+     * @param table the table name.
      * 
-     * @param table
-     * @param selector
+     * @param selector the Selector to use to fetch the Row or Record.
      */
     public FetchResult fetchRow(String table, Selector selector) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Mutates a Row given the RowMutation the is provided.
      * 
-     * 
-     * @param mutation
+     * @param mutation the RowMutation.
      */
     public void mutate(RowMutation mutation) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Mutates a group of Rows given the list of RowMutations that are provided.  Note: This is not an atomic operation.
      * 
-     * 
-     * @param mutations
+     * @param mutations the batch of RowMutations.
      */
     public void mutateBatch(List<RowMutation> mutations) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
@@ -249,7 +264,6 @@ public class Blur {
 
     /**
      * Enables the given table, blocking until all shards are online.
-     * @param table
      * 
      * @param table the table name.
      */
@@ -257,7 +271,6 @@ public class Blur {
 
     /**
      * Disables the given table, blocking until all shards are offline.
-     * @param table the table name.
      * 
      * @param table the table name.
      */
@@ -14058,10 +14071,16 @@ public class Blur {
       schemes.put(TupleScheme.class, new schema_argsTupleSchemeFactory());
     }
 
+    /**
+     * the table name.
+     */
     public String table; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the table name.
+       */
       TABLE((short)1, "table");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -14156,10 +14175,16 @@ public class Blur {
       this.table = null;
     }
 
+    /**
+     * the table name.
+     */
     public String getTable() {
       return this.table;
     }
 
+    /**
+     * the table name.
+     */
     public schema_args setTable(String table) {
       this.table = table;
       return this;
@@ -14873,10 +14898,16 @@ public class Blur {
       schemes.put(TupleScheme.class, new tableStats_argsTupleSchemeFactory());
     }
 
+    /**
+     * the table name.
+     */
     public String table; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the table name.
+       */
       TABLE((short)1, "table");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -14971,10 +15002,16 @@ public class Blur {
       this.table = null;
     }
 
+    /**
+     * the table name.
+     */
     public String getTable() {
       return this.table;
     }
 
+    /**
+     * the table name.
+     */
     public tableStats_args setTable(String table) {
       this.table = table;
       return this;
@@ -15692,18 +15729,48 @@ public class Blur {
       schemes.put(TupleScheme.class, new terms_argsTupleSchemeFactory());
     }
 
+    /**
+     * the table name.
+     */
     public String table; // required
+    /**
+     * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     */
     public String columnFamily; // required
+    /**
+     * the column name.
+     */
     public String columnName; // required
+    /**
+     * the term to start with assuming that you paging through the term list.
+     */
     public String startWith; // required
+    /**
+     * the number to fetch at once.
+     */
     public short size; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the table name.
+       */
       TABLE((short)1, "table"),
+      /**
+       * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+       */
       COLUMN_FAMILY((short)2, "columnFamily"),
+      /**
+       * the column name.
+       */
       COLUMN_NAME((short)3, "columnName"),
+      /**
+       * the term to start with assuming that you paging through the term list.
+       */
       START_WITH((short)4, "startWith"),
+      /**
+       * the number to fetch at once.
+       */
       SIZE((short)5, "size");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -15841,10 +15908,16 @@ public class Blur {
       this.size = 0;
     }
 
+    /**
+     * the table name.
+     */
     public String getTable() {
       return this.table;
     }
 
+    /**
+     * the table name.
+     */
     public terms_args setTable(String table) {
       this.table = table;
       return this;
@@ -15865,10 +15938,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     */
     public String getColumnFamily() {
       return this.columnFamily;
     }
 
+    /**
+     * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     */
     public terms_args setColumnFamily(String columnFamily) {
       this.columnFamily = columnFamily;
       return this;
@@ -15889,10 +15968,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the column name.
+     */
     public String getColumnName() {
       return this.columnName;
     }
 
+    /**
+     * the column name.
+     */
     public terms_args setColumnName(String columnName) {
       this.columnName = columnName;
       return this;
@@ -15913,10 +15998,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the term to start with assuming that you paging through the term list.
+     */
     public String getStartWith() {
       return this.startWith;
     }
 
+    /**
+     * the term to start with assuming that you paging through the term list.
+     */
     public terms_args setStartWith(String startWith) {
       this.startWith = startWith;
       return this;
@@ -15937,10 +16028,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the number to fetch at once.
+     */
     public short getSize() {
       return this.size;
     }
 
+    /**
+     * the number to fetch at once.
+     */
     public terms_args setSize(short size) {
       this.size = size;
       setSizeIsSet(true);
@@ -16951,16 +17048,40 @@ public class Blur {
       schemes.put(TupleScheme.class, new recordFrequency_argsTupleSchemeFactory());
     }
 
+    /**
+     * the table name.
+     */
     public String table; // required
+    /**
+     * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     */
     public String columnFamily; // required
+    /**
+     * the column name.
+     */
     public String columnName; // required
+    /**
+     * the value.
+     */
     public String value; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the table name.
+       */
       TABLE((short)1, "table"),
+      /**
+       * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+       */
       COLUMN_FAMILY((short)2, "columnFamily"),
+      /**
+       * the column name.
+       */
       COLUMN_NAME((short)3, "columnName"),
+      /**
+       * the value.
+       */
       VALUE((short)4, "value");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -17085,10 +17206,16 @@ public class Blur {
       this.value = null;
     }
 
+    /**
+     * the table name.
+     */
     public String getTable() {
       return this.table;
     }
 
+    /**
+     * the table name.
+     */
     public recordFrequency_args setTable(String table) {
       this.table = table;
       return this;
@@ -17109,10 +17236,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     */
     public String getColumnFamily() {
       return this.columnFamily;
     }
 
+    /**
+     * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     */
     public recordFrequency_args setColumnFamily(String columnFamily) {
       this.columnFamily = columnFamily;
       return this;
@@ -17133,10 +17266,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the column name.
+     */
     public String getColumnName() {
       return this.columnName;
     }
 
+    /**
+     * the column name.
+     */
     public recordFrequency_args setColumnName(String columnName) {
       this.columnName = columnName;
       return this;
@@ -17157,10 +17296,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the value.
+     */
     public String getValue() {
       return this.value;
     }
 
+    /**
+     * the value.
+     */
     public recordFrequency_args setValue(String value) {
       this.value = value;
       return this;
@@ -18059,12 +18204,24 @@ public class Blur {
       schemes.put(TupleScheme.class, new fetchRow_argsTupleSchemeFactory());
     }
 
+    /**
+     * the table name.
+     */
     public String table; // required
+    /**
+     * the Selector to use to fetch the Row or Record.
+     */
     public Selector selector; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the table name.
+       */
       TABLE((short)1, "table"),
+      /**
+       * the Selector to use to fetch the Row or Record.
+       */
       SELECTOR((short)2, "selector");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -18169,10 +18326,16 @@ public class Blur {
       this.selector = null;
     }
 
+    /**
+     * the table name.
+     */
     public String getTable() {
       return this.table;
     }
 
+    /**
+     * the table name.
+     */
     public fetchRow_args setTable(String table) {
       this.table = table;
       return this;
@@ -18193,10 +18356,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the Selector to use to fetch the Row or Record.
+     */
     public Selector getSelector() {
       return this.selector;
     }
 
+    /**
+     * the Selector to use to fetch the Row or Record.
+     */
     public fetchRow_args setSelector(Selector selector) {
       this.selector = selector;
       return this;
@@ -18978,10 +19147,16 @@ public class Blur {
       schemes.put(TupleScheme.class, new mutate_argsTupleSchemeFactory());
     }
 
+    /**
+     * the RowMutation.
+     */
     public RowMutation mutation; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the RowMutation.
+       */
       MUTATION((short)1, "mutation");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -19076,10 +19251,16 @@ public class Blur {
       this.mutation = null;
     }
 
+    /**
+     * the RowMutation.
+     */
     public RowMutation getMutation() {
       return this.mutation;
     }
 
+    /**
+     * the RowMutation.
+     */
     public mutate_args setMutation(RowMutation mutation) {
       this.mutation = mutation;
       return this;
@@ -19693,10 +19874,16 @@ public class Blur {
       schemes.put(TupleScheme.class, new mutateBatch_argsTupleSchemeFactory());
     }
 
+    /**
+     * the batch of RowMutations.
+     */
     public List<RowMutation> mutations; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the batch of RowMutations.
+       */
       MUTATIONS((short)1, "mutations");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -19811,10 +19998,16 @@ public class Blur {
       this.mutations.add(elem);
     }
 
+    /**
+     * the batch of RowMutations.
+     */
     public List<RowMutation> getMutations() {
       return this.mutations;
     }
 
+    /**
+     * the batch of RowMutations.
+     */
     public mutateBatch_args setMutations(List<RowMutation> mutations) {
       this.mutations = mutations;
       return this;

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/blur-thrift/src/main/java/org/apache/blur/thrift/generated/ColumnDefinition.java
----------------------------------------------------------------------
diff --git a/blur-thrift/src/main/java/org/apache/blur/thrift/generated/ColumnDefinition.java b/blur-thrift/src/main/java/org/apache/blur/thrift/generated/ColumnDefinition.java
index 90042e2..15f9248 100644
--- a/blur-thrift/src/main/java/org/apache/blur/thrift/generated/ColumnDefinition.java
+++ b/blur-thrift/src/main/java/org/apache/blur/thrift/generated/ColumnDefinition.java
@@ -49,6 +49,9 @@ import java.util.Arrays;
 //import org.slf4j.Logger;
 //import org.slf4j.LoggerFactory;
 
+/**
+ * The ColumnDefinition defines how a given Column should be interpreted (indexed/stored)
+ */
 public class ColumnDefinition implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<ColumnDefinition, ColumnDefinition._Fields>, java.io.Serializable, Cloneable {
   private static final org.apache.blur.thirdparty.thrift_0_9_0.protocol.TStruct STRUCT_DESC = new org.apache.blur.thirdparty.thrift_0_9_0.protocol.TStruct("ColumnDefinition");
 

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/blur-thrift/src/main/java/org/apache/blur/thrift/generated/Metric.java
----------------------------------------------------------------------
diff --git a/blur-thrift/src/main/java/org/apache/blur/thrift/generated/Metric.java b/blur-thrift/src/main/java/org/apache/blur/thrift/generated/Metric.java
index b864754..35470eb 100644
--- a/blur-thrift/src/main/java/org/apache/blur/thrift/generated/Metric.java
+++ b/blur-thrift/src/main/java/org/apache/blur/thrift/generated/Metric.java
@@ -49,6 +49,9 @@ import java.util.Arrays;
 //import org.slf4j.Logger;
 //import org.slf4j.LoggerFactory;
 
+/**
+ * The Metric will hold all the information for a given Metric.
+ */
 public class Metric implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<Metric, Metric._Fields>, java.io.Serializable, Cloneable {
   private static final org.apache.blur.thirdparty.thrift_0_9_0.protocol.TStruct STRUCT_DESC = new org.apache.blur.thirdparty.thrift_0_9_0.protocol.TStruct("Metric");
 
@@ -63,16 +66,40 @@ public class Metric implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<Met
     schemes.put(TupleScheme.class, new MetricTupleSchemeFactory());
   }
 
+  /**
+   * metric name.
+   */
   public String name; // required
+  /**
+   * map of string values emitted by the Metric.
+   */
   public Map<String,String> strMap; // required
+  /**
+   * map of long values emitted by the Metric.
+   */
   public Map<String,Long> longMap; // required
+  /**
+   * map of double values emitted by the Metric.
+   */
   public Map<String,Double> doubleMap; // required
 
   /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
   public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+    /**
+     * metric name.
+     */
     NAME((short)1, "name"),
+    /**
+     * map of string values emitted by the Metric.
+     */
     STR_MAP((short)2, "strMap"),
+    /**
+     * map of long values emitted by the Metric.
+     */
     LONG_MAP((short)3, "longMap"),
+    /**
+     * map of double values emitted by the Metric.
+     */
     DOUBLE_MAP((short)4, "doubleMap");
 
     private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -239,10 +266,16 @@ public class Metric implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<Met
     this.doubleMap = null;
   }
 
+  /**
+   * metric name.
+   */
   public String getName() {
     return this.name;
   }
 
+  /**
+   * metric name.
+   */
   public Metric setName(String name) {
     this.name = name;
     return this;
@@ -274,10 +307,16 @@ public class Metric implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<Met
     this.strMap.put(key, val);
   }
 
+  /**
+   * map of string values emitted by the Metric.
+   */
   public Map<String,String> getStrMap() {
     return this.strMap;
   }
 
+  /**
+   * map of string values emitted by the Metric.
+   */
   public Metric setStrMap(Map<String,String> strMap) {
     this.strMap = strMap;
     return this;
@@ -309,10 +348,16 @@ public class Metric implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<Met
     this.longMap.put(key, val);
   }
 
+  /**
+   * map of long values emitted by the Metric.
+   */
   public Map<String,Long> getLongMap() {
     return this.longMap;
   }
 
+  /**
+   * map of long values emitted by the Metric.
+   */
   public Metric setLongMap(Map<String,Long> longMap) {
     this.longMap = longMap;
     return this;
@@ -344,10 +389,16 @@ public class Metric implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<Met
     this.doubleMap.put(key, val);
   }
 
+  /**
+   * map of double values emitted by the Metric.
+   */
   public Map<String,Double> getDoubleMap() {
     return this.doubleMap;
   }
 
+  /**
+   * map of double values emitted by the Metric.
+   */
   public Metric setDoubleMap(Map<String,Double> doubleMap) {
     this.doubleMap = doubleMap;
     return this;

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/blur-thrift/src/main/java/org/apache/blur/thrift/generated/TableDescriptor.java
----------------------------------------------------------------------
diff --git a/blur-thrift/src/main/java/org/apache/blur/thrift/generated/TableDescriptor.java b/blur-thrift/src/main/java/org/apache/blur/thrift/generated/TableDescriptor.java
index ae38978..4078631 100644
--- a/blur-thrift/src/main/java/org/apache/blur/thrift/generated/TableDescriptor.java
+++ b/blur-thrift/src/main/java/org/apache/blur/thrift/generated/TableDescriptor.java
@@ -50,12 +50,12 @@ import java.util.Arrays;
 //import org.slf4j.LoggerFactory;
 
 /**
- * 
+ * The table descriptor defines the base structure of the table as well as properties need for setup.
  */
 public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<TableDescriptor, TableDescriptor._Fields>, java.io.Serializable, Cloneable {
   private static final org.apache.blur.thirdparty.thrift_0_9_0.protocol.TStruct STRUCT_DESC = new org.apache.blur.thirdparty.thrift_0_9_0.protocol.TStruct("TableDescriptor");
 
-  private static final org.apache.blur.thirdparty.thrift_0_9_0.protocol.TField IS_ENABLED_FIELD_DESC = new org.apache.blur.thirdparty.thrift_0_9_0.protocol.TField("isEnabled", org.apache.blur.thirdparty.thrift_0_9_0.protocol.TType.BOOL, (short)1);
+  private static final org.apache.blur.thirdparty.thrift_0_9_0.protocol.TField ENABLED_FIELD_DESC = new org.apache.blur.thirdparty.thrift_0_9_0.protocol.TField("enabled", org.apache.blur.thirdparty.thrift_0_9_0.protocol.TType.BOOL, (short)1);
   private static final org.apache.blur.thirdparty.thrift_0_9_0.protocol.TField SHARD_COUNT_FIELD_DESC = new org.apache.blur.thirdparty.thrift_0_9_0.protocol.TField("shardCount", org.apache.blur.thirdparty.thrift_0_9_0.protocol.TType.I32, (short)3);
   private static final org.apache.blur.thirdparty.thrift_0_9_0.protocol.TField TABLE_URI_FIELD_DESC = new org.apache.blur.thirdparty.thrift_0_9_0.protocol.TField("tableUri", org.apache.blur.thirdparty.thrift_0_9_0.protocol.TType.STRING, (short)4);
   private static final org.apache.blur.thirdparty.thrift_0_9_0.protocol.TField CLUSTER_FIELD_DESC = new org.apache.blur.thirdparty.thrift_0_9_0.protocol.TField("cluster", org.apache.blur.thirdparty.thrift_0_9_0.protocol.TType.STRING, (short)7);
@@ -80,7 +80,7 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
   /**
    * Is the table enabled or not, enabled by default.
    */
-  public boolean isEnabled; // required
+  public boolean enabled; // required
   /**
    * The number of shards within the given table.
    */
@@ -144,7 +144,7 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
     /**
      * Is the table enabled or not, enabled by default.
      */
-    IS_ENABLED((short)1, "isEnabled"),
+    ENABLED((short)1, "enabled"),
     /**
      * The number of shards within the given table.
      */
@@ -216,8 +216,8 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
      */
     public static _Fields findByThriftId(int fieldId) {
       switch(fieldId) {
-        case 1: // IS_ENABLED
-          return IS_ENABLED;
+        case 1: // ENABLED
+          return ENABLED;
         case 3: // SHARD_COUNT
           return SHARD_COUNT;
         case 4: // TABLE_URI
@@ -286,7 +286,7 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
   }
 
   // isset id assignments
-  private static final int __ISENABLED_ISSET_ID = 0;
+  private static final int __ENABLED_ISSET_ID = 0;
   private static final int __SHARDCOUNT_ISSET_ID = 1;
   private static final int __BLOCKCACHING_ISSET_ID = 2;
   private static final int __READONLY_ISSET_ID = 3;
@@ -296,7 +296,7 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
   public static final Map<_Fields, org.apache.blur.thirdparty.thrift_0_9_0.meta_data.FieldMetaData> metaDataMap;
   static {
     Map<_Fields, org.apache.blur.thirdparty.thrift_0_9_0.meta_data.FieldMetaData> tmpMap = new EnumMap<_Fields, org.apache.blur.thirdparty.thrift_0_9_0.meta_data.FieldMetaData>(_Fields.class);
-    tmpMap.put(_Fields.IS_ENABLED, new org.apache.blur.thirdparty.thrift_0_9_0.meta_data.FieldMetaData("isEnabled", org.apache.blur.thirdparty.thrift_0_9_0.TFieldRequirementType.DEFAULT, 
+    tmpMap.put(_Fields.ENABLED, new org.apache.blur.thirdparty.thrift_0_9_0.meta_data.FieldMetaData("enabled", org.apache.blur.thirdparty.thrift_0_9_0.TFieldRequirementType.DEFAULT, 
         new org.apache.blur.thirdparty.thrift_0_9_0.meta_data.FieldValueMetaData(org.apache.blur.thirdparty.thrift_0_9_0.protocol.TType.BOOL)));
     tmpMap.put(_Fields.SHARD_COUNT, new org.apache.blur.thirdparty.thrift_0_9_0.meta_data.FieldMetaData("shardCount", org.apache.blur.thirdparty.thrift_0_9_0.TFieldRequirementType.DEFAULT, 
         new org.apache.blur.thirdparty.thrift_0_9_0.meta_data.FieldValueMetaData(org.apache.blur.thirdparty.thrift_0_9_0.protocol.TType.I32)));
@@ -337,7 +337,7 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
   }
 
   public TableDescriptor() {
-    this.isEnabled = true;
+    this.enabled = true;
 
     this.shardCount = 1;
 
@@ -356,7 +356,7 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
   }
 
   public TableDescriptor(
-    boolean isEnabled,
+    boolean enabled,
     int shardCount,
     String tableUri,
     String cluster,
@@ -373,8 +373,8 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
     Map<String,String> defaultMissingFieldProps)
   {
     this();
-    this.isEnabled = isEnabled;
-    setIsEnabledIsSet(true);
+    this.enabled = enabled;
+    setEnabledIsSet(true);
     this.shardCount = shardCount;
     setShardCountIsSet(true);
     this.tableUri = tableUri;
@@ -401,7 +401,7 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
    */
   public TableDescriptor(TableDescriptor other) {
     __isset_bitfield = other.__isset_bitfield;
-    this.isEnabled = other.isEnabled;
+    this.enabled = other.enabled;
     this.shardCount = other.shardCount;
     if (other.isSetTableUri()) {
       this.tableUri = other.tableUri;
@@ -474,7 +474,7 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
 
   @Override
   public void clear() {
-    this.isEnabled = true;
+    this.enabled = true;
 
     this.shardCount = 1;
 
@@ -502,30 +502,30 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
   /**
    * Is the table enabled or not, enabled by default.
    */
-  public boolean isIsEnabled() {
-    return this.isEnabled;
+  public boolean isEnabled() {
+    return this.enabled;
   }
 
   /**
    * Is the table enabled or not, enabled by default.
    */
-  public TableDescriptor setIsEnabled(boolean isEnabled) {
-    this.isEnabled = isEnabled;
-    setIsEnabledIsSet(true);
+  public TableDescriptor setEnabled(boolean enabled) {
+    this.enabled = enabled;
+    setEnabledIsSet(true);
     return this;
   }
 
-  public void unsetIsEnabled() {
-    __isset_bitfield = EncodingUtils.clearBit(__isset_bitfield, __ISENABLED_ISSET_ID);
+  public void unsetEnabled() {
+    __isset_bitfield = EncodingUtils.clearBit(__isset_bitfield, __ENABLED_ISSET_ID);
   }
 
-  /** Returns true if field isEnabled is set (has been assigned a value) and false otherwise */
-  public boolean isSetIsEnabled() {
-    return EncodingUtils.testBit(__isset_bitfield, __ISENABLED_ISSET_ID);
+  /** Returns true if field enabled is set (has been assigned a value) and false otherwise */
+  public boolean isSetEnabled() {
+    return EncodingUtils.testBit(__isset_bitfield, __ENABLED_ISSET_ID);
   }
 
-  public void setIsEnabledIsSet(boolean value) {
-    __isset_bitfield = EncodingUtils.setBit(__isset_bitfield, __ISENABLED_ISSET_ID, value);
+  public void setEnabledIsSet(boolean value) {
+    __isset_bitfield = EncodingUtils.setBit(__isset_bitfield, __ENABLED_ISSET_ID, value);
   }
 
   /**
@@ -999,11 +999,11 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
 
   public void setFieldValue(_Fields field, Object value) {
     switch (field) {
-    case IS_ENABLED:
+    case ENABLED:
       if (value == null) {
-        unsetIsEnabled();
+        unsetEnabled();
       } else {
-        setIsEnabled((Boolean)value);
+        setEnabled((Boolean)value);
       }
       break;
 
@@ -1124,8 +1124,8 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
 
   public Object getFieldValue(_Fields field) {
     switch (field) {
-    case IS_ENABLED:
-      return Boolean.valueOf(isIsEnabled());
+    case ENABLED:
+      return Boolean.valueOf(isEnabled());
 
     case SHARD_COUNT:
       return Integer.valueOf(getShardCount());
@@ -1180,8 +1180,8 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
     }
 
     switch (field) {
-    case IS_ENABLED:
-      return isSetIsEnabled();
+    case ENABLED:
+      return isSetEnabled();
     case SHARD_COUNT:
       return isSetShardCount();
     case TABLE_URI:
@@ -1227,12 +1227,12 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
     if (that == null)
       return false;
 
-    boolean this_present_isEnabled = true;
-    boolean that_present_isEnabled = true;
-    if (this_present_isEnabled || that_present_isEnabled) {
-      if (!(this_present_isEnabled && that_present_isEnabled))
+    boolean this_present_enabled = true;
+    boolean that_present_enabled = true;
+    if (this_present_enabled || that_present_enabled) {
+      if (!(this_present_enabled && that_present_enabled))
         return false;
-      if (this.isEnabled != that.isEnabled)
+      if (this.enabled != that.enabled)
         return false;
     }
 
@@ -1378,12 +1378,12 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
     int lastComparison = 0;
     TableDescriptor typedOther = (TableDescriptor)other;
 
-    lastComparison = Boolean.valueOf(isSetIsEnabled()).compareTo(typedOther.isSetIsEnabled());
+    lastComparison = Boolean.valueOf(isSetEnabled()).compareTo(typedOther.isSetEnabled());
     if (lastComparison != 0) {
       return lastComparison;
     }
-    if (isSetIsEnabled()) {
-      lastComparison = org.apache.blur.thirdparty.thrift_0_9_0.TBaseHelper.compareTo(this.isEnabled, typedOther.isEnabled);
+    if (isSetEnabled()) {
+      lastComparison = org.apache.blur.thirdparty.thrift_0_9_0.TBaseHelper.compareTo(this.enabled, typedOther.enabled);
       if (lastComparison != 0) {
         return lastComparison;
       }
@@ -1548,8 +1548,8 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
     StringBuilder sb = new StringBuilder("TableDescriptor(");
     boolean first = true;
 
-    sb.append("isEnabled:");
-    sb.append(this.isEnabled);
+    sb.append("enabled:");
+    sb.append(this.enabled);
     first = false;
     if (!first) sb.append(", ");
     sb.append("shardCount:");
@@ -1688,10 +1688,10 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
           break;
         }
         switch (schemeField.id) {
-          case 1: // IS_ENABLED
+          case 1: // ENABLED
             if (schemeField.type == org.apache.blur.thirdparty.thrift_0_9_0.protocol.TType.BOOL) {
-              struct.isEnabled = iprot.readBool();
-              struct.setIsEnabledIsSet(true);
+              struct.enabled = iprot.readBool();
+              struct.setEnabledIsSet(true);
             } else { 
               org.apache.blur.thirdparty.thrift_0_9_0.protocol.TProtocolUtil.skip(iprot, schemeField.type);
             }
@@ -1867,8 +1867,8 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
       struct.validate();
 
       oprot.writeStructBegin(STRUCT_DESC);
-      oprot.writeFieldBegin(IS_ENABLED_FIELD_DESC);
-      oprot.writeBool(struct.isEnabled);
+      oprot.writeFieldBegin(ENABLED_FIELD_DESC);
+      oprot.writeBool(struct.enabled);
       oprot.writeFieldEnd();
       oprot.writeFieldBegin(SHARD_COUNT_FIELD_DESC);
       oprot.writeI32(struct.shardCount);
@@ -1978,7 +1978,7 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
     public void write(org.apache.blur.thirdparty.thrift_0_9_0.protocol.TProtocol prot, TableDescriptor struct) throws org.apache.blur.thirdparty.thrift_0_9_0.TException {
       TTupleProtocol oprot = (TTupleProtocol) prot;
       BitSet optionals = new BitSet();
-      if (struct.isSetIsEnabled()) {
+      if (struct.isSetEnabled()) {
         optionals.set(0);
       }
       if (struct.isSetShardCount()) {
@@ -2024,8 +2024,8 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
         optionals.set(14);
       }
       oprot.writeBitSet(optionals, 15);
-      if (struct.isSetIsEnabled()) {
-        oprot.writeBool(struct.isEnabled);
+      if (struct.isSetEnabled()) {
+        oprot.writeBool(struct.enabled);
       }
       if (struct.isSetShardCount()) {
         oprot.writeI32(struct.shardCount);
@@ -2102,8 +2102,8 @@ public class TableDescriptor implements org.apache.blur.thirdparty.thrift_0_9_0.
       TTupleProtocol iprot = (TTupleProtocol) prot;
       BitSet incoming = iprot.readBitSet(15);
       if (incoming.get(0)) {
-        struct.isEnabled = iprot.readBool();
-        struct.setIsEnabledIsSet(true);
+        struct.enabled = iprot.readBool();
+        struct.setEnabledIsSet(true);
       }
       if (incoming.get(1)) {
         struct.shardCount = iprot.readI32();

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/blur-thrift/src/main/java/org/apache/blur/thrift/util/CreateInsertQueryRepeating.java
----------------------------------------------------------------------
diff --git a/blur-thrift/src/main/java/org/apache/blur/thrift/util/CreateInsertQueryRepeating.java b/blur-thrift/src/main/java/org/apache/blur/thrift/util/CreateInsertQueryRepeating.java
index 0741eef..a51f281 100644
--- a/blur-thrift/src/main/java/org/apache/blur/thrift/util/CreateInsertQueryRepeating.java
+++ b/blur-thrift/src/main/java/org/apache/blur/thrift/util/CreateInsertQueryRepeating.java
@@ -111,7 +111,7 @@ public class CreateInsertQueryRepeating {
     // TODO: doc doesnt say required, yet it barfs without it?
     td.cluster = cluster == null ? "default" : cluster;
     // auto enable table
-    td.isEnabled = true;
+    td.enabled = true;
 
     // 1 shard per server :)
     td.shardCount = client.shardServerList(cluster).size();

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/distribution/src/main/scripts/interface/Blur.thrift
----------------------------------------------------------------------
diff --git a/distribution/src/main/scripts/interface/Blur.thrift b/distribution/src/main/scripts/interface/Blur.thrift
index c5e3419..8ae2d99 100644
--- a/distribution/src/main/scripts/interface/Blur.thrift
+++ b/distribution/src/main/scripts/interface/Blur.thrift
@@ -584,13 +584,13 @@ struct Schema {
 }
 
 /**
- *
+ * The table descriptor defines the base structure of the table as well as properties need for setup.
  */
 struct TableDescriptor {
   /**
    * Is the table enabled or not, enabled by default.
    */
-  1:bool isEnabled = 1,
+  1:bool enabled = 1,
   /**
    * The number of shards within the given table.
    */
@@ -650,13 +650,23 @@ struct TableDescriptor {
   18:map<string,string> defaultMissingFieldProps
 }
 
+/**
+ * The Metric will hold all the information for a given Metric.
+ */
 struct Metric {
+  /** metric name. */
   1:string name,
+  /** map of string values emitted by the Metric. */
   2:map<string,string> strMap,
+  /** map of long values emitted by the Metric. */
   3:map<string,i64> longMap,
+  /** map of double values emitted by the Metric. */
   4:map<string,double> doubleMap
 }
 
+/**
+ * The ColumnDefinition defines how a given Column should be interpreted (indexed/stored)
+ */
 struct ColumnDefinition {
   /**
    * Required. The family the this column existing within.
@@ -834,74 +844,81 @@ service Blur {
   ) throws (1:BlurException ex)
 
   /**
-   *
+   * Gets the schema for a given table.
+   * @return Schema.
    */
   Schema schema(
-    /**   */
+    /** the table name. */
     1:string table
   ) throws (1:BlurException ex)
 
   /**
-   *
+   * Gets the table stats for the given table.
+   * @return TableStats.
    */
   TableStats tableStats(
-    /**   */
+    /** the table name. */
     1:string table
   ) throws (1:BlurException ex)
 
   /**
-   *
+   * Gets the terms list from the index for the given table, family, column using the 
+   * startWith value to page through the results.  This method only makes sense to use with 
+   * string and text field types.
+   * @return the list of terms for the given column.
    */
   list<string> terms(
-    /**   */
+    /** the table name. */
     1:string table, 
-    /**   */
+    /** the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null. */
     2:string columnFamily, 
-    /**   */
-    3:string columnName, 
-    /**   */
+    /** the column name. */
+    3:string columnName,
+    /** the term to start with assuming that you paging through the term list. */
     4:string startWith, 
-    /**   */
+    /** the number to fetch at once. */
     5:i16 size
   ) throws (1:BlurException ex)
 
   /**
-   *
+   * Gets the record frequency for the provided table, family, column and value.
+   * @return the count for the entire table.
    */
   i64 recordFrequency(
-    /**   */
+    /** the table name. */
     1:string table, 
-    /**   */
+    /** the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null. */
     2:string columnFamily, 
-    /**   */
+    /** the column name. */
     3:string columnName, 
-    /**   */
+    /** the value. */
     4:string value
   ) throws (1:BlurException ex)
 
   /**
-   *
+   * Fetches a Row or a Record in the given table with the given Selector.
+   * @return the FetchResult.
    */
   FetchResult fetchRow(
-    /**   */
+    /** the table name. */
     1:string table, 
-    /**   */
+    /** the Selector to use to fetch the Row or Record. */
     2:Selector selector
   ) throws (1:BlurException ex)
 
   /**
-   *
+   * Mutates a Row given the RowMutation the is provided.
    */
   void mutate(
-    /**   */
+    /** the RowMutation.*/
     1:RowMutation mutation
   ) throws (1:BlurException ex)
 
   /**
-   *
+   * Mutates a group of Rows given the list of RowMutations that are provided.  Note: This is not an atomic operation.
    */
   void mutateBatch(
-    /**   */
+    /** the batch of RowMutations.*/
     1:list<RowMutation> mutations
   ) throws (1:BlurException ex)
 
@@ -915,7 +932,6 @@ service Blur {
 
   /**
    * Enables the given table, blocking until all shards are online.
-   * @param table 
    */
   void enableTable(
     /** the table name. */
@@ -924,7 +940,6 @@ service Blur {
 
   /**
    * Disables the given table, blocking until all shards are offline.
-   * @param table the table name.
    */
   void disableTable(
     /** the table name. */

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/distribution/src/main/scripts/interface/gen-html/Blur.html
----------------------------------------------------------------------
diff --git a/distribution/src/main/scripts/interface/gen-html/Blur.html b/distribution/src/main/scripts/interface/gen-html/Blur.html
index a5c105c..d95ddcb 100644
--- a/distribution/src/main/scripts/interface/gen-html/Blur.html
+++ b/distribution/src/main/scripts/interface/gen-html/Blur.html
@@ -403,7 +403,7 @@ shards that are complete, etc.
 </table><br/><p/>
 <br/></div><div class="definition"><h3 id="Struct_TableDescriptor">Struct: TableDescriptor</h3>
 <table class="table-bordered table-striped table-condensed"><thead><th>Key</th><th>Field</th><th>Type</th><th>Description</th><th>Requiredness</th><th>Default value</th></thead>
-<tr><td>1</td><td>isEnabled</td><td><code>bool</code></td><td>Is the table enabled or not, enabled by default.
+<tr><td>1</td><td>enabled</td><td><code>bool</code></td><td>Is the table enabled or not, enabled by default.
 </td><td>default</td><td>1</td></tr>
 <tr><td>3</td><td>shardCount</td><td><code>i32</code></td><td>The number of shards within the given table.
 </td><td>default</td><td>1</td></tr>
@@ -434,14 +434,19 @@ updates through MapReduce are allowed and in fact they are only allowed if the t
 </td><td>default</td><td>1</td></tr>
 <tr><td>18</td><td>defaultMissingFieldProps</td><td><code>map&lt;<code>string</code>, <code>string</code>&gt;</code></td><td>If strict is not enabled, defines the properties to be used in the new field creation.
 </td><td>default</td><td></td></tr>
-</table><br/><p/>
+</table><br/>The table descriptor defines the base structure of the table as well as properties need for setup.
 <br/></div><div class="definition"><h3 id="Struct_Metric">Struct: Metric</h3>
 <table class="table-bordered table-striped table-condensed"><thead><th>Key</th><th>Field</th><th>Type</th><th>Description</th><th>Requiredness</th><th>Default value</th></thead>
-<tr><td>1</td><td>name</td><td><code>string</code></td><td></td><td>default</td><td></td></tr>
-<tr><td>2</td><td>strMap</td><td><code>map&lt;<code>string</code>, <code>string</code>&gt;</code></td><td></td><td>default</td><td></td></tr>
-<tr><td>3</td><td>longMap</td><td><code>map&lt;<code>string</code>, <code>i64</code>&gt;</code></td><td></td><td>default</td><td></td></tr>
-<tr><td>4</td><td>doubleMap</td><td><code>map&lt;<code>string</code>, <code>double</code>&gt;</code></td><td></td><td>default</td><td></td></tr>
-</table><br/></div><div class="definition"><h3 id="Struct_ColumnDefinition">Struct: ColumnDefinition</h3>
+<tr><td>1</td><td>name</td><td><code>string</code></td><td>metric name.
+</td><td>default</td><td></td></tr>
+<tr><td>2</td><td>strMap</td><td><code>map&lt;<code>string</code>, <code>string</code>&gt;</code></td><td>map of string values emitted by the Metric.
+</td><td>default</td><td></td></tr>
+<tr><td>3</td><td>longMap</td><td><code>map&lt;<code>string</code>, <code>i64</code>&gt;</code></td><td>map of long values emitted by the Metric.
+</td><td>default</td><td></td></tr>
+<tr><td>4</td><td>doubleMap</td><td><code>map&lt;<code>string</code>, <code>double</code>&gt;</code></td><td>map of double values emitted by the Metric.
+</td><td>default</td><td></td></tr>
+</table><br/>The Metric will hold all the information for a given Metric.
+<br/></div><div class="definition"><h3 id="Struct_ColumnDefinition">Struct: ColumnDefinition</h3>
 <table class="table-bordered table-striped table-condensed"><thead><th>Key</th><th>Field</th><th>Type</th><th>Description</th><th>Requiredness</th><th>Default value</th></thead>
 <tr><td>1</td><td>family</td><td><code>string</code></td><td>Required. The family the this column existing within.
 </td><td>default</td><td></td></tr>
@@ -465,7 +470,8 @@ NOTE: This will index the column as a full text field in a default field, so tha
 </td><td>default</td><td></td></tr>
 <tr><td>6</td><td>properties</td><td><code>map&lt;<code>string</code>, <code>string</code>&gt;</code></td><td>For any custom field types, you can pass in configuration properties.
 </td><td>default</td><td></td></tr>
-</table><br/></div><hr/><h2 id="Services">Services</h2>
+</table><br/>The ColumnDefinition defines how a given Column should be interpreted (indexed/stored)
+<br/></div><hr/><h2 id="Services">Services</h2>
 <h3 id="Svc_Blur">Service: Blur</h3>
 The Blur service API.  This API is the same for both controller servers as well as
 shards servers.  Each of the methods are documented.
@@ -599,40 +605,84 @@ cancel call maybe take some time for the query actually stops executing.
 </table></div><div class="definition"><h4 id="Fn_Blur_schema">Function: Blur.schema</h4>
 <pre><code><a href="Blur.html#Struct_Schema">Schema</a></code> schema(<code>string</code> table)
     throws <code><a href="Blur.html#Struct_BlurException">BlurException</a></code>
-</pre><p/>
-<br/></div><div class="definition"><h4 id="Fn_Blur_tableStats">Function: Blur.tableStats</h4>
+</pre>Gets the schema for a given table.
+@return Schema.
+<br/><br/><h4 id="Parameters_Blur_schema">Parameters</h4>
+<table class="table-bordered table-striped table-condensed"><thead><th>Name</th><th>Description</th></thead><tr><td>table</td><td>the table name.
+</td></tr>
+</table></div><div class="definition"><h4 id="Fn_Blur_tableStats">Function: Blur.tableStats</h4>
 <pre><code><a href="Blur.html#Struct_TableStats">TableStats</a></code> tableStats(<code>string</code> table)
     throws <code><a href="Blur.html#Struct_BlurException">BlurException</a></code>
-</pre><p/>
-<br/></div><div class="definition"><h4 id="Fn_Blur_terms">Function: Blur.terms</h4>
+</pre>Gets the table stats for the given table.
+@return TableStats.
+<br/><br/><h4 id="Parameters_Blur_tableStats">Parameters</h4>
+<table class="table-bordered table-striped table-condensed"><thead><th>Name</th><th>Description</th></thead><tr><td>table</td><td>the table name.
+</td></tr>
+</table></div><div class="definition"><h4 id="Fn_Blur_terms">Function: Blur.terms</h4>
 <pre><code>list&lt;<code>string</code>&gt;</code> terms(<code>string</code> table,
                    <code>string</code> columnFamily,
                    <code>string</code> columnName,
                    <code>string</code> startWith,
                    <code>i16</code> size)
     throws <code><a href="Blur.html#Struct_BlurException">BlurException</a></code>
-</pre><p/>
-<br/></div><div class="definition"><h4 id="Fn_Blur_recordFrequency">Function: Blur.recordFrequency</h4>
+</pre>Gets the terms list from the index for the given table, family, column using the
+startWith value to page through the results.  This method only makes sense to use with
+string and text field types.
+@return the list of terms for the given column.
+<br/><br/><h4 id="Parameters_Blur_terms">Parameters</h4>
+<table class="table-bordered table-striped table-condensed"><thead><th>Name</th><th>Description</th></thead><tr><td>table</td><td>the table name.
+</td></tr>
+<tr><td>columnFamily</td><td>the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+</td></tr>
+<tr><td>columnName</td><td>the column name.
+</td></tr>
+<tr><td>startWith</td><td>the term to start with assuming that you paging through the term list.
+</td></tr>
+<tr><td>size</td><td>the number to fetch at once.
+</td></tr>
+</table></div><div class="definition"><h4 id="Fn_Blur_recordFrequency">Function: Blur.recordFrequency</h4>
 <pre><code>i64</code> recordFrequency(<code>string</code> table,
                     <code>string</code> columnFamily,
                     <code>string</code> columnName,
                     <code>string</code> value)
     throws <code><a href="Blur.html#Struct_BlurException">BlurException</a></code>
-</pre><p/>
-<br/></div><div class="definition"><h4 id="Fn_Blur_fetchRow">Function: Blur.fetchRow</h4>
+</pre>Gets the record frequency for the provided table, family, column and value.
+@return the count for the entire table.
+<br/><br/><h4 id="Parameters_Blur_recordFrequency">Parameters</h4>
+<table class="table-bordered table-striped table-condensed"><thead><th>Name</th><th>Description</th></thead><tr><td>table</td><td>the table name.
+</td></tr>
+<tr><td>columnFamily</td><td>the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+</td></tr>
+<tr><td>columnName</td><td>the column name.
+</td></tr>
+<tr><td>value</td><td>the value.
+</td></tr>
+</table></div><div class="definition"><h4 id="Fn_Blur_fetchRow">Function: Blur.fetchRow</h4>
 <pre><code><a href="Blur.html#Struct_FetchResult">FetchResult</a></code> fetchRow(<code>string</code> table,
                      <code><a href="Blur.html#Struct_Selector">Selector</a></code> selector)
     throws <code><a href="Blur.html#Struct_BlurException">BlurException</a></code>
-</pre><p/>
-<br/></div><div class="definition"><h4 id="Fn_Blur_mutate">Function: Blur.mutate</h4>
+</pre>Fetches a Row or a Record in the given table with the given Selector.
+@return the FetchResult.
+<br/><br/><h4 id="Parameters_Blur_fetchRow">Parameters</h4>
+<table class="table-bordered table-striped table-condensed"><thead><th>Name</th><th>Description</th></thead><tr><td>table</td><td>the table name.
+</td></tr>
+<tr><td>selector</td><td>the Selector to use to fetch the Row or Record.
+</td></tr>
+</table></div><div class="definition"><h4 id="Fn_Blur_mutate">Function: Blur.mutate</h4>
 <pre><code>void</code> mutate(<code><a href="Blur.html#Struct_RowMutation">RowMutation</a></code> mutation)
     throws <code><a href="Blur.html#Struct_BlurException">BlurException</a></code>
-</pre><p/>
-<br/></div><div class="definition"><h4 id="Fn_Blur_mutateBatch">Function: Blur.mutateBatch</h4>
+</pre>Mutates a Row given the RowMutation the is provided.
+<br/><br/><h4 id="Parameters_Blur_mutate">Parameters</h4>
+<table class="table-bordered table-striped table-condensed"><thead><th>Name</th><th>Description</th></thead><tr><td>mutation</td><td>the RowMutation.
+</td></tr>
+</table></div><div class="definition"><h4 id="Fn_Blur_mutateBatch">Function: Blur.mutateBatch</h4>
 <pre><code>void</code> mutateBatch(<code>list&lt;<code><a href="Blur.html#Struct_RowMutation">RowMutation</a></code>&gt;</code> mutations)
     throws <code><a href="Blur.html#Struct_BlurException">BlurException</a></code>
-</pre><p/>
-<br/></div><div class="definition"><h4 id="Fn_Blur_createTable">Function: Blur.createTable</h4>
+</pre>Mutates a group of Rows given the list of RowMutations that are provided.  Note: This is not an atomic operation.
+<br/><br/><h4 id="Parameters_Blur_mutateBatch">Parameters</h4>
+<table class="table-bordered table-striped table-condensed"><thead><th>Name</th><th>Description</th></thead><tr><td>mutations</td><td>the batch of RowMutations.
+</td></tr>
+</table></div><div class="definition"><h4 id="Fn_Blur_createTable">Function: Blur.createTable</h4>
 <pre><code>void</code> createTable(<code><a href="Blur.html#Struct_TableDescriptor">TableDescriptor</a></code> tableDescriptor)
     throws <code><a href="Blur.html#Struct_BlurException">BlurException</a></code>
 </pre>Creates a table with the given TableDescriptor.
@@ -643,7 +693,6 @@ cancel call maybe take some time for the query actually stops executing.
 <pre><code>void</code> enableTable(<code>string</code> table)
     throws <code><a href="Blur.html#Struct_BlurException">BlurException</a></code>
 </pre>Enables the given table, blocking until all shards are online.
-@param table
 <br/><br/><h4 id="Parameters_Blur_enableTable">Parameters</h4>
 <table class="table-bordered table-striped table-condensed"><thead><th>Name</th><th>Description</th></thead><tr><td>table</td><td>the table name.
 </td></tr>
@@ -651,7 +700,6 @@ cancel call maybe take some time for the query actually stops executing.
 <pre><code>void</code> disableTable(<code>string</code> table)
     throws <code><a href="Blur.html#Struct_BlurException">BlurException</a></code>
 </pre>Disables the given table, blocking until all shards are offline.
-@param table the table name.
 <br/><br/><h4 id="Parameters_Blur_disableTable">Parameters</h4>
 <table class="table-bordered table-striped table-condensed"><thead><th>Name</th><th>Description</th></thead><tr><td>table</td><td>the table name.
 </td></tr>

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/Blur.java
----------------------------------------------------------------------
diff --git a/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/Blur.java b/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/Blur.java
index 53c3634..360f8b2 100644
--- a/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/Blur.java
+++ b/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/Blur.java
@@ -184,59 +184,74 @@ public class Blur {
     public BlurQueryStatus queryStatusById(String table, long uuid) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Gets the schema for a given table.
+     * @return Schema.
      * 
-     * 
-     * @param table
+     * @param table the table name.
      */
     public Schema schema(String table) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Gets the table stats for the given table.
+     * @return TableStats.
      * 
-     * 
-     * @param table
+     * @param table the table name.
      */
     public TableStats tableStats(String table) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Gets the terms list from the index for the given table, family, column using the
+     * startWith value to page through the results.  This method only makes sense to use with
+     * string and text field types.
+     * @return the list of terms for the given column.
+     * 
+     * @param table the table name.
+     * 
+     * @param columnFamily the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     * 
+     * @param columnName the column name.
      * 
+     * @param startWith the term to start with assuming that you paging through the term list.
      * 
-     * @param table
-     * @param columnFamily
-     * @param columnName
-     * @param startWith
-     * @param size
+     * @param size the number to fetch at once.
      */
     public List<String> terms(String table, String columnFamily, String columnName, String startWith, short size) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Gets the record frequency for the provided table, family, column and value.
+     * @return the count for the entire table.
+     * 
+     * @param table the table name.
      * 
+     * @param columnFamily the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
      * 
-     * @param table
-     * @param columnFamily
-     * @param columnName
-     * @param value
+     * @param columnName the column name.
+     * 
+     * @param value the value.
      */
     public long recordFrequency(String table, String columnFamily, String columnName, String value) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Fetches a Row or a Record in the given table with the given Selector.
+     * @return the FetchResult.
      * 
+     * @param table the table name.
      * 
-     * @param table
-     * @param selector
+     * @param selector the Selector to use to fetch the Row or Record.
      */
     public FetchResult fetchRow(String table, Selector selector) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Mutates a Row given the RowMutation the is provided.
      * 
-     * 
-     * @param mutation
+     * @param mutation the RowMutation.
      */
     public void mutate(RowMutation mutation) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
     /**
+     * Mutates a group of Rows given the list of RowMutations that are provided.  Note: This is not an atomic operation.
      * 
-     * 
-     * @param mutations
+     * @param mutations the batch of RowMutations.
      */
     public void mutateBatch(List<RowMutation> mutations) throws BlurException, org.apache.blur.thirdparty.thrift_0_9_0.TException;
 
@@ -249,7 +264,6 @@ public class Blur {
 
     /**
      * Enables the given table, blocking until all shards are online.
-     * @param table
      * 
      * @param table the table name.
      */
@@ -257,7 +271,6 @@ public class Blur {
 
     /**
      * Disables the given table, blocking until all shards are offline.
-     * @param table the table name.
      * 
      * @param table the table name.
      */
@@ -14058,10 +14071,16 @@ public class Blur {
       schemes.put(TupleScheme.class, new schema_argsTupleSchemeFactory());
     }
 
+    /**
+     * the table name.
+     */
     public String table; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the table name.
+       */
       TABLE((short)1, "table");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -14156,10 +14175,16 @@ public class Blur {
       this.table = null;
     }
 
+    /**
+     * the table name.
+     */
     public String getTable() {
       return this.table;
     }
 
+    /**
+     * the table name.
+     */
     public schema_args setTable(String table) {
       this.table = table;
       return this;
@@ -14873,10 +14898,16 @@ public class Blur {
       schemes.put(TupleScheme.class, new tableStats_argsTupleSchemeFactory());
     }
 
+    /**
+     * the table name.
+     */
     public String table; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the table name.
+       */
       TABLE((short)1, "table");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -14971,10 +15002,16 @@ public class Blur {
       this.table = null;
     }
 
+    /**
+     * the table name.
+     */
     public String getTable() {
       return this.table;
     }
 
+    /**
+     * the table name.
+     */
     public tableStats_args setTable(String table) {
       this.table = table;
       return this;
@@ -15692,18 +15729,48 @@ public class Blur {
       schemes.put(TupleScheme.class, new terms_argsTupleSchemeFactory());
     }
 
+    /**
+     * the table name.
+     */
     public String table; // required
+    /**
+     * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     */
     public String columnFamily; // required
+    /**
+     * the column name.
+     */
     public String columnName; // required
+    /**
+     * the term to start with assuming that you paging through the term list.
+     */
     public String startWith; // required
+    /**
+     * the number to fetch at once.
+     */
     public short size; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the table name.
+       */
       TABLE((short)1, "table"),
+      /**
+       * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+       */
       COLUMN_FAMILY((short)2, "columnFamily"),
+      /**
+       * the column name.
+       */
       COLUMN_NAME((short)3, "columnName"),
+      /**
+       * the term to start with assuming that you paging through the term list.
+       */
       START_WITH((short)4, "startWith"),
+      /**
+       * the number to fetch at once.
+       */
       SIZE((short)5, "size");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -15841,10 +15908,16 @@ public class Blur {
       this.size = 0;
     }
 
+    /**
+     * the table name.
+     */
     public String getTable() {
       return this.table;
     }
 
+    /**
+     * the table name.
+     */
     public terms_args setTable(String table) {
       this.table = table;
       return this;
@@ -15865,10 +15938,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     */
     public String getColumnFamily() {
       return this.columnFamily;
     }
 
+    /**
+     * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     */
     public terms_args setColumnFamily(String columnFamily) {
       this.columnFamily = columnFamily;
       return this;
@@ -15889,10 +15968,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the column name.
+     */
     public String getColumnName() {
       return this.columnName;
     }
 
+    /**
+     * the column name.
+     */
     public terms_args setColumnName(String columnName) {
       this.columnName = columnName;
       return this;
@@ -15913,10 +15998,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the term to start with assuming that you paging through the term list.
+     */
     public String getStartWith() {
       return this.startWith;
     }
 
+    /**
+     * the term to start with assuming that you paging through the term list.
+     */
     public terms_args setStartWith(String startWith) {
       this.startWith = startWith;
       return this;
@@ -15937,10 +16028,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the number to fetch at once.
+     */
     public short getSize() {
       return this.size;
     }
 
+    /**
+     * the number to fetch at once.
+     */
     public terms_args setSize(short size) {
       this.size = size;
       setSizeIsSet(true);
@@ -16951,16 +17048,40 @@ public class Blur {
       schemes.put(TupleScheme.class, new recordFrequency_argsTupleSchemeFactory());
     }
 
+    /**
+     * the table name.
+     */
     public String table; // required
+    /**
+     * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     */
     public String columnFamily; // required
+    /**
+     * the column name.
+     */
     public String columnName; // required
+    /**
+     * the value.
+     */
     public String value; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the table name.
+       */
       TABLE((short)1, "table"),
+      /**
+       * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+       */
       COLUMN_FAMILY((short)2, "columnFamily"),
+      /**
+       * the column name.
+       */
       COLUMN_NAME((short)3, "columnName"),
+      /**
+       * the value.
+       */
       VALUE((short)4, "value");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -17085,10 +17206,16 @@ public class Blur {
       this.value = null;
     }
 
+    /**
+     * the table name.
+     */
     public String getTable() {
       return this.table;
     }
 
+    /**
+     * the table name.
+     */
     public recordFrequency_args setTable(String table) {
       this.table = table;
       return this;
@@ -17109,10 +17236,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     */
     public String getColumnFamily() {
       return this.columnFamily;
     }
 
+    /**
+     * the column family. If the frequency requested is a system field like "rowid", "recordid", "family", etc then columnFamily can be null.
+     */
     public recordFrequency_args setColumnFamily(String columnFamily) {
       this.columnFamily = columnFamily;
       return this;
@@ -17133,10 +17266,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the column name.
+     */
     public String getColumnName() {
       return this.columnName;
     }
 
+    /**
+     * the column name.
+     */
     public recordFrequency_args setColumnName(String columnName) {
       this.columnName = columnName;
       return this;
@@ -17157,10 +17296,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the value.
+     */
     public String getValue() {
       return this.value;
     }
 
+    /**
+     * the value.
+     */
     public recordFrequency_args setValue(String value) {
       this.value = value;
       return this;
@@ -18059,12 +18204,24 @@ public class Blur {
       schemes.put(TupleScheme.class, new fetchRow_argsTupleSchemeFactory());
     }
 
+    /**
+     * the table name.
+     */
     public String table; // required
+    /**
+     * the Selector to use to fetch the Row or Record.
+     */
     public Selector selector; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the table name.
+       */
       TABLE((short)1, "table"),
+      /**
+       * the Selector to use to fetch the Row or Record.
+       */
       SELECTOR((short)2, "selector");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -18169,10 +18326,16 @@ public class Blur {
       this.selector = null;
     }
 
+    /**
+     * the table name.
+     */
     public String getTable() {
       return this.table;
     }
 
+    /**
+     * the table name.
+     */
     public fetchRow_args setTable(String table) {
       this.table = table;
       return this;
@@ -18193,10 +18356,16 @@ public class Blur {
       }
     }
 
+    /**
+     * the Selector to use to fetch the Row or Record.
+     */
     public Selector getSelector() {
       return this.selector;
     }
 
+    /**
+     * the Selector to use to fetch the Row or Record.
+     */
     public fetchRow_args setSelector(Selector selector) {
       this.selector = selector;
       return this;
@@ -18978,10 +19147,16 @@ public class Blur {
       schemes.put(TupleScheme.class, new mutate_argsTupleSchemeFactory());
     }
 
+    /**
+     * the RowMutation.
+     */
     public RowMutation mutation; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the RowMutation.
+       */
       MUTATION((short)1, "mutation");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -19076,10 +19251,16 @@ public class Blur {
       this.mutation = null;
     }
 
+    /**
+     * the RowMutation.
+     */
     public RowMutation getMutation() {
       return this.mutation;
     }
 
+    /**
+     * the RowMutation.
+     */
     public mutate_args setMutation(RowMutation mutation) {
       this.mutation = mutation;
       return this;
@@ -19693,10 +19874,16 @@ public class Blur {
       schemes.put(TupleScheme.class, new mutateBatch_argsTupleSchemeFactory());
     }
 
+    /**
+     * the batch of RowMutations.
+     */
     public List<RowMutation> mutations; // required
 
     /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
     public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+      /**
+       * the batch of RowMutations.
+       */
       MUTATIONS((short)1, "mutations");
 
       private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -19811,10 +19998,16 @@ public class Blur {
       this.mutations.add(elem);
     }
 
+    /**
+     * the batch of RowMutations.
+     */
     public List<RowMutation> getMutations() {
       return this.mutations;
     }
 
+    /**
+     * the batch of RowMutations.
+     */
     public mutateBatch_args setMutations(List<RowMutation> mutations) {
       this.mutations = mutations;
       return this;

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/ColumnDefinition.java
----------------------------------------------------------------------
diff --git a/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/ColumnDefinition.java b/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/ColumnDefinition.java
index 90042e2..15f9248 100644
--- a/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/ColumnDefinition.java
+++ b/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/ColumnDefinition.java
@@ -49,6 +49,9 @@ import java.util.Arrays;
 //import org.slf4j.Logger;
 //import org.slf4j.LoggerFactory;
 
+/**
+ * The ColumnDefinition defines how a given Column should be interpreted (indexed/stored)
+ */
 public class ColumnDefinition implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<ColumnDefinition, ColumnDefinition._Fields>, java.io.Serializable, Cloneable {
   private static final org.apache.blur.thirdparty.thrift_0_9_0.protocol.TStruct STRUCT_DESC = new org.apache.blur.thirdparty.thrift_0_9_0.protocol.TStruct("ColumnDefinition");
 

http://git-wip-us.apache.org/repos/asf/incubator-blur/blob/ee933e4c/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/Metric.java
----------------------------------------------------------------------
diff --git a/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/Metric.java b/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/Metric.java
index b864754..35470eb 100644
--- a/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/Metric.java
+++ b/distribution/src/main/scripts/interface/gen-java/org/apache/blur/thrift/generated/Metric.java
@@ -49,6 +49,9 @@ import java.util.Arrays;
 //import org.slf4j.Logger;
 //import org.slf4j.LoggerFactory;
 
+/**
+ * The Metric will hold all the information for a given Metric.
+ */
 public class Metric implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<Metric, Metric._Fields>, java.io.Serializable, Cloneable {
   private static final org.apache.blur.thirdparty.thrift_0_9_0.protocol.TStruct STRUCT_DESC = new org.apache.blur.thirdparty.thrift_0_9_0.protocol.TStruct("Metric");
 
@@ -63,16 +66,40 @@ public class Metric implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<Met
     schemes.put(TupleScheme.class, new MetricTupleSchemeFactory());
   }
 
+  /**
+   * metric name.
+   */
   public String name; // required
+  /**
+   * map of string values emitted by the Metric.
+   */
   public Map<String,String> strMap; // required
+  /**
+   * map of long values emitted by the Metric.
+   */
   public Map<String,Long> longMap; // required
+  /**
+   * map of double values emitted by the Metric.
+   */
   public Map<String,Double> doubleMap; // required
 
   /** The set of fields this struct contains, along with convenience methods for finding and manipulating them. */
   public enum _Fields implements org.apache.blur.thirdparty.thrift_0_9_0.TFieldIdEnum {
+    /**
+     * metric name.
+     */
     NAME((short)1, "name"),
+    /**
+     * map of string values emitted by the Metric.
+     */
     STR_MAP((short)2, "strMap"),
+    /**
+     * map of long values emitted by the Metric.
+     */
     LONG_MAP((short)3, "longMap"),
+    /**
+     * map of double values emitted by the Metric.
+     */
     DOUBLE_MAP((short)4, "doubleMap");
 
     private static final Map<String, _Fields> byName = new HashMap<String, _Fields>();
@@ -239,10 +266,16 @@ public class Metric implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<Met
     this.doubleMap = null;
   }
 
+  /**
+   * metric name.
+   */
   public String getName() {
     return this.name;
   }
 
+  /**
+   * metric name.
+   */
   public Metric setName(String name) {
     this.name = name;
     return this;
@@ -274,10 +307,16 @@ public class Metric implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<Met
     this.strMap.put(key, val);
   }
 
+  /**
+   * map of string values emitted by the Metric.
+   */
   public Map<String,String> getStrMap() {
     return this.strMap;
   }
 
+  /**
+   * map of string values emitted by the Metric.
+   */
   public Metric setStrMap(Map<String,String> strMap) {
     this.strMap = strMap;
     return this;
@@ -309,10 +348,16 @@ public class Metric implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<Met
     this.longMap.put(key, val);
   }
 
+  /**
+   * map of long values emitted by the Metric.
+   */
   public Map<String,Long> getLongMap() {
     return this.longMap;
   }
 
+  /**
+   * map of long values emitted by the Metric.
+   */
   public Metric setLongMap(Map<String,Long> longMap) {
     this.longMap = longMap;
     return this;
@@ -344,10 +389,16 @@ public class Metric implements org.apache.blur.thirdparty.thrift_0_9_0.TBase<Met
     this.doubleMap.put(key, val);
   }
 
+  /**
+   * map of double values emitted by the Metric.
+   */
   public Map<String,Double> getDoubleMap() {
     return this.doubleMap;
   }
 
+  /**
+   * map of double values emitted by the Metric.
+   */
   public Metric setDoubleMap(Map<String,Double> doubleMap) {
     this.doubleMap = doubleMap;
     return this;


Mime
View raw message