From 4c445df0d562fdf3a0882e88f4f79fbf7de02343 Mon Sep 17 00:00:00 2001
From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com>
Date: Mon, 15 Nov 2021 16:28:25 +0000
Subject: [PATCH] docs: fix docstring formatting (#597)
- [ ] Regenerate this pull request now.
Committer: @parthea
PiperOrigin-RevId: 409547475
Source-Link: https://github.com/googleapis/googleapis/commit/4be99b038bde3ab92afe76f6e3a817742cf828e4
Source-Link: https://github.com/googleapis/googleapis-gen/commit/55a8479e1d4d514e4e3ccfe1f855067d1412f401
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNTVhODQ3OWUxZDRkNTE0ZTRlM2NjZmUxZjg1NTA2N2QxNDEyZjQwMSJ9
---
.../texttospeech/v1/TextToSpeechClient.java | 8 +--
.../texttospeech/v1/ListVoicesRequest.java | 70 +++++++++----------
.../v1/ListVoicesRequestOrBuilder.java | 20 +++---
.../cloud/texttospeech/v1/cloud_tts.proto | 10 +--
4 files changed, 54 insertions(+), 54 deletions(-)
diff --git a/google-cloud-texttospeech/src/main/java/com/google/cloud/texttospeech/v1/TextToSpeechClient.java b/google-cloud-texttospeech/src/main/java/com/google/cloud/texttospeech/v1/TextToSpeechClient.java
index c51ee62d..36aa5929 100644
--- a/google-cloud-texttospeech/src/main/java/com/google/cloud/texttospeech/v1/TextToSpeechClient.java
+++ b/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) {
diff --git a/proto-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/ListVoicesRequest.java b/proto-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/ListVoicesRequest.java
index 3413baa9..19967c29 100644
--- a/proto-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/ListVoicesRequest.java
+++ b/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.
*
*
* string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -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-\*" 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];
@@ -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-\*" 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];
@@ -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-\*" 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];
@@ -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-\*" 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];
@@ -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-\*" 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];
@@ -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-\*" 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];
diff --git a/proto-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/ListVoicesRequestOrBuilder.java b/proto-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/ListVoicesRequestOrBuilder.java
index d71890d9..ce0b67b6 100644
--- a/proto-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/ListVoicesRequestOrBuilder.java
+++ b/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.
*
*
* string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -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-\*" 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];
diff --git a/proto-google-cloud-texttospeech-v1/src/main/proto/google/cloud/texttospeech/v1/cloud_tts.proto b/proto-google-cloud-texttospeech-v1/src/main/proto/google/cloud/texttospeech/v1/cloud_tts.proto
index ebcf44d8..7eec1ef4 100644
--- a/proto-google-cloud-texttospeech-v1/src/main/proto/google/cloud/texttospeech/v1/cloud_tts.proto
+++ b/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];
}