docs: escape * characters in comments

README.md

@@ -17,7 +17,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>8.0.0</version>
+      <version>8.1.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>

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

@@ -159,10 +159,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/v1beta1/TextToSpeechClient.java

@@ -159,10 +159,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) {

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

@@ -121,10 +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
    * 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.
+   * 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>
@@ -151,10 +151,10 @@ public java.lang.String getLanguageCode() {
    * [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.
+   * 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>
@@ -501,10 +501,10 @@ public Builder mergeFrom(
      * [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.
+     * 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>
@@ -530,10 +530,10 @@ public java.lang.String getLanguageCode() {
      * [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.
+     * 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>
@@ -559,10 +559,10 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
      * [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.
+     * 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>
@@ -587,10 +587,10 @@ public Builder setLanguageCode(java.lang.String value) {
      * [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.
+     * 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>
@@ -611,10 +611,10 @@ public Builder clearLanguageCode() {
      * [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.
+     * 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

@@ -31,10 +31,10 @@ public interface ListVoicesRequestOrBuilder
    * [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.
+   * 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>
@@ -50,10 +50,10 @@ public interface ListVoicesRequestOrBuilder
    * [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.
+   * 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

@@ -60,10 +60,10 @@ message ListVoicesRequest {
   // [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.
+  // 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];
 }
 

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

@@ -121,10 +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
    * 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.
+   * 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>
@@ -151,10 +151,10 @@ public java.lang.String getLanguageCode() {
    * [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.
+   * 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>
@@ -502,10 +502,10 @@ public Builder mergeFrom(
      * [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.
+     * 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>
@@ -531,10 +531,10 @@ public java.lang.String getLanguageCode() {
      * [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.
+     * 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>
@@ -560,10 +560,10 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
      * [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.
+     * 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>
@@ -588,10 +588,10 @@ public Builder setLanguageCode(java.lang.String value) {
      * [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.
+     * 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>
@@ -612,10 +612,10 @@ public Builder clearLanguageCode() {
      * [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.
+     * 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>