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

Author: yoshi-automation

proto-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/AudioConfig.java

@@ -33,6 +33,8 @@ public interface AudioConfigOrBuilder
    * <code>
    * .google.cloud.texttospeech.v1.AudioEncoding audio_encoding = 1 [(.google.api.field_behavior) = REQUIRED];
    * </code>
+   *
+   * @return The enum numeric value on the wire for audioEncoding.
    */
   int getAudioEncodingValue();
   /**
@@ -45,6 +47,8 @@ public interface AudioConfigOrBuilder
    * <code>
    * .google.cloud.texttospeech.v1.AudioEncoding audio_encoding = 1 [(.google.api.field_behavior) = REQUIRED];
    * </code>
+   *
+   * @return The audioEncoding.
    */
   com.google.cloud.texttospeech.v1.AudioEncoding getAudioEncoding();
 
@@ -61,6 +65,8 @@ public interface AudioConfigOrBuilder
    * <code>
    * double speaking_rate = 2 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @return The speakingRate.
    */
   double getSpeakingRate();
 
@@ -76,6 +82,8 @@ public interface AudioConfigOrBuilder
    * <code>
    * double pitch = 3 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @return The pitch.
    */
   double getPitch();
 
@@ -96,6 +104,8 @@ public interface AudioConfigOrBuilder
    * <code>
    * double volume_gain_db = 4 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @return The volumeGainDb.
    */
   double getVolumeGainDb();
 
@@ -113,6 +123,8 @@ public interface AudioConfigOrBuilder
    * </pre>
    *
    * <code>int32 sample_rate_hertz = 5 [(.google.api.field_behavior) = OPTIONAL];</code>
+   *
+   * @return The sampleRateHertz.
    */
   int getSampleRateHertz();
 
@@ -131,6 +143,8 @@ public interface AudioConfigOrBuilder
    * <code>
    * repeated string effects_profile_id = 6 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @return A list containing the effectsProfileId.
    */
   java.util.List<java.lang.String> getEffectsProfileIdList();
   /**
@@ -148,6 +162,8 @@ public interface AudioConfigOrBuilder
    * <code>
    * repeated string effects_profile_id = 6 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @return The count of effectsProfileId.
    */
   int getEffectsProfileIdCount();
   /**
@@ -165,6 +181,9 @@ public interface AudioConfigOrBuilder
    * <code>
    * repeated string effects_profile_id = 6 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @param index The index of the element to return.
+   * @return The effectsProfileId at the given index.
    */
   java.lang.String getEffectsProfileId(int index);
   /**
@@ -182,6 +201,9 @@ public interface AudioConfigOrBuilder
    * <code>
    * repeated string effects_profile_id = 6 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @param index The index of the value to return.
+   * @return The bytes of the effectsProfileId at the given index.
    */
   com.google.protobuf.ByteString getEffectsProfileIdBytes(int index);
 }

proto-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/AudioConfigOrBuilder.java

@@ -129,12 +129,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 AudioEncoding 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 AudioEncoding forNumber(int value) {
     switch (value) {
       case 0:

proto-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/AudioEncoding.java

@@ -41,6 +41,12 @@ private ListVoicesRequest() {
     languageCode_ = "";
   }
 
+  @java.lang.Override
+  @SuppressWarnings({"unused"})
+  protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+    return new ListVoicesRequest();
+  }
+
   @java.lang.Override
   public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
     return this.unknownFields;
@@ -54,7 +60,6 @@ private ListVoicesRequest(
     if (extensionRegistry == null) {
       throw new java.lang.NullPointerException();
     }
-    int mutable_bitField0_ = 0;
     com.google.protobuf.UnknownFieldSet.Builder unknownFields =
         com.google.protobuf.UnknownFieldSet.newBuilder();
     try {
@@ -123,6 +128,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * </pre>
    *
    * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
+   *
+   * @return The languageCode.
    */
   public java.lang.String getLanguageCode() {
     java.lang.Object ref = languageCode_;
@@ -150,6 +157,8 @@ public java.lang.String getLanguageCode() {
    * </pre>
    *
    * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
+   *
+   * @return The bytes for languageCode.
    */
   public com.google.protobuf.ByteString getLanguageCodeBytes() {
     java.lang.Object ref = languageCode_;
@@ -497,6 +506,8 @@ public Builder mergeFrom(
      * </pre>
      *
      * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
+     *
+     * @return The languageCode.
      */
     public java.lang.String getLanguageCode() {
       java.lang.Object ref = languageCode_;
@@ -524,6 +535,8 @@ public java.lang.String getLanguageCode() {
      * </pre>
      *
      * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
+     *
+     * @return The bytes for languageCode.
      */
     public com.google.protobuf.ByteString getLanguageCodeBytes() {
       java.lang.Object ref = languageCode_;
@@ -551,6 +564,9 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
      * </pre>
      *
      * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
+     *
+     * @param value The languageCode to set.
+     * @return This builder for chaining.
      */
     public Builder setLanguageCode(java.lang.String value) {
       if (value == null) {
@@ -576,6 +592,8 @@ public Builder setLanguageCode(java.lang.String value) {
      * </pre>
      *
      * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
+     *
+     * @return This builder for chaining.
      */
     public Builder clearLanguageCode() {
 
@@ -598,6 +616,9 @@ public Builder clearLanguageCode() {
      * </pre>
      *
      * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
+     *
+     * @param value The bytes for languageCode to set.
+     * @return This builder for chaining.
      */
     public Builder setLanguageCodeBytes(com.google.protobuf.ByteString value) {
       if (value == null) {

proto-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/ListVoicesRequest.java

@@ -38,6 +38,8 @@ public interface ListVoicesRequestOrBuilder
    * </pre>
    *
    * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
+   *
+   * @return The languageCode.
    */
   java.lang.String getLanguageCode();
   /**
@@ -55,6 +57,8 @@ public interface ListVoicesRequestOrBuilder
    * </pre>
    *
    * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
+   *
+   * @return The bytes for languageCode.
    */
   com.google.protobuf.ByteString getLanguageCodeBytes();
 }

proto-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/ListVoicesRequestOrBuilder.java

@@ -41,6 +41,12 @@ private ListVoicesResponse() {
     voices_ = java.util.Collections.emptyList();
   }
 
+  @java.lang.Override
+  @SuppressWarnings({"unused"})
+  protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+    return new ListVoicesResponse();
+  }
+
   @java.lang.Override
   public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
     return this.unknownFields;

proto-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/ListVoicesResponse.java

@@ -129,12 +129,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 SsmlVoiceGender 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 SsmlVoiceGender forNumber(int value) {
     switch (value) {
       case 0: