docs: fix docstring formatting (#673)

- [ ] Regenerate this pull request now. Committer: @parthea PiperOrigin-RevId: 409547707 Source-Link: googleapis/googleapis@45a2c07 Source-Link: googleapis/googleapis-gen@99869d7 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiOTk4NjlkN2FiZmZiNzc5MWEwN2IyMTRlYTNjNWYyY2MwMDNlYzBiMCJ9
googleapis · Nov 15, 2021 · e097f59 · e097f59
1 parent e811e22
commit e097f59
Show file tree

Hide file tree

Showing 4 changed files with 22 additions and 2 deletions.
diff --git a/...oud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/ProjectsClient.java b/...oud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/ProjectsClient.java
@@ -461,14 +461,14 @@ public final UnaryCallable<ListProjectsRequest, ListProjectsResponse> listProjec
    *     &#42;key&#42; is the name of a label) | Filters by label name. | ```
    *     <p>Search expressions are case insensitive.
    *     <p>Some examples queries:
-   *     <p>| Query | Description |
+   *     <p>``` | Query | Description |
    *     |------------------|-----------------------------------------------------| | name:how&#42;
    *     | The project's name starts with "how". | | name:Howl | The project's name is `Howl` or
    *     `howl`. | | name:HOWL | Equivalent to above. | | NAME:howl | Equivalent to above. | |
    *     labels.color:&#42; | The project has the label `color`. | | labels.color:red | The
    *     project's label `color` has the value `red`. | | labels.color:red&amp;nbsp;labels.size:big
    *     | The project's label `color` has the value `red` and its label `size` has the value `big`.
-   *     |
+   *     | ```
    *     <p>If no query is specified, the call will return projects for which the user has the
    *     `resourcemanager.projects.get` permission.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails

diff --git a/...cemanager-v3/src/main/java/com/google/cloud/resourcemanager/v3/SearchProjectsRequest.java b/...cemanager-v3/src/main/java/com/google/cloud/resourcemanager/v3/SearchProjectsRequest.java
@@ -152,6 +152,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * ```
    * Search expressions are case insensitive.
    * Some examples queries:
+   * ```
    * | Query            | Description                                         |
    * |------------------|-----------------------------------------------------|
    * | name:how*        | The project's name starts with "how".               |
@@ -162,6 +163,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * | labels.color:red | The project's label `color` has the value `red`.    |
    * | labels.color:red&amp;nbsp;labels.size:big | The project's label `color` has
    * the value `red` and its label `size` has the value `big`.                |
+   * ```
    * If no query is specified, the call will return projects for which the user
    * has the `resourcemanager.projects.get` permission.
    * </pre>
@@ -206,6 +208,7 @@ public java.lang.String getQuery() {
    * ```
    * Search expressions are case insensitive.
    * Some examples queries:
+   * ```
    * | Query            | Description                                         |
    * |------------------|-----------------------------------------------------|
    * | name:how*        | The project's name starts with "how".               |
@@ -216,6 +219,7 @@ public java.lang.String getQuery() {
    * | labels.color:red | The project's label `color` has the value `red`.    |
    * | labels.color:red&amp;nbsp;labels.size:big | The project's label `color` has
    * the value `red` and its label `size` has the value `big`.                |
+   * ```
    * If no query is specified, the call will return projects for which the user
    * has the `resourcemanager.projects.get` permission.
    * </pre>
@@ -687,6 +691,7 @@ public Builder mergeFrom(
      * ```
      * Search expressions are case insensitive.
      * Some examples queries:
+     * ```
      * | Query            | Description                                         |
      * |------------------|-----------------------------------------------------|
      * | name:how*        | The project's name starts with "how".               |
@@ -697,6 +702,7 @@ public Builder mergeFrom(
      * | labels.color:red | The project's label `color` has the value `red`.    |
      * | labels.color:red&amp;nbsp;labels.size:big | The project's label `color` has
      * the value `red` and its label `size` has the value `big`.                |
+     * ```
      * If no query is specified, the call will return projects for which the user
      * has the `resourcemanager.projects.get` permission.
      * </pre>
@@ -740,6 +746,7 @@ public java.lang.String getQuery() {
      * ```
      * Search expressions are case insensitive.
      * Some examples queries:
+     * ```
      * | Query            | Description                                         |
      * |------------------|-----------------------------------------------------|
      * | name:how*        | The project's name starts with "how".               |
@@ -750,6 +757,7 @@ public java.lang.String getQuery() {
      * | labels.color:red | The project's label `color` has the value `red`.    |
      * | labels.color:red&amp;nbsp;labels.size:big | The project's label `color` has
      * the value `red` and its label `size` has the value `big`.                |
+     * ```
      * If no query is specified, the call will return projects for which the user
      * has the `resourcemanager.projects.get` permission.
      * </pre>
@@ -793,6 +801,7 @@ public com.google.protobuf.ByteString getQueryBytes() {
      * ```
      * Search expressions are case insensitive.
      * Some examples queries:
+     * ```
      * | Query            | Description                                         |
      * |------------------|-----------------------------------------------------|
      * | name:how*        | The project's name starts with "how".               |
@@ -803,6 +812,7 @@ public com.google.protobuf.ByteString getQueryBytes() {
      * | labels.color:red | The project's label `color` has the value `red`.    |
      * | labels.color:red&amp;nbsp;labels.size:big | The project's label `color` has
      * the value `red` and its label `size` has the value `big`.                |
+     * ```
      * If no query is specified, the call will return projects for which the user
      * has the `resourcemanager.projects.get` permission.
      * </pre>
@@ -845,6 +855,7 @@ public Builder setQuery(java.lang.String value) {
      * ```
      * Search expressions are case insensitive.
      * Some examples queries:
+     * ```
      * | Query            | Description                                         |
      * |------------------|-----------------------------------------------------|
      * | name:how*        | The project's name starts with "how".               |
@@ -855,6 +866,7 @@ public Builder setQuery(java.lang.String value) {
      * | labels.color:red | The project's label `color` has the value `red`.    |
      * | labels.color:red&amp;nbsp;labels.size:big | The project's label `color` has
      * the value `red` and its label `size` has the value `big`.                |
+     * ```
      * If no query is specified, the call will return projects for which the user
      * has the `resourcemanager.projects.get` permission.
      * </pre>
@@ -893,6 +905,7 @@ public Builder clearQuery() {
      * ```
      * Search expressions are case insensitive.
      * Some examples queries:
+     * ```
      * | Query            | Description                                         |
      * |------------------|-----------------------------------------------------|
      * | name:how*        | The project's name starts with "how".               |
@@ -903,6 +916,7 @@ public Builder clearQuery() {
      * | labels.color:red | The project's label `color` has the value `red`.    |
      * | labels.color:red&amp;nbsp;labels.size:big | The project's label `color` has
      * the value `red` and its label `size` has the value `big`.                |
+     * ```
      * If no query is specified, the call will return projects for which the user
      * has the `resourcemanager.projects.get` permission.
      * </pre>

diff --git a/...-v3/src/main/java/com/google/cloud/resourcemanager/v3/SearchProjectsRequestOrBuilder.java b/...-v3/src/main/java/com/google/cloud/resourcemanager/v3/SearchProjectsRequestOrBuilder.java
@@ -47,6 +47,7 @@ public interface SearchProjectsRequestOrBuilder
    * ```
    * Search expressions are case insensitive.
    * Some examples queries:
+   * ```
    * | Query            | Description                                         |
    * |------------------|-----------------------------------------------------|
    * | name:how*        | The project's name starts with "how".               |
@@ -57,6 +58,7 @@ public interface SearchProjectsRequestOrBuilder
    * | labels.color:red | The project's label `color` has the value `red`.    |
    * | labels.color:red&amp;nbsp;labels.size:big | The project's label `color` has
    * the value `red` and its label `size` has the value `big`.                |
+   * ```
    * If no query is specified, the call will return projects for which the user
    * has the `resourcemanager.projects.get` permission.
    * </pre>
@@ -90,6 +92,7 @@ public interface SearchProjectsRequestOrBuilder
    * ```
    * Search expressions are case insensitive.
    * Some examples queries:
+   * ```
    * | Query            | Description                                         |
    * |------------------|-----------------------------------------------------|
    * | name:how*        | The project's name starts with "how".               |
@@ -100,6 +103,7 @@ public interface SearchProjectsRequestOrBuilder
    * | labels.color:red | The project's label `color` has the value `red`.    |
    * | labels.color:red&amp;nbsp;labels.size:big | The project's label `color` has
    * the value `red` and its label `size` has the value `big`.                |
+   * ```
    * If no query is specified, the call will return projects for which the user
    * has the `resourcemanager.projects.get` permission.
    * </pre>

diff --git a/...le-cloud-resourcemanager-v3/src/main/proto/google/cloud/resourcemanager/v3/projects.proto b/...le-cloud-resourcemanager-v3/src/main/proto/google/cloud/resourcemanager/v3/projects.proto
@@ -466,6 +466,7 @@ message SearchProjectsRequest {
   //
   // Some examples queries:
   //
+  // ```
   // | Query            | Description                                         |
   // |------------------|-----------------------------------------------------|
   // | name:how*        | The project's name starts with "how".               |
@@ -476,6 +477,7 @@ message SearchProjectsRequest {
   // | labels.color:red | The project's label `color` has the value `red`.    |
   // | labels.color:red&nbsp;labels.size:big | The project's label `color` has
   // the value `red` and its label `size` has the value `big`.                |
+  // ```
   //
   // If no query is specified, the call will return projects for which the user
   // has the `resourcemanager.projects.get` permission.