Annotating new features with @since javadoc

googleapis · Jun 18, 2019 · 6baddd7 · 6baddd7
1 parent 62fb530
commit 6baddd7
Show file tree

Hide file tree

Showing 3 changed files with 14 additions and 2 deletions.
diff --git a/.../src/main/java/com/google/api/client/googleapis/services/AbstractGoogleClientRequest.java b/.../src/main/java/com/google/api/client/googleapis/services/AbstractGoogleClientRequest.java
@@ -225,7 +225,11 @@ public final boolean getDisableGZipContent() {
     return disableGZipContent;
   }
 
-  /** Returns whether response should return raw input stream. */
+  /**
+   * Returns whether response should return raw input stream.
+   *
+   * @since 1.30
+   * */
   public final boolean getReturnRawInputSteam() {
     return returnRawInputStream;
   }
@@ -260,6 +264,8 @@ public AbstractGoogleClientRequest<T> setDisableGZipContent(boolean disableGZipC
    * chunks (see <a href="https://github.com/googleapis/google-api-java-client/issues/1009">#1009
    * </a>). Setting this to true will make the response return the raw input stream.
    * </p>
+   *
+   * @since 1.30
    */
   public AbstractGoogleClientRequest<T> setReturnRawInputStream(boolean returnRawInputStream) {
     this.returnRawInputStream = returnRawInputStream;

diff --git a/.../java/com/google/api/client/googleapis/services/CommonGoogleClientRequestInitializer.java b/.../java/com/google/api/client/googleapis/services/CommonGoogleClientRequestInitializer.java
@@ -150,6 +150,8 @@ protected CommonGoogleClientRequestInitializer(Builder builder) {
 
   /**
    * Returns new builder.
+   *
+   * @since 1.30
    */
   public static Builder newBuilder() {
     return new Builder();
@@ -198,13 +200,15 @@ public final String getRequestReason() {
     return requestReason;
   }
 
-  /** Returns the user project of {@code null} */
+  /** Returns the user project or {@code null}. */
   public final String getUserProject() {
     return userProject;
   }
 
   /**
    * Builder for {@code CommonGoogleClientRequestInitializer}.
+   *
+   * @since 1.30
    */
   public static class Builder {
     private String key;

diff --git a/.../google/api/client/googleapis/services/json/CommonGoogleJsonClientRequestInitializer.java b/.../google/api/client/googleapis/services/json/CommonGoogleJsonClientRequestInitializer.java
@@ -137,6 +137,8 @@ protected void initializeJsonRequest(AbstractGoogleJsonClientRequest<?> request)
 
   /**
    * Builder for {@code CommonGoogleJsonClientRequestInitializer}.
+   *
+   * @since 1.30
    */
   public static class Builder extends CommonGoogleClientRequestInitializer.Builder {
     @Override