---

Ajay Kannan · Ajay Kannan · commit 58cf7d5289d4 · 2015-10-20T16:58:48.000-07:00
yaml --- r: 1069 b: refs/heads/master c: 8b129ce h: refs/heads/master i: 1067: 8d9ea9d v: v3
diff --git a/[refs] b/[refs]
@@ -1,4 +1,4 @@
 ---
-refs/heads/master: 5f01eb90a4ea5c07ace82f84af0094db69c4b991
+refs/heads/master: 8b129ced902dcd2c0dab8feee2d412921d74950d
 refs/heads/travis: 0fa997e2fc9c6b61b2d91e6d163655aae67d44b6
 refs/heads/gh-pages: 5a10432ecc75f29812e33a8236c900379509fe99
diff --git a/trunk/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/StructuredQuery.java b/trunk/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/StructuredQuery.java
@@ -113,7 +113,7 @@ static Filter fromPb(DatastoreV1.Filter filterPb) {
     }
   }
 
-  /*
+  /**
    * A class representing a filter composed of a combination of other filters.
    */
   public static final class CompositeFilter extends Filter {
@@ -197,7 +197,7 @@ protected DatastoreV1.Filter toPb() {
     }
   }
 
-  /*
+  /**
    * A class representing a filter based on a single property or ancestor.
    */
   public static final class PropertyFilter extends Filter {
@@ -520,7 +520,7 @@ static OrderBy fromPb(DatastoreV1.PropertyOrder propertyOrderPb) {
     }
   }
 
-  /*
+  /**
    * A class representing a projection based on a property.
    */
   public static final class Projection implements Serializable {
@@ -674,17 +674,17 @@ public B clearOrderBy() {
       return self();
     }
 
-    /*
-     * Clears all previously-specified OrderBy objects and orders by the given input instead.
+    /**
+     * Sets the query's order by clause (clearing any previously specified OrderBy settings).
      */
     public B orderBy(OrderBy orderBy, OrderBy... others) {
       clearOrderBy();
       addOrderBy(orderBy, others);
       return self();
     }
 
-    /*
-     * Adds one or more OrderBy objects to the existing list of OrderBy objects.
+    /**
+     * Adds settings to the existing order by clause.
      */
     public B addOrderBy(OrderBy orderBy, OrderBy... others) {
       this.orderBy.add(orderBy);
@@ -697,19 +697,12 @@ B clearProjection() {
       return self();
     }
 
-    /*
-     * Clears all previously-specified Projections and sets the list of Projections to the given
-     * input instead.
-     */
     B projection(Projection projection, Projection... others) {
       clearProjection();
       addProjection(projection, others);
       return self();
     }
 
-    /*
-     * Adds one or more Projections to the existing list of Projections.
-     */
     B addProjection(Projection projection, Projection... others) {
       this.projection.add(projection);
       Collections.addAll(this.projection, others);
@@ -721,19 +714,12 @@ B clearGroupBy() {
       return self();
     }
 
-    /*
-     * Clears all existing properties to group by and instead groups by the given the list of
-     * properties.
-     */
     B groupBy(String property, String... others) {
       clearGroupBy();
       addGroupBy(property, others);
       return self();
     }
 
-    /*
-     * Adds one or more properties to the existing list of "group by" properties.
-     */
     B addGroupBy(String property, String... others) {
       this.groupBy.add(property);
       Collections.addAll(this.groupBy, others);
@@ -783,7 +769,7 @@ static final class Builder<V> extends BaseBuilder<V, Builder<V>> {
     }
   }
 
-  /*
+  /**
    * A StructuredQuery builder for queries that return Entity results.
    */
   public static final class EntityQueryBuilder extends BaseBuilder<Entity, EntityQueryBuilder> {
@@ -798,7 +784,7 @@ public StructuredQuery<Entity> build() {
     }
   }
 
-  /*
+  /**
    * A StructuredQuery builder for queries that return Key results.
    */
   public static final class KeyQueryBuilder extends BaseBuilder<Key, KeyQueryBuilder> {
@@ -822,7 +808,7 @@ public StructuredQuery<Key> build() {
     }
   }
 
-  /*
+  /**
    * A StructuredQuery builder for projection queries.
    */
   public static final class ProjectionEntityQueryBuilder
@@ -842,11 +828,17 @@ public ProjectionEntityQueryBuilder clearProjection() {
       return super.clearProjection();
     }
 
+    /**
+     * Sets the query's projection clause (clearing any previously specified Projection settings).
+     */
     @Override
     public ProjectionEntityQueryBuilder projection(Projection projection, Projection... others) {
       return super.projection(projection, others);
     }
 
+    /**
+     * Adds one or more projections to the existing projection clause.
+     */
     @Override
     public ProjectionEntityQueryBuilder addProjection(Projection projection, Projection... others) {
       return super.addProjection(projection, others);
@@ -857,11 +849,17 @@ public ProjectionEntityQueryBuilder clearGroupBy() {
       return super.clearGroupBy();
     }
 
+    /**
+     * Sets the query's group by clause (clearing any previously specified GroupBy settings).
+     */
     @Override
     public ProjectionEntityQueryBuilder groupBy(String property, String... others) {
       return super.groupBy(property, others);
     }
 
+    /**
+     * Adds one or more properties to the existing group by clause.
+     */
     @Override
     public ProjectionEntityQueryBuilder addGroupBy(String property, String... others) {
       return super.addGroupBy(property, others);
