docs: update comments for ListVoicesRequest (#581)

PiperOrigin-RevId: 424942023
Source-Link: googleapis/googleapis@8ce1934
Source-Link: googleapis/googleapis-gen@40dbea3
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNDBkYmVhMzQyNTRhYWVkYmUyZjhjNDgzYTU0ZTMyZDA3NWQ1ZmVkOSJ9
See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md
Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Benjamin E. Coe <[email protected]>

Author: gcf-owl-bot[bot]

packages/google-cloud-texttospeech/protos/google/cloud/texttospeech/v1/cloud_tts.proto

@@ -61,13 +61,13 @@ service TextToSpeech {
 // The top-level message sent by the client for the `ListVoices` method.
 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.
+  // [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. 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];
 }
 

packages/google-cloud-texttospeech/samples/generated/v1/text_to_speech.list_voices.js

@@ -22,13 +22,13 @@ function main() {
    */
   /**
    *  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.
+   *  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. 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.
    */
   // const languageCode = 'abc123'
 

packages/google-cloud-texttospeech/src/v1/text_to_speech_client.ts

@@ -288,13 +288,13 @@ export class TextToSpeechClient {
    *   The request object that will be sent.
    * @param {string} [request.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.
+   *   [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. 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.
    * @param {object} [options]
    *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
    * @returns {Promise} - The promise which resolves to an array.