docs(regen): updated javadocs from protoc update

proto-google-cloud-translate-v3/src/main/java/com/google/cloud/translate/v3/BatchTranslateMetadata.java

@@ -41,6 +41,12 @@ private BatchTranslateMetadata() {
     state_ = 0;
   }
 
+  @java.lang.Override
+  @SuppressWarnings({"unused"})
+  protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+    return new BatchTranslateMetadata();
+  }
+
   @java.lang.Override
   public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
     return this.unknownFields;
@@ -54,7 +60,6 @@ private BatchTranslateMetadata(
     if (extensionRegistry == null) {
       throw new java.lang.NullPointerException();
     }
-    int mutable_bitField0_ = 0;
     com.google.protobuf.UnknownFieldSet.Builder unknownFields =
         com.google.protobuf.UnknownFieldSet.newBuilder();
     try {
@@ -286,12 +291,20 @@ public final int getNumber() {
       return value;
     }
 
-    /** @deprecated Use {@link #forNumber(int)} instead. */
+    /**
+     * @param value The numeric wire value of the corresponding enum entry.
+     * @return The enum associated with the given numeric wire value.
+     * @deprecated Use {@link #forNumber(int)} instead.
+     */
     @java.lang.Deprecated
     public static State valueOf(int value) {
       return forNumber(value);
     }
 
+    /**
+     * @param value The numeric wire value of the corresponding enum entry.
+     * @return The enum associated with the given numeric wire value.
+     */
     public static State forNumber(int value) {
       switch (value) {
         case 0:
@@ -367,6 +380,8 @@ private State(int value) {
    * </pre>
    *
    * <code>.google.cloud.translation.v3.BatchTranslateMetadata.State state = 1;</code>
+   *
+   * @return The enum numeric value on the wire for state.
    */
   public int getStateValue() {
     return state_;
@@ -379,6 +394,8 @@ public int getStateValue() {
    * </pre>
    *
    * <code>.google.cloud.translation.v3.BatchTranslateMetadata.State state = 1;</code>
+   *
+   * @return The state.
    */
   public com.google.cloud.translate.v3.BatchTranslateMetadata.State getState() {
     @SuppressWarnings("deprecation")
@@ -399,6 +416,8 @@ public com.google.cloud.translate.v3.BatchTranslateMetadata.State getState() {
    * </pre>
    *
    * <code>int64 translated_characters = 2;</code>
+   *
+   * @return The translatedCharacters.
    */
   public long getTranslatedCharacters() {
     return translatedCharacters_;
@@ -415,6 +434,8 @@ public long getTranslatedCharacters() {
    * </pre>
    *
    * <code>int64 failed_characters = 3;</code>
+   *
+   * @return The failedCharacters.
    */
   public long getFailedCharacters() {
     return failedCharacters_;
@@ -432,6 +453,8 @@ public long getFailedCharacters() {
    * </pre>
    *
    * <code>int64 total_characters = 4;</code>
+   *
+   * @return The totalCharacters.
    */
   public long getTotalCharacters() {
     return totalCharacters_;
@@ -447,6 +470,8 @@ public long getTotalCharacters() {
    * </pre>
    *
    * <code>.google.protobuf.Timestamp submit_time = 5;</code>
+   *
+   * @return Whether the submitTime field is set.
    */
   public boolean hasSubmitTime() {
     return submitTime_ != null;
@@ -459,6 +484,8 @@ public boolean hasSubmitTime() {
    * </pre>
    *
    * <code>.google.protobuf.Timestamp submit_time = 5;</code>
+   *
+   * @return The submitTime.
    */
   public com.google.protobuf.Timestamp getSubmitTime() {
     return submitTime_ == null ? com.google.protobuf.Timestamp.getDefaultInstance() : submitTime_;
@@ -879,6 +906,8 @@ public Builder mergeFrom(
      * </pre>
      *
      * <code>.google.cloud.translation.v3.BatchTranslateMetadata.State state = 1;</code>
+     *
+     * @return The enum numeric value on the wire for state.
      */
     public int getStateValue() {
       return state_;
@@ -891,6 +920,9 @@ public int getStateValue() {
      * </pre>
      *
      * <code>.google.cloud.translation.v3.BatchTranslateMetadata.State state = 1;</code>
+     *
+     * @param value The enum numeric value on the wire for state to set.
+     * @return This builder for chaining.
      */
     public Builder setStateValue(int value) {
       state_ = value;
@@ -905,6 +937,8 @@ public Builder setStateValue(int value) {
      * </pre>
      *
      * <code>.google.cloud.translation.v3.BatchTranslateMetadata.State state = 1;</code>
+     *
+     * @return The state.
      */
     public com.google.cloud.translate.v3.BatchTranslateMetadata.State getState() {
       @SuppressWarnings("deprecation")
@@ -922,6 +956,9 @@ public com.google.cloud.translate.v3.BatchTranslateMetadata.State getState() {
      * </pre>
      *
      * <code>.google.cloud.translation.v3.BatchTranslateMetadata.State state = 1;</code>
+     *
+     * @param value The state to set.
+     * @return This builder for chaining.
      */
     public Builder setState(com.google.cloud.translate.v3.BatchTranslateMetadata.State value) {
       if (value == null) {
@@ -940,6 +977,8 @@ public Builder setState(com.google.cloud.translate.v3.BatchTranslateMetadata.Sta
      * </pre>
      *
      * <code>.google.cloud.translation.v3.BatchTranslateMetadata.State state = 1;</code>
+     *
+     * @return This builder for chaining.
      */
     public Builder clearState() {
 
@@ -957,6 +996,8 @@ public Builder clearState() {
      * </pre>
      *
      * <code>int64 translated_characters = 2;</code>
+     *
+     * @return The translatedCharacters.
      */
     public long getTranslatedCharacters() {
       return translatedCharacters_;
@@ -969,6 +1010,9 @@ public long getTranslatedCharacters() {
      * </pre>
      *
      * <code>int64 translated_characters = 2;</code>
+     *
+     * @param value The translatedCharacters to set.
+     * @return This builder for chaining.
      */
     public Builder setTranslatedCharacters(long value) {
 
@@ -984,6 +1028,8 @@ public Builder setTranslatedCharacters(long value) {
      * </pre>
      *
      * <code>int64 translated_characters = 2;</code>
+     *
+     * @return This builder for chaining.
      */
     public Builder clearTranslatedCharacters() {
 
@@ -1002,6 +1048,8 @@ public Builder clearTranslatedCharacters() {
      * </pre>
      *
      * <code>int64 failed_characters = 3;</code>
+     *
+     * @return The failedCharacters.
      */
     public long getFailedCharacters() {
       return failedCharacters_;
@@ -1015,6 +1063,9 @@ public long getFailedCharacters() {
      * </pre>
      *
      * <code>int64 failed_characters = 3;</code>
+     *
+     * @param value The failedCharacters to set.
+     * @return This builder for chaining.
      */
     public Builder setFailedCharacters(long value) {
 
@@ -1031,6 +1082,8 @@ public Builder setFailedCharacters(long value) {
      * </pre>
      *
      * <code>int64 failed_characters = 3;</code>
+     *
+     * @return This builder for chaining.
      */
     public Builder clearFailedCharacters() {
 
@@ -1050,6 +1103,8 @@ public Builder clearFailedCharacters() {
      * </pre>
      *
      * <code>int64 total_characters = 4;</code>
+     *
+     * @return The totalCharacters.
      */
     public long getTotalCharacters() {
       return totalCharacters_;
@@ -1064,6 +1119,9 @@ public long getTotalCharacters() {
      * </pre>
      *
      * <code>int64 total_characters = 4;</code>
+     *
+     * @param value The totalCharacters to set.
+     * @return This builder for chaining.
      */
     public Builder setTotalCharacters(long value) {
 
@@ -1081,6 +1139,8 @@ public Builder setTotalCharacters(long value) {
      * </pre>
      *
      * <code>int64 total_characters = 4;</code>
+     *
+     * @return This builder for chaining.
      */
     public Builder clearTotalCharacters() {
 
@@ -1103,6 +1163,8 @@ public Builder clearTotalCharacters() {
      * </pre>
      *
      * <code>.google.protobuf.Timestamp submit_time = 5;</code>
+     *
+     * @return Whether the submitTime field is set.
      */
     public boolean hasSubmitTime() {
       return submitTimeBuilder_ != null || submitTime_ != null;
@@ -1115,6 +1177,8 @@ public boolean hasSubmitTime() {
      * </pre>
      *
      * <code>.google.protobuf.Timestamp submit_time = 5;</code>
+     *
+     * @return The submitTime.
      */
     public com.google.protobuf.Timestamp getSubmitTime() {
       if (submitTimeBuilder_ == null) {

proto-google-cloud-translate-v3/src/main/java/com/google/cloud/translate/v3/BatchTranslateMetadataOrBuilder.java

@@ -31,6 +31,8 @@ public interface BatchTranslateMetadataOrBuilder
    * </pre>
    *
    * <code>.google.cloud.translation.v3.BatchTranslateMetadata.State state = 1;</code>
+   *
+   * @return The enum numeric value on the wire for state.
    */
   int getStateValue();
   /**
@@ -41,6 +43,8 @@ public interface BatchTranslateMetadataOrBuilder
    * </pre>
    *
    * <code>.google.cloud.translation.v3.BatchTranslateMetadata.State state = 1;</code>
+   *
+   * @return The state.
    */
   com.google.cloud.translate.v3.BatchTranslateMetadata.State getState();
 
@@ -52,6 +56,8 @@ public interface BatchTranslateMetadataOrBuilder
    * </pre>
    *
    * <code>int64 translated_characters = 2;</code>
+   *
+   * @return The translatedCharacters.
    */
   long getTranslatedCharacters();
 
@@ -64,6 +70,8 @@ public interface BatchTranslateMetadataOrBuilder
    * </pre>
    *
    * <code>int64 failed_characters = 3;</code>
+   *
+   * @return The failedCharacters.
    */
   long getFailedCharacters();
 
@@ -77,6 +85,8 @@ public interface BatchTranslateMetadataOrBuilder
    * </pre>
    *
    * <code>int64 total_characters = 4;</code>
+   *
+   * @return The totalCharacters.
    */
   long getTotalCharacters();
 
@@ -88,6 +98,8 @@ public interface BatchTranslateMetadataOrBuilder
    * </pre>
    *
    * <code>.google.protobuf.Timestamp submit_time = 5;</code>
+   *
+   * @return Whether the submitTime field is set.
    */
   boolean hasSubmitTime();
   /**
@@ -98,6 +110,8 @@ public interface BatchTranslateMetadataOrBuilder
    * </pre>
    *
    * <code>.google.protobuf.Timestamp submit_time = 5;</code>
+   *
+   * @return The submitTime.
    */
   com.google.protobuf.Timestamp getSubmitTime();
   /**