docs: [tpu] fix minor docstring formatting (#8920)

- [ ] Regenerate this pull request now. PiperOrigin-RevId: 495593544 Source-Link: https://togithub.com/googleapis/googleapis/commit/ea5238289be2ee79da957bfdd6c3e73e497d5bd1 Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/db6462edfe50c0b93f491e094e748f0daa61d398 Copy-Tag: eyJwIjoiamF2YS10cHUvLk93bEJvdC55YW1sIiwiaCI6ImRiNjQ2MmVkZmU1MGMwYjkzZjQ5MWUwOTRlNzQ4ZjBkYWE2MWQzOTgifQ==
googleapis · Dec 20, 2022 · 1ed54ab · 1ed54ab
1 parent 91aac16
commit 1ed54ab
Show file tree

Hide file tree

Showing 23 changed files with 204 additions and 162 deletions.
diff --git a/java-tpu/README.md b/java-tpu/README.md
@@ -19,20 +19,20 @@ If you are using Maven, add this to your pom.xml file:
 <dependency>
   <groupId>com.google.cloud</groupId>
   <artifactId>google-cloud-tpu</artifactId>
-  <version>2.7.0</version>
+  <version>2.8.0</version>
 </dependency>
 ```
 
 If you are using Gradle without BOM, add this to your dependencies:
 
 ```Groovy
-implementation 'com.google.cloud:google-cloud-tpu:2.7.0'
+implementation 'com.google.cloud:google-cloud-tpu:2.8.0'
 ```
 
 If you are using SBT, add this to your dependencies:
 
 ```Scala
-libraryDependencies += "com.google.cloud" % "google-cloud-tpu" % "2.7.0"
+libraryDependencies += "com.google.cloud" % "google-cloud-tpu" % "2.8.0"
 ```
 
 ## Authentication

diff --git a/java-tpu/google-cloud-tpu/src/main/java/com/google/cloud/tpu/v2alpha1/TpuClient.java b/java-tpu/google-cloud-tpu/src/main/java/com/google/cloud/tpu/v2alpha1/TpuClient.java
@@ -1336,7 +1336,7 @@ public final UnaryCallable<GetQueuedResourceRequest, QueuedResource> getQueuedRe
    *
    * @param parent Required. The parent resource name.
    * @param queuedResource Required. The queued resource.
-   * @param queuedResourceId The unqualified resource name. Should follow the ^[A-Za-z0-9_.~+%-]+$
+   * @param queuedResourceId The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+$`
    *     regex format.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -1374,7 +1374,7 @@ public final OperationFuture<QueuedResource, OperationMetadata> createQueuedReso
    *
    * @param parent Required. The parent resource name.
    * @param queuedResource Required. The queued resource.
-   * @param queuedResourceId The unqualified resource name. Should follow the ^[A-Za-z0-9_.~+%-]+$
+   * @param queuedResourceId The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+$`
    *     regex format.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */

diff --git a/...tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/CreateQueuedResourceRequest.java b/...tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/CreateQueuedResourceRequest.java
@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Request for [CreateQueuedResource][google.cloud.tpu.v2alpha1.Tpu.CreateQueuedResource].
+ * Request for
+ * [CreateQueuedResource][google.cloud.tpu.v2alpha1.Tpu.CreateQueuedResource].
  * </pre>
  *
  * Protobuf type {@code google.cloud.tpu.v2alpha1.CreateQueuedResourceRequest}
@@ -128,7 +129,7 @@ public com.google.protobuf.ByteString getParentBytes() {
    *
    *
    * <pre>
-   * The unqualified resource name. Should follow the ^[A-Za-z0-9_.~+%-]+$
+   * The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+$`
    * regex format.
    * </pre>
    *
@@ -152,7 +153,7 @@ public java.lang.String getQueuedResourceId() {
    *
    *
    * <pre>
-   * The unqualified resource name. Should follow the ^[A-Za-z0-9_.~+%-]+$
+   * The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+$`
    * regex format.
    * </pre>
    *
@@ -472,7 +473,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Request for [CreateQueuedResource][google.cloud.tpu.v2alpha1.Tpu.CreateQueuedResource].
+   * Request for
+   * [CreateQueuedResource][google.cloud.tpu.v2alpha1.Tpu.CreateQueuedResource].
    * </pre>
    *
    * Protobuf type {@code google.cloud.tpu.v2alpha1.CreateQueuedResourceRequest}
@@ -806,7 +808,7 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      *
      *
      * <pre>
-     * The unqualified resource name. Should follow the ^[A-Za-z0-9_.~+%-]+$
+     * The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+$`
      * regex format.
      * </pre>
      *
@@ -829,7 +831,7 @@ public java.lang.String getQueuedResourceId() {
      *
      *
      * <pre>
-     * The unqualified resource name. Should follow the ^[A-Za-z0-9_.~+%-]+$
+     * The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+$`
      * regex format.
      * </pre>
      *
@@ -852,7 +854,7 @@ public com.google.protobuf.ByteString getQueuedResourceIdBytes() {
      *
      *
      * <pre>
-     * The unqualified resource name. Should follow the ^[A-Za-z0-9_.~+%-]+$
+     * The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+$`
      * regex format.
      * </pre>
      *
@@ -874,7 +876,7 @@ public Builder setQueuedResourceId(java.lang.String value) {
      *
      *
      * <pre>
-     * The unqualified resource name. Should follow the ^[A-Za-z0-9_.~+%-]+$
+     * The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+$`
      * regex format.
      * </pre>
      *
@@ -892,7 +894,7 @@ public Builder clearQueuedResourceId() {
      *
      *
      * <pre>
-     * The unqualified resource name. Should follow the ^[A-Za-z0-9_.~+%-]+$
+     * The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+$`
      * regex format.
      * </pre>
      *

diff --git a/...ha1/src/main/java/com/google/cloud/tpu/v2alpha1/CreateQueuedResourceRequestOrBuilder.java b/...ha1/src/main/java/com/google/cloud/tpu/v2alpha1/CreateQueuedResourceRequestOrBuilder.java
@@ -56,7 +56,7 @@ public interface CreateQueuedResourceRequestOrBuilder
    *
    *
    * <pre>
-   * The unqualified resource name. Should follow the ^[A-Za-z0-9_.~+%-]+$
+   * The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+$`
    * regex format.
    * </pre>
    *
@@ -69,7 +69,7 @@ public interface CreateQueuedResourceRequestOrBuilder
    *
    *
    * <pre>
-   * The unqualified resource name. Should follow the ^[A-Za-z0-9_.~+%-]+$
+   * The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+$`
    * regex format.
    * </pre>
    *

diff --git a/...tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/DeleteQueuedResourceRequest.java b/...tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/DeleteQueuedResourceRequest.java
@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Request for [DeleteQueuedResource][google.cloud.tpu.v2alpha1.Tpu.DeleteQueuedResource].
+ * Request for
+ * [DeleteQueuedResource][google.cloud.tpu.v2alpha1.Tpu.DeleteQueuedResource].
  * </pre>
  *
  * Protobuf type {@code google.cloud.tpu.v2alpha1.DeleteQueuedResourceRequest}
@@ -343,7 +344,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Request for [DeleteQueuedResource][google.cloud.tpu.v2alpha1.Tpu.DeleteQueuedResource].
+   * Request for
+   * [DeleteQueuedResource][google.cloud.tpu.v2alpha1.Tpu.DeleteQueuedResource].
    * </pre>
    *
    * Protobuf type {@code google.cloud.tpu.v2alpha1.DeleteQueuedResourceRequest}

diff --git a/...-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GenerateServiceIdentityRequest.java b/...-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GenerateServiceIdentityRequest.java
@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Request for [GenerateServiceIdentity][google.cloud.tpu.v2alpha1.Tpu.GenerateServiceIdentity].
+ * Request for
+ * [GenerateServiceIdentity][google.cloud.tpu.v2alpha1.Tpu.GenerateServiceIdentity].
  * </pre>
  *
  * Protobuf type {@code google.cloud.tpu.v2alpha1.GenerateServiceIdentityRequest}
@@ -285,7 +286,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Request for [GenerateServiceIdentity][google.cloud.tpu.v2alpha1.Tpu.GenerateServiceIdentity].
+   * Request for
+   * [GenerateServiceIdentity][google.cloud.tpu.v2alpha1.Tpu.GenerateServiceIdentity].
    * </pre>
    *
    * Protobuf type {@code google.cloud.tpu.v2alpha1.GenerateServiceIdentityRequest}

diff --git a/...v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GenerateServiceIdentityResponse.java b/...v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GenerateServiceIdentityResponse.java
@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Response for [GenerateServiceIdentity][google.cloud.tpu.v2alpha1.Tpu.GenerateServiceIdentity].
+ * Response for
+ * [GenerateServiceIdentity][google.cloud.tpu.v2alpha1.Tpu.GenerateServiceIdentity].
  * </pre>
  *
  * Protobuf type {@code google.cloud.tpu.v2alpha1.GenerateServiceIdentityResponse}
@@ -283,7 +284,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Response for [GenerateServiceIdentity][google.cloud.tpu.v2alpha1.Tpu.GenerateServiceIdentity].
+   * Response for
+   * [GenerateServiceIdentity][google.cloud.tpu.v2alpha1.Tpu.GenerateServiceIdentity].
    * </pre>
    *
    * Protobuf type {@code google.cloud.tpu.v2alpha1.GenerateServiceIdentityResponse}

diff --git a/...d-tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GetAcceleratorTypeRequest.java b/...d-tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GetAcceleratorTypeRequest.java
@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Request for [GetAcceleratorType][google.cloud.tpu.v2alpha1.Tpu.GetAcceleratorType].
+ * Request for
+ * [GetAcceleratorType][google.cloud.tpu.v2alpha1.Tpu.GetAcceleratorType].
  * </pre>
  *
  * Protobuf type {@code google.cloud.tpu.v2alpha1.GetAcceleratorTypeRequest}
@@ -284,7 +285,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Request for [GetAcceleratorType][google.cloud.tpu.v2alpha1.Tpu.GetAcceleratorType].
+   * Request for
+   * [GetAcceleratorType][google.cloud.tpu.v2alpha1.Tpu.GetAcceleratorType].
    * </pre>
    *
    * Protobuf type {@code google.cloud.tpu.v2alpha1.GetAcceleratorTypeRequest}

diff --git a/...d-tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GetGuestAttributesRequest.java b/...d-tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GetGuestAttributesRequest.java
@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Request for [GetGuestAttributes][google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes].
+ * Request for
+ * [GetGuestAttributes][google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes].
  * </pre>
  *
  * Protobuf type {@code google.cloud.tpu.v2alpha1.GetGuestAttributesRequest}
@@ -425,7 +426,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Request for [GetGuestAttributes][google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes].
+   * Request for
+   * [GetGuestAttributes][google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes].
    * </pre>
    *
    * Protobuf type {@code google.cloud.tpu.v2alpha1.GetGuestAttributesRequest}

diff --git a/...-tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GetGuestAttributesResponse.java b/...-tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GetGuestAttributesResponse.java
@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Response for [GetGuestAttributes][google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes].
+ * Response for
+ * [GetGuestAttributes][google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes].
  * </pre>
  *
  * Protobuf type {@code google.cloud.tpu.v2alpha1.GetGuestAttributesResponse}
@@ -303,7 +304,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Response for [GetGuestAttributes][google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes].
+   * Response for
+   * [GetGuestAttributes][google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes].
    * </pre>
    *
    * Protobuf type {@code google.cloud.tpu.v2alpha1.GetGuestAttributesResponse}

diff --git a/...ud-tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GetQueuedResourceRequest.java b/...ud-tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GetQueuedResourceRequest.java
@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Request for [GetQueuedResource][google.cloud.tpu.v2alpha1.Tpu.GetQueuedResource]
+ * Request for
+ * [GetQueuedResource][google.cloud.tpu.v2alpha1.Tpu.GetQueuedResource]
  * </pre>
  *
  * Protobuf type {@code google.cloud.tpu.v2alpha1.GetQueuedResourceRequest}
@@ -284,7 +285,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Request for [GetQueuedResource][google.cloud.tpu.v2alpha1.Tpu.GetQueuedResource]
+   * Request for
+   * [GetQueuedResource][google.cloud.tpu.v2alpha1.Tpu.GetQueuedResource]
    * </pre>
    *
    * Protobuf type {@code google.cloud.tpu.v2alpha1.GetQueuedResourceRequest}

diff --git a/...ud-tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GetRuntimeVersionRequest.java b/...ud-tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/GetRuntimeVersionRequest.java
@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Request for [GetRuntimeVersion][google.cloud.tpu.v2alpha1.Tpu.GetRuntimeVersion].
+ * Request for
+ * [GetRuntimeVersion][google.cloud.tpu.v2alpha1.Tpu.GetRuntimeVersion].
  * </pre>
  *
  * Protobuf type {@code google.cloud.tpu.v2alpha1.GetRuntimeVersionRequest}
@@ -284,7 +285,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Request for [GetRuntimeVersion][google.cloud.tpu.v2alpha1.Tpu.GetRuntimeVersion].
+   * Request for
+   * [GetRuntimeVersion][google.cloud.tpu.v2alpha1.Tpu.GetRuntimeVersion].
    * </pre>
    *
    * Protobuf type {@code google.cloud.tpu.v2alpha1.GetRuntimeVersionRequest}

diff --git a/...tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/ListAcceleratorTypesRequest.java b/...tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/ListAcceleratorTypesRequest.java
@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Request for [ListAcceleratorTypes][google.cloud.tpu.v2alpha1.Tpu.ListAcceleratorTypes].
+ * Request for
+ * [ListAcceleratorTypes][google.cloud.tpu.v2alpha1.Tpu.ListAcceleratorTypes].
  * </pre>
  *
  * Protobuf type {@code google.cloud.tpu.v2alpha1.ListAcceleratorTypesRequest}
@@ -488,7 +489,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Request for [ListAcceleratorTypes][google.cloud.tpu.v2alpha1.Tpu.ListAcceleratorTypes].
+   * Request for
+   * [ListAcceleratorTypes][google.cloud.tpu.v2alpha1.Tpu.ListAcceleratorTypes].
    * </pre>
    *
    * Protobuf type {@code google.cloud.tpu.v2alpha1.ListAcceleratorTypesRequest}

diff --git a/...pu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/ListAcceleratorTypesResponse.java b/...pu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/ListAcceleratorTypesResponse.java
@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Response for [ListAcceleratorTypes][google.cloud.tpu.v2alpha1.Tpu.ListAcceleratorTypes].
+ * Response for
+ * [ListAcceleratorTypes][google.cloud.tpu.v2alpha1.Tpu.ListAcceleratorTypes].
  * </pre>
  *
  * Protobuf type {@code google.cloud.tpu.v2alpha1.ListAcceleratorTypesResponse}
@@ -440,7 +441,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Response for [ListAcceleratorTypes][google.cloud.tpu.v2alpha1.Tpu.ListAcceleratorTypes].
+   * Response for
+   * [ListAcceleratorTypes][google.cloud.tpu.v2alpha1.Tpu.ListAcceleratorTypes].
    * </pre>
    *
    * Protobuf type {@code google.cloud.tpu.v2alpha1.ListAcceleratorTypesResponse}

diff --git a/...-tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/ListQueuedResourcesRequest.java b/...-tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/ListQueuedResourcesRequest.java
@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Request for [ListQueuedResources][google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources].
+ * Request for
+ * [ListQueuedResources][google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources].
  * </pre>
  *
  * Protobuf type {@code google.cloud.tpu.v2alpha1.ListQueuedResourcesRequest}
@@ -370,7 +371,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Request for [ListQueuedResources][google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources].
+   * Request for
+   * [ListQueuedResources][google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources].
    * </pre>
    *
    * Protobuf type {@code google.cloud.tpu.v2alpha1.ListQueuedResourcesRequest}

diff --git a/...tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/ListQueuedResourcesResponse.java b/...tpu-v2alpha1/src/main/java/com/google/cloud/tpu/v2alpha1/ListQueuedResourcesResponse.java
@@ -22,7 +22,8 @@
  *
  *
  * <pre>
- * Response for [ListQueuedResources][google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources].
+ * Response for
+ * [ListQueuedResources][google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources].
  * </pre>
  *
  * Protobuf type {@code google.cloud.tpu.v2alpha1.ListQueuedResourcesResponse}
@@ -440,7 +441,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Response for [ListQueuedResources][google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources].
+   * Response for
+   * [ListQueuedResources][google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources].
    * </pre>
    *
    * Protobuf type {@code google.cloud.tpu.v2alpha1.ListQueuedResourcesResponse}