docs(regen): updated javadocs from protoc update (#43)

Author: yoshi-automation

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();
  /**