From f6cc097923cd58f53f287423d3ae3257a1bb4140 Mon Sep 17 00:00:00 2001
From: Ajay Kannan <ajaykannan@google.com>
Date: Tue, 1 Mar 2016 08:13:53 -0800
Subject: [PATCH] WIP

---
 .../google/gcloud/datastore/Datastore.java    | 21 +++++++++----------
 .../gcloud/datastore/DatastoreReader.java     | 15 +++++++------
 2 files changed, 17 insertions(+), 19 deletions(-)

diff --git a/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/Datastore.java b/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/Datastore.java
index 00b914a36678..c0efaa52b4e8 100644
--- a/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/Datastore.java
+++ b/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/Datastore.java
@@ -114,11 +114,11 @@ interface TransactionCallable<T> {
   Entity get(Key key, ReadOption... options);
 
   /**
-   * Returns an {@link Entity} for each given {@link Key} that exists in the Datastore.
-   * The order of the result is unspecified.
-   * Results are loaded lazily, so it is possible to get a {@code DatastoreException}
-   * from the returned {@code Iterator}'s {@link Iterator#hasNext hasNext} or
-   * {@link Iterator#next next} methods. {@link ReadOption}s can be specified if desired.
+   * Returns an {@link Entity} for each given {@link Key} that exists in the Datastore. The order of
+   * the result is unspecified. Results are loaded lazily, so it is possible to get a
+   * {@code DatastoreException} from the returned {@code Iterator}'s
+   * {@link Iterator#hasNext hasNext} or {@link Iterator#next next} methods. {@link ReadOption}s can
+   * be specified if desired.
    *
    * @throws DatastoreException upon failure
    * @see #get(Key)
@@ -126,16 +126,15 @@ interface TransactionCallable<T> {
   Iterator<Entity> get(Iterable<Key> keys, ReadOption... options);
 
   /**
-   * Returns a list with a value for each given key (ordered by input).
-   * {@code null} values are returned for nonexistent keys.
-   * When possible prefer using {@link #get(Key...)} to avoid eagerly loading the results.
-   * {@link ReadOption}s can be specified if desired.
+   * Returns a list with a value for each given key (ordered by input). {@code null} values are
+   * returned for nonexistent keys. When possible prefer using {@link #get(Key...)} to avoid eagerly
+   * loading the results. {@link ReadOption}s can be specified if desired.
    */
   List<Entity> fetch(Iterable<Key> keys, ReadOption... options);
 
   /**
-   * Submits a {@link Query} and returns its result.
-   * {@link ReadOption}s can be specified if desired.
+   * Submits a {@link Query} and returns its result. {@link ReadOption}s can be specified if
+   * desired.
    *
    * @throws DatastoreException upon failure
    */
diff --git a/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/DatastoreReader.java b/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/DatastoreReader.java
index 7ba5089ae4eb..3d6e5ec73243 100644
--- a/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/DatastoreReader.java
+++ b/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/DatastoreReader.java
@@ -32,11 +32,10 @@ public interface DatastoreReader {
   Entity get(Key key);
 
   /**
-   * Returns an {@link Entity} for each given {@link Key} that exists in the Datastore.
-   * The order of the result is unspecified.
-   * Results are loaded lazily, so it is possible to get a {@code DatastoreException}
-   * from the returned {@code Iterator}'s {@link Iterator#hasNext hasNext} or
-   * {@link Iterator#next next} methods.
+   * Returns an {@link Entity} for each given {@link Key} that exists in the Datastore. The order of
+   * the result is unspecified. Results are loaded lazily, so it is possible to get a
+   * {@code DatastoreException} from the returned {@code Iterator}'s
+   * {@link Iterator#hasNext hasNext} or {@link Iterator#next next} methods.
    *
    * @throws DatastoreException upon failure
    * @see #get(Key)
@@ -44,9 +43,9 @@ public interface DatastoreReader {
   Iterator<Entity> get(Key... key);
 
   /**
-   * Returns a list with a value for each given key (ordered by input).
-   * {@code null} values are returned for nonexistent keys.
-   * When possible prefer using {@link #get(Key...)} to avoid eagerly loading the results.
+   * Returns a list with a value for each given key (ordered by input). {@code null} values are
+   * returned for nonexistent keys. When possible prefer using {@link #get(Key...)} to avoid eagerly
+   * loading the results.
    */
   List<Entity> fetch(Key... keys);