---

Ajay Kannan · Ajay Kannan · commit 549363d3bae3 · 2016-01-15T16:00:38.000-08:00
yaml --- r: 4237 b: refs/heads/gcs-nio c: 3d7ea2c h: refs/heads/master i: 4235: c0d1b08
diff --git a/[refs] b/[refs]
@@ -11,7 +11,7 @@ refs/tags/v0.0.12: 2fd8066e891fb3dfea69b65f6bf6461db79342b9
 refs/heads/compute-alpha: 969cba2627f1d53d352cc4a5ffe0879dacf65e6c
 refs/heads/dns-alpha: 2f90e7e338349287ace33375896907af0f032ca1
 refs/heads/dns-alpha-batch: 17442b07867021b85d0452f5f3eda29a3413288f
-refs/heads/gcs-nio: 482954f2c5055231e5b3122ea91d2ba00ce8187c
+refs/heads/gcs-nio: 3d7ea2c955bb4886ffc1954badd98ce0eff9a8a4
 refs/heads/logging-alpha: db5312bffa7fccac194f6a7feb8cc3066de16aff
 refs/tags/v0.1.0: a615317f7424ed58621b1f65d5c4d8cbbe8a6ed8
 refs/tags/v0.1.1: 7a7f6985fe465e9dd6a075af55493f42b4933be0
diff --git a/branches/gcs-nio/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/QueryResults.java b/branches/gcs-nio/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/QueryResults.java
@@ -35,7 +35,21 @@ public interface QueryResults<V> extends Iterator<V> {
   Class<?> resultClass();
 
   /**
-   * Returns the Cursor for point after the value returned in the last {@link #next} call.
+   * Returns the Cursor for the point after the value returned in the last {@link #next} call. This
+   * cursor can be used to issue subsequent queries (with the same constraints) that may return
+   * additional results.
+   *
+   * <p>A simple use case:
+   * <pre> {@code
+   * Query<Entity> query = Query.entityQueryBuilder()
+   *     .kind("Person")
+   *     .filter(PropertyFilter.eq("favoriteFood", "pizza"))
+   *     .build();
+   * QueryResults<Entity> results = datastore.run(query);
+   * // Consume some results (using results.next()) and do any other actions as necessary.
+   * query = query.toBuilder().startCursor(results.cursorAfter()).build();
+   * results = datastore.run(query); // now we will iterate over all entities not yet consumed
+   * </pre>
    */
   Cursor cursorAfter();
 }
