---

Ajay Kannan · Ajay Kannan · commit 6585811deecf · 2016-03-01T10:13:56.000-08:00
yaml --- r: 2771 b: refs/heads/update-datastore c: 0d794ea h: refs/heads/master i: 2769: f48f2c5 2767: e4244f6
diff --git a/[refs] b/[refs]
@@ -5,7 +5,7 @@ refs/heads/gh-pages: 4e0561bb4504bf647db669a14417b2b2c87ba45d
 refs/heads/bigquery: 762fa5830e6c398c0396177e3e7fd243bd62cfc3
 refs/heads/pubsub-alpha: 1a0e970f265af871e02274085b9662b3fe29058b
 refs/heads/resource-manager: ebf4adc5ee835cd2086c4ac5b4e78d01a5a005a7
-refs/heads/update-datastore: 76e3b3ef5ead06e8741d887ca8c337451470692a
+refs/heads/update-datastore: 0d794eaf55f61ad3156d3ecbce9b64562e870868
 refs/tags/0.0.9: 22f1839238f66c39e67ed4dfdcd273b1ae2e8444
 refs/tags/v0.0.10: 207ebd2a3472fddee69fe1298eb90429e3306efd
 refs/tags/v0.0.11: ffbfba48a6426ff63c08ff2117e58681f251fbf2
diff --git a/branches/update-datastore/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/ReadOption.java b/branches/update-datastore/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/ReadOption.java
@@ -30,7 +30,8 @@ public abstract class ReadOption implements Serializable {
   private static final long serialVersionUID = -4406964829189800528L;
 
   /**
-   * Specifies eventual consistency for reads from Datastore.
+   * Specifies eventual consistency for reads from Datastore. Lookups and ancestor queries using
+   * this option permit Datastore to return stale results.
    */
   public static final class EventualConsistency extends ReadOption {
 
@@ -50,7 +51,8 @@ public boolean isEventual() {
   private ReadOption() {}
 
   /**
-   * Returns a {@code ReadOption} that specifies eventual consistency.
+   * Returns a {@code ReadOption} that specifies eventual consistency, allowing Datastore to return
+   * stale results from gets, fetches, and ancestor queries.
    */
   public static EventualConsistency eventualConsistency() {
     return new EventualConsistency(true);
