docs: fix docstring formatting (#218)

* docs: fix docstring formatting

Committer: @parthea
PiperOrigin-RevId: 409547475

Source-Link: googleapis/googleapis@4be99b0

Source-Link: https://github.com/googleapis/googleapis-gen/commit/55a8479e1d4d514e4e3ccfe1f855067d1412f401
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNTVhODQ3OWUxZDRkNTE0ZTRlM2NjZmUxZjg1NTA2N2QxNDEyZjQwMSJ9

* 🦉 Updates from OwlBot

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* remove workarounds in owlbot.py

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Anthonios Partheniou <[email protected]>

Author: gcf-owl-bot[bot]

google/cloud/texttospeech_v1/services/text_to_speech/async_client.py

@@ -179,12 +179,13 @@ async def list_voices(
                 `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.
+                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.
 
                 This corresponds to the ``language_code`` field
                 on the ``request`` instance; if ``request`` is provided, this

google/cloud/texttospeech_v1/services/text_to_speech/client.py

@@ -359,12 +359,13 @@ def list_voices(
                 `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.
+                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.
 
                 This corresponds to the ``language_code`` field
                 on the ``request`` instance; if ``request`` is provided, this

google/cloud/texttospeech_v1/types/cloud_tts.py

@@ -63,12 +63,12 @@ class ListVoicesRequest(proto.Message):
             `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.
+            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.
     """
 
     language_code = proto.Field(proto.STRING, number=1,)

owlbot.py

@@ -24,13 +24,6 @@
 default_version = "v1"
 
 for library in s.get_staging_dirs(default_version):
-    # Sphinx interprets `*` as emphasis
-    s.replace(
-        [library / "google/cloud/**/*client.py", library / "google/cloud/**/cloud_tts.py"],
-        "((en)|(no)|(nb)|(cmn)|(yue))-\*",
-        "\g<1>-\*",
-    )
-
     s.move(library, excludes=["setup.py", "docs/index.rst", "README.rst"])
 
 s.remove_staging_dirs()