docs: fix docstring formatting (#597)

- [ ] Regenerate this pull request now. Committer: @parthea PiperOrigin-RevId: 409547475 Source-Link: googleapis/googleapis@4be99b0 Source-Link: googleapis/googleapis-gen@55a8479 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNTVhODQ3OWUxZDRkNTE0ZTRlM2NjZmUxZjg1NTA2N2QxNDEyZjQwMSJ9
googleapis · Nov 15, 2021 · 4c445df · 4c445df
1 parent e00e27a
commit 4c445df
Show file tree

Hide file tree

Showing 4 changed files with 54 additions and 54 deletions.
diff --git a/...cloud-texttospeech/src/main/java/com/google/cloud/texttospeech/v1/TextToSpeechClient.java b/...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-\\&#42;" voices; when specifying
-   *     "no", you will get supported "no-\\&#42;" (Norwegian) and "nb-\\&#42;" (Norwegian Bokmal)
-   *     voices; specifying "zh" will also get supported "cmn-\\&#42;" voices; specifying "zh-hk"
-   *     will also get supported "yue-\\&#42;" voices.
+   *     E.g. when specifying `"en-NZ"`, you will get supported `"en-\\&#42;"` voices; when
+   *     specifying `"no"`, you will get supported `"no-\\&#42;"` (Norwegian) and `"nb-\\&#42;"`
+   *     (Norwegian Bokmal) voices; specifying `"zh"` will also get supported `"cmn-\\&#42;"`
+   *     voices; specifying `"zh-hk"` will also get supported `"yue-\\&#42;"` voices.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListVoicesResponse listVoices(String languageCode) {

diff --git a/...oud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/ListVoicesRequest.java b/...oud-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-&#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>
@@ -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>

diff --git a/...ospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/ListVoicesRequestOrBuilder.java b/...ospeech-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-&#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>
@@ -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>

diff --git a/...-google-cloud-texttospeech-v1/src/main/proto/google/cloud/texttospeech/v1/cloud_tts.proto b/...-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];
 }