---

olavloite · kolea2 · commit 6f1a3072fafb · 2019-03-26T14:17:00.000-04:00
yaml --- r: 27421 b: refs/heads/mrschmidt-collectiongroup c: 620d105 h: refs/heads/master i: 27419: 184f746
diff --git a/[refs] b/[refs]
@@ -173,7 +173,7 @@ refs/heads/autosynth-securitycenter: f2f2feb8f3949c986d37e55cd23cdb0ce774f287
 refs/heads/autosynth-talent: 4ca901879f86aab61091cea52e8a9b653639df24
 refs/heads/cscc-samples: 620d105e6b574cfeeee04e413a157b7bd34ebc8b
 refs/heads/igorbernstein2-patch-1: f62464ee14df1e44a3b173cdc3976563d1b3078b
-refs/heads/mrschmidt-collectiongroup: 249d1636213be23efd68c92c08252e8b1ed930d6
+refs/heads/mrschmidt-collectiongroup: 620d105e6b574cfeeee04e413a157b7bd34ebc8b
 refs/heads/release-google-cloud-java-v0.83.0: 4b55ec1b81b3886ede61ae868391a3cdf7eed90e
 refs/heads/release-google-cloud-java-v0.83.1-SNAPSHOT: 8d6db7ee534d12b1df38d8cf314871df76f87577
 refs/heads/v4support: aa837fd70877f5a0628d8036e88952db035b792c
diff --git a/branches/mrschmidt-collectiongroup/google-cloud-clients/google-cloud-spanner/src/main/java/com/google/cloud/spanner/DatabaseClient.java b/branches/mrschmidt-collectiongroup/google-cloud-clients/google-cloud-spanner/src/main/java/com/google/cloud/spanner/DatabaseClient.java
@@ -85,7 +85,9 @@ public interface DatabaseClient {
 
   /**
    * Returns a context in which a single read can be performed using {@link TimestampBound#strong()}
-   * concurrency.
+   * concurrency. This method will return a {@link ReadContext} that will not return the read
+   * timestamp that was used by Cloud Spanner. If you want to be able to access the read timestamp,
+   * you should use the method {@link #singleUseReadOnlyTransaction()}.
    *
    * <p>Example of single use.
    *
@@ -100,17 +102,18 @@ public interface DatabaseClient {
   ReadContext singleUse();
 
   /**
-   * Returns a context in which a single read can be performed at the given timestamp bound.
+   * Returns a context in which a single read can be performed at the given timestamp bound. This
+   * method will return a {@link ReadContext} that will not return the read timestamp that was used
+   * by Cloud Spanner. If you want to be able to access the read timestamp, you should use the
+   * method {@link #singleUseReadOnlyTransaction()}.
    *
    * <p>Example of single use with timestamp bound.
    *
    * <pre>{@code
    * long singerId = my_singer_id;
    * String column = "FirstName";
-   * Struct row =
-   *     dbClient
-   *         .singleUse(TimestampBound.ofMaxStaleness(10, TimeUnit.SECONDS))
-   *         .readRow("Singers", Key.of(singerId), Collections.singleton(column));
+   * Struct row = dbClient.singleUse(TimestampBound.ofMaxStaleness(10, TimeUnit.SECONDS))
+   *     .readRow("Singers", Key.of(singerId), Collections.singleton(column));
    * String firstName = row.getString(column);
    * }</pre>
    *
