From 93235503915ec6848300d05baa9c7e6a64363331 Mon Sep 17 00:00:00 2001
From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com>
Date: Tue, 28 Dec 2021 20:48:22 +0000
Subject: [PATCH] docs: update comments for ListVoicesRequest (#611)
- [ ] Regenerate this pull request now.
PiperOrigin-RevId: 417752787
Source-Link: https://github.com/googleapis/googleapis/commit/3e584174cda84c9f853318b9ac95e5037eaedd5b
Source-Link: https://github.com/googleapis/googleapis-gen/commit/e9ad9d638600638a00b072ffa8d418a7898f2d46
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZTlhZDlkNjM4NjAwNjM4YTAwYjA3MmZmYThkNDE4YTc4OThmMmQ0NiJ9
---
.../v1beta1/TextToSpeechClient.java | 8 +--
.../v1beta1/ListVoicesRequest.java | 63 +++++++++----------
.../v1beta1/ListVoicesRequestOrBuilder.java | 18 +++---
.../texttospeech/v1beta1/cloud_tts.proto | 9 ++-
4 files changed, 43 insertions(+), 55 deletions(-)
diff --git a/google-cloud-texttospeech/src/main/java/com/google/cloud/texttospeech/v1beta1/TextToSpeechClient.java b/google-cloud-texttospeech/src/main/java/com/google/cloud/texttospeech/v1beta1/TextToSpeechClient.java
index 20e524fc..c000f2bc 100644
--- a/google-cloud-texttospeech/src/main/java/com/google/cloud/texttospeech/v1beta1/TextToSpeechClient.java
+++ b/google-cloud-texttospeech/src/main/java/com/google/cloud/texttospeech/v1beta1/TextToSpeechClient.java
@@ -154,11 +154,9 @@ 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. For example, if you specify
+ * `"en-NZ"`, all `"en-NZ"` voices will be returned. If you specify `"no"`, both
+ * `"no-\\*"` (Norwegian) and `"nb-\\*"` (Norwegian Bokmal) voices will be returned.
* @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-v1beta1/src/main/java/com/google/cloud/texttospeech/v1beta1/ListVoicesRequest.java b/proto-google-cloud-texttospeech-v1beta1/src/main/java/com/google/cloud/texttospeech/v1beta1/ListVoicesRequest.java
index e429442c..3581ad5f 100644
--- a/proto-google-cloud-texttospeech-v1beta1/src/main/java/com/google/cloud/texttospeech/v1beta1/ListVoicesRequest.java
+++ b/proto-google-cloud-texttospeech-v1beta1/src/main/java/com/google/cloud/texttospeech/v1beta1/ListVoicesRequest.java
@@ -121,11 +121,10 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
* [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.
+ * to synthesize this language_code. For example, if you specify `"en-NZ"`,
+ * all `"en-NZ"` voices will be returned. If you specify `"no"`, both
+ * `"no-\*"` (Norwegian) and `"nb-\*"` (Norwegian Bokmal) voices will be
+ * returned.
*
*
* string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -152,11 +151,10 @@ public java.lang.String getLanguageCode() {
* [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.
+ * to synthesize this language_code. For example, if you specify `"en-NZ"`,
+ * all `"en-NZ"` voices will be returned. If you specify `"no"`, both
+ * `"no-\*"` (Norwegian) and `"nb-\*"` (Norwegian Bokmal) voices will be
+ * returned.
*
*
* string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -504,11 +502,10 @@ public Builder mergeFrom(
* [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.
+ * to synthesize this language_code. For example, if you specify `"en-NZ"`,
+ * all `"en-NZ"` voices will be returned. If you specify `"no"`, both
+ * `"no-\*"` (Norwegian) and `"nb-\*"` (Norwegian Bokmal) voices will be
+ * returned.
*
*
* string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -534,11 +531,10 @@ public java.lang.String getLanguageCode() {
* [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.
+ * to synthesize this language_code. For example, if you specify `"en-NZ"`,
+ * all `"en-NZ"` voices will be returned. If you specify `"no"`, both
+ * `"no-\*"` (Norwegian) and `"nb-\*"` (Norwegian Bokmal) voices will be
+ * returned.
*
*
* string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -564,11 +560,10 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
* [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.
+ * to synthesize this language_code. For example, if you specify `"en-NZ"`,
+ * all `"en-NZ"` voices will be returned. If you specify `"no"`, both
+ * `"no-\*"` (Norwegian) and `"nb-\*"` (Norwegian Bokmal) voices will be
+ * returned.
*
*
* string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -593,11 +588,10 @@ public Builder setLanguageCode(java.lang.String value) {
* [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.
+ * to synthesize this language_code. For example, if you specify `"en-NZ"`,
+ * all `"en-NZ"` voices will be returned. If you specify `"no"`, both
+ * `"no-\*"` (Norwegian) and `"nb-\*"` (Norwegian Bokmal) voices will be
+ * returned.
*
*
* string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -618,11 +612,10 @@ public Builder clearLanguageCode() {
* [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.
+ * to synthesize this language_code. For example, if you specify `"en-NZ"`,
+ * all `"en-NZ"` voices will be returned. If you specify `"no"`, both
+ * `"no-\*"` (Norwegian) and `"nb-\*"` (Norwegian Bokmal) voices will be
+ * returned.
*
*
* string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-texttospeech-v1beta1/src/main/java/com/google/cloud/texttospeech/v1beta1/ListVoicesRequestOrBuilder.java b/proto-google-cloud-texttospeech-v1beta1/src/main/java/com/google/cloud/texttospeech/v1beta1/ListVoicesRequestOrBuilder.java
index 66177312..5acb975b 100644
--- a/proto-google-cloud-texttospeech-v1beta1/src/main/java/com/google/cloud/texttospeech/v1beta1/ListVoicesRequestOrBuilder.java
+++ b/proto-google-cloud-texttospeech-v1beta1/src/main/java/com/google/cloud/texttospeech/v1beta1/ListVoicesRequestOrBuilder.java
@@ -31,11 +31,10 @@ public interface ListVoicesRequestOrBuilder
* [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.
+ * to synthesize this language_code. For example, if you specify `"en-NZ"`,
+ * all `"en-NZ"` voices will be returned. If you specify `"no"`, both
+ * `"no-\*"` (Norwegian) and `"nb-\*"` (Norwegian Bokmal) voices will be
+ * returned.
*
*
* string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -51,11 +50,10 @@ public interface ListVoicesRequestOrBuilder
* [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.
+ * to synthesize this language_code. For example, if you specify `"en-NZ"`,
+ * all `"en-NZ"` voices will be returned. If you specify `"no"`, both
+ * `"no-\*"` (Norwegian) and `"nb-\*"` (Norwegian Bokmal) voices will be
+ * returned.
*
*
* string language_code = 1 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-texttospeech-v1beta1/src/main/proto/google/cloud/texttospeech/v1beta1/cloud_tts.proto b/proto-google-cloud-texttospeech-v1beta1/src/main/proto/google/cloud/texttospeech/v1beta1/cloud_tts.proto
index 55a62bf8..4fdd68b2 100644
--- a/proto-google-cloud-texttospeech-v1beta1/src/main/proto/google/cloud/texttospeech/v1beta1/cloud_tts.proto
+++ b/proto-google-cloud-texttospeech-v1beta1/src/main/proto/google/cloud/texttospeech/v1beta1/cloud_tts.proto
@@ -64,11 +64,10 @@ message ListVoicesRequest {
// [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.
+ // to synthesize this language_code. For example, if you specify `"en-NZ"`,
+ // all `"en-NZ"` voices will be returned. If you specify `"no"`, both
+ // `"no-\*"` (Norwegian) and `"nb-\*"` (Norwegian Bokmal) voices will be
+ // returned.
string language_code = 1 [(google.api.field_behavior) = OPTIONAL];
}