---

Ajay Kannan · Ajay Kannan · commit 82fea41e9737 · 2016-03-01T10:13:56.000-08:00
yaml --- r: 4739 b: refs/heads/logging-alpha c: 0d794ea h: refs/heads/master i: 4737: be5ea4e 4735: fc183ee
diff --git a/[refs] b/[refs]
@@ -12,7 +12,7 @@ refs/heads/compute-alpha: 969cba2627f1d53d352cc4a5ffe0879dacf65e6c
 refs/heads/dns-alpha: 2f90e7e338349287ace33375896907af0f032ca1
 refs/heads/dns-alpha-batch: 17442b07867021b85d0452f5f3eda29a3413288f
 refs/heads/gcs-nio: 283aeaf15efdcf3621eb6859f05e55ad7764375d
-refs/heads/logging-alpha: 76e3b3ef5ead06e8741d887ca8c337451470692a
+refs/heads/logging-alpha: 0d794eaf55f61ad3156d3ecbce9b64562e870868
 refs/tags/v0.1.0: a615317f7424ed58621b1f65d5c4d8cbbe8a6ed8
 refs/tags/v0.1.1: 7a7f6985fe465e9dd6a075af55493f42b4933be0
 refs/tags/v0.1.2: 3eb3fe866ba22487686048f45d927b8c8638ea3f
diff --git a/branches/logging-alpha/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/ReadOption.java b/branches/logging-alpha/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);
