docs: fix docstring formatting

google-cloud-texttospeech/src/main/java/com/google/cloud/texttospeech/v1/TextToSpeechClient.java

@@ -153,10 +153,10 @@ public TextToSpeechStub getStub() {
    * @param languageCode Optional. Recommended.
    *     [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If specified, the
    *     ListVoices call will only return voices that can be used to synthesize this language_code.
-   *     E.g. when specifying "en-NZ", you will get supported "en-\\*" voices; when specifying
-   *     "no", you will get supported "no-\\*" (Norwegian) and "nb-\\*" (Norwegian Bokmal)
-   *     voices; specifying "zh" will also get supported "cmn-\\*" voices; specifying "zh-hk"
-   *     will also get supported "yue-\\*" voices.
+   *     E.g. when specifying `"en-NZ"`, you will get supported `"en-\\*"` voices; when
+   *     specifying `"no"`, you will get supported `"no-\\*"` (Norwegian) and `"nb-\\*"`
+   *     (Norwegian Bokmal) voices; specifying `"zh"` will also get supported `"cmn-\\*"`
+   *     voices; specifying `"zh-hk"` will also get supported `"yue-\\*"` voices.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListVoicesResponse listVoices(String languageCode) {

google-cloud-texttospeech/src/main/java/com/google/cloud/texttospeech/v1/package-info.java

@@ -15,7 +15,9 @@
  */
 
 /**
- * The interfaces provided are listed below, along with usage samples.
+ * A client to Cloud Text-to-Speech API
+ *
+ * <p>The interfaces provided are listed below, along with usage samples.
  *
  * <p>======================= TextToSpeechClient =======================
  *

google-cloud-texttospeech/src/main/java/com/google/cloud/texttospeech/v1beta1/TextToSpeechClient.java

@@ -154,11 +154,11 @@ public TextToSpeechStub getStub() {
    * @param languageCode Optional. Recommended.
    *     [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If not specified, the
    *     API will return all supported voices. If specified, the ListVoices call will only return
-   *     voices that can be used to synthesize this language_code. E.g. when specifying "en-NZ", you
-   *     will get supported "en-NZ" voices; when specifying "no", you will get supported
-   *     "no-\\*" (Norwegian) and "nb-\\*" (Norwegian Bokmal) voices; specifying "zh" will
-   *     also get supported "cmn-\\*" voices; specifying "zh-hk" will also get supported
-   *     "yue-hk" voices.
+   *     voices that can be used to synthesize this language_code. E.g. when specifying `"en-NZ"`,
+   *     you will get supported `"en-NZ"` voices; when specifying `"no"`, you will get supported
+   *     `"no-\\*"` (Norwegian) and `"nb-\\*"` (Norwegian Bokmal) voices; specifying `"zh"`
+   *     will also get supported `"cmn-\\*"` voices; specifying `"zh-hk"` will also get
+   *     supported `"yue-hk"` voices.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListVoicesResponse listVoices(String languageCode) {

google-cloud-texttospeech/src/main/java/com/google/cloud/texttospeech/v1beta1/package-info.java

@@ -15,7 +15,9 @@
  */
 
 /**
- * The interfaces provided are listed below, along with usage samples.
+ * A client to Cloud Text-to-Speech API
+ *
+ * <p>The interfaces provided are listed below, along with usage samples.
  *
  * <p>======================= TextToSpeechClient =======================
  *

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

@@ -120,11 +120,11 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * Optional. Recommended.
    * [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
    * specified, the ListVoices call will only return voices that can be used to
-   * synthesize this language_code. E.g. when specifying "en-NZ", you will get
-   * supported "en-\*" voices; when specifying "no", you will get supported
-   * "no-\*" (Norwegian) and "nb-\*" (Norwegian Bokmal) voices; specifying "zh"
-   * will also get supported "cmn-\*" voices; specifying "zh-hk" will also get
-   * supported "yue-\*" voices.
+   * synthesize this language_code. E.g. when specifying `"en-NZ"`, you will get
+   * supported `"en-\*"` voices; when specifying `"no"`, you will get supported
+   * `"no-\*"` (Norwegian) and `"nb-\*"` (Norwegian Bokmal) voices; specifying
+   * `"zh"` will also get supported `"cmn-\*"` voices; specifying `"zh-hk"` will
+   * also get supported `"yue-\*"` voices.
    * </pre>
    *
    * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -150,11 +150,11 @@ public java.lang.String getLanguageCode() {
    * Optional. Recommended.
    * [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
    * specified, the ListVoices call will only return voices that can be used to
-   * synthesize this language_code. E.g. when specifying "en-NZ", you will get
-   * supported "en-&#92;*" voices; when specifying "no", you will get supported
-   * "no-&#92;*" (Norwegian) and "nb-&#92;*" (Norwegian Bokmal) voices; specifying "zh"
-   * will also get supported "cmn-&#92;*" voices; specifying "zh-hk" will also get
-   * supported "yue-&#92;*" voices.
+   * synthesize this language_code. E.g. when specifying `"en-NZ"`, you will get
+   * supported `"en-&#92;*"` voices; when specifying `"no"`, you will get supported
+   * `"no-&#92;*"` (Norwegian) and `"nb-&#92;*"` (Norwegian Bokmal) voices; specifying
+   * `"zh"` will also get supported `"cmn-&#92;*"` voices; specifying `"zh-hk"` will
+   * also get supported `"yue-&#92;*"` voices.
    * </pre>
    *
    * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -500,11 +500,11 @@ public Builder mergeFrom(
      * Optional. Recommended.
      * [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
      * specified, the ListVoices call will only return voices that can be used to
-     * synthesize this language_code. E.g. when specifying "en-NZ", you will get
-     * supported "en-&#92;*" voices; when specifying "no", you will get supported
-     * "no-&#92;*" (Norwegian) and "nb-&#92;*" (Norwegian Bokmal) voices; specifying "zh"
-     * will also get supported "cmn-&#92;*" voices; specifying "zh-hk" will also get
-     * supported "yue-&#92;*" voices.
+     * synthesize this language_code. E.g. when specifying `"en-NZ"`, you will get
+     * supported `"en-&#92;*"` voices; when specifying `"no"`, you will get supported
+     * `"no-&#92;*"` (Norwegian) and `"nb-&#92;*"` (Norwegian Bokmal) voices; specifying
+     * `"zh"` will also get supported `"cmn-&#92;*"` voices; specifying `"zh-hk"` will
+     * also get supported `"yue-&#92;*"` voices.
      * </pre>
      *
      * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -529,11 +529,11 @@ public java.lang.String getLanguageCode() {
      * Optional. Recommended.
      * [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
      * specified, the ListVoices call will only return voices that can be used to
-     * synthesize this language_code. E.g. when specifying "en-NZ", you will get
-     * supported "en-&#92;*" voices; when specifying "no", you will get supported
-     * "no-&#92;*" (Norwegian) and "nb-&#92;*" (Norwegian Bokmal) voices; specifying "zh"
-     * will also get supported "cmn-&#92;*" voices; specifying "zh-hk" will also get
-     * supported "yue-&#92;*" voices.
+     * synthesize this language_code. E.g. when specifying `"en-NZ"`, you will get
+     * supported `"en-&#92;*"` voices; when specifying `"no"`, you will get supported
+     * `"no-&#92;*"` (Norwegian) and `"nb-&#92;*"` (Norwegian Bokmal) voices; specifying
+     * `"zh"` will also get supported `"cmn-&#92;*"` voices; specifying `"zh-hk"` will
+     * also get supported `"yue-&#92;*"` voices.
      * </pre>
      *
      * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -558,11 +558,11 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
      * Optional. Recommended.
      * [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
      * specified, the ListVoices call will only return voices that can be used to
-     * synthesize this language_code. E.g. when specifying "en-NZ", you will get
-     * supported "en-&#92;*" voices; when specifying "no", you will get supported
-     * "no-&#92;*" (Norwegian) and "nb-&#92;*" (Norwegian Bokmal) voices; specifying "zh"
-     * will also get supported "cmn-&#92;*" voices; specifying "zh-hk" will also get
-     * supported "yue-&#92;*" voices.
+     * synthesize this language_code. E.g. when specifying `"en-NZ"`, you will get
+     * supported `"en-&#92;*"` voices; when specifying `"no"`, you will get supported
+     * `"no-&#92;*"` (Norwegian) and `"nb-&#92;*"` (Norwegian Bokmal) voices; specifying
+     * `"zh"` will also get supported `"cmn-&#92;*"` voices; specifying `"zh-hk"` will
+     * also get supported `"yue-&#92;*"` voices.
      * </pre>
      *
      * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -586,11 +586,11 @@ public Builder setLanguageCode(java.lang.String value) {
      * Optional. Recommended.
      * [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
      * specified, the ListVoices call will only return voices that can be used to
-     * synthesize this language_code. E.g. when specifying "en-NZ", you will get
-     * supported "en-&#92;*" voices; when specifying "no", you will get supported
-     * "no-&#92;*" (Norwegian) and "nb-&#92;*" (Norwegian Bokmal) voices; specifying "zh"
-     * will also get supported "cmn-&#92;*" voices; specifying "zh-hk" will also get
-     * supported "yue-&#92;*" voices.
+     * synthesize this language_code. E.g. when specifying `"en-NZ"`, you will get
+     * supported `"en-&#92;*"` voices; when specifying `"no"`, you will get supported
+     * `"no-&#92;*"` (Norwegian) and `"nb-&#92;*"` (Norwegian Bokmal) voices; specifying
+     * `"zh"` will also get supported `"cmn-&#92;*"` voices; specifying `"zh-hk"` will
+     * also get supported `"yue-&#92;*"` voices.
      * </pre>
      *
      * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -610,11 +610,11 @@ public Builder clearLanguageCode() {
      * Optional. Recommended.
      * [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
      * specified, the ListVoices call will only return voices that can be used to
-     * synthesize this language_code. E.g. when specifying "en-NZ", you will get
-     * supported "en-&#92;*" voices; when specifying "no", you will get supported
-     * "no-&#92;*" (Norwegian) and "nb-&#92;*" (Norwegian Bokmal) voices; specifying "zh"
-     * will also get supported "cmn-&#92;*" voices; specifying "zh-hk" will also get
-     * supported "yue-&#92;*" voices.
+     * synthesize this language_code. E.g. when specifying `"en-NZ"`, you will get
+     * supported `"en-&#92;*"` voices; when specifying `"no"`, you will get supported
+     * `"no-&#92;*"` (Norwegian) and `"nb-&#92;*"` (Norwegian Bokmal) voices; specifying
+     * `"zh"` will also get supported `"cmn-&#92;*"` voices; specifying `"zh-hk"` will
+     * also get supported `"yue-&#92;*"` voices.
      * </pre>
      *
      * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>

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

@@ -30,11 +30,11 @@ public interface ListVoicesRequestOrBuilder
    * Optional. Recommended.
    * [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
    * specified, the ListVoices call will only return voices that can be used to
-   * synthesize this language_code. E.g. when specifying "en-NZ", you will get
-   * supported "en-\*" voices; when specifying "no", you will get supported
-   * "no-\*" (Norwegian) and "nb-\*" (Norwegian Bokmal) voices; specifying "zh"
-   * will also get supported "cmn-\*" voices; specifying "zh-hk" will also get
-   * supported "yue-\*" voices.
+   * synthesize this language_code. E.g. when specifying `"en-NZ"`, you will get
+   * supported `"en-\*"` voices; when specifying `"no"`, you will get supported
+   * `"no-\*"` (Norwegian) and `"nb-\*"` (Norwegian Bokmal) voices; specifying
+   * `"zh"` will also get supported `"cmn-\*"` voices; specifying `"zh-hk"` will
+   * also get supported `"yue-\*"` voices.
    * </pre>
    *
    * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -49,11 +49,11 @@ public interface ListVoicesRequestOrBuilder
    * Optional. Recommended.
    * [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
    * specified, the ListVoices call will only return voices that can be used to
-   * synthesize this language_code. E.g. when specifying "en-NZ", you will get
-   * supported "en-&#92;*" voices; when specifying "no", you will get supported
-   * "no-&#92;*" (Norwegian) and "nb-&#92;*" (Norwegian Bokmal) voices; specifying "zh"
-   * will also get supported "cmn-&#92;*" voices; specifying "zh-hk" will also get
-   * supported "yue-&#92;*" voices.
+   * synthesize this language_code. E.g. when specifying `"en-NZ"`, you will get
+   * supported `"en-&#92;*"` voices; when specifying `"no"`, you will get supported
+   * `"no-&#92;*"` (Norwegian) and `"nb-&#92;*"` (Norwegian Bokmal) voices; specifying
+   * `"zh"` will also get supported `"cmn-&#92;*"` voices; specifying `"zh-hk"` will
+   * also get supported `"yue-&#92;*"` voices.
    * </pre>
    *
    * <code>string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];</code>

proto-google-cloud-texttospeech-v1/src/main/proto/google/cloud/texttospeech/v1/cloud_tts.proto

@@ -59,11 +59,11 @@ message ListVoicesRequest {
   // Optional. Recommended.
   // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
   // specified, the ListVoices call will only return voices that can be used to
-  // synthesize this language_code. E.g. when specifying "en-NZ", you will get
-  // supported "en-\*" voices; when specifying "no", you will get supported
-  // "no-\*" (Norwegian) and "nb-\*" (Norwegian Bokmal) voices; specifying "zh"
-  // will also get supported "cmn-\*" voices; specifying "zh-hk" will also get
-  // supported "yue-\*" voices.
+  // synthesize this language_code. E.g. when specifying `"en-NZ"`, you will get
+  // supported `"en-\*"` voices; when specifying `"no"`, you will get supported
+  // `"no-\*"` (Norwegian) and `"nb-\*"` (Norwegian Bokmal) voices; specifying
+  // `"zh"` will also get supported `"cmn-\*"` voices; specifying `"zh-hk"` will
+  // also get supported `"yue-\*"` voices.
   string language_code = 1 [(google.api.field_behavior) = OPTIONAL];
 }