docs(regen): update generated documentation

.github/workflows/ci.yaml

@@ -0,0 +1,76 @@
+on:
+  push:
+    branches:
+    - master
+  pull_request:
+name: ci
+jobs:
+  units:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        java: [7, 8, 11]
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-java@v1
+      with:
+        java-version: ${{matrix.java}}
+    - run: java -version
+    - run: .kokoro/build.sh
+      env:
+        JOB_TYPE: test
+    - name: coverage
+      uses: codecov/codecov-action@v1
+      with:
+        name: actions ${{matrix.java}}
+  windows:
+    runs-on: windows-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-java@v1
+      with:
+        java-version: 8
+    - run: java -version
+    - run: .kokoro/build.bat
+      env:
+        JOB_TYPE: test
+  dependencies:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-java@v1
+      with:
+        java-version: 8
+    - run: java -version
+    - run: .kokoro/dependencies.sh
+  linkage-monitor:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-java@v1
+      with:
+        java-version: 8
+    - run: java -version
+    - run: .kokoro/linkage-monitor.sh
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-java@v1
+      with:
+        java-version: 8
+    - run: java -version
+    - run: .kokoro/build.sh
+      env:
+        JOB_TYPE: lint
+  clirr:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-java@v1
+      with:
+        java-version: 8
+    - run: java -version
+    - run: .kokoro/build.sh
+      env:
+        JOB_TYPE: clirr

.kokoro/build.bat

@@ -1,3 +1,3 @@
 :: See documentation in type-shell-output.bat
 
-"C:\Program Files\Git\bin\bash.exe" github/java-secretmanager/.kokoro/build.sh
+"C:\Program Files\Git\bin\bash.exe" %~dp0build.sh

google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1beta1/SecretManagerServiceClient.java

@@ -323,7 +323,8 @@ public final UnaryCallable<ListSecretsRequest, ListSecretsResponse> listSecretsC
    *     <p>A secret ID is a string with a maximum length of 255 characters and can contain
    *     uppercase and lowercase letters, numerals, and the hyphen (`-`) and underscore (`_`)
    *     characters.
-   * @param secret A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+   * @param secret Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field
+   *     values.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Secret createSecret(ProjectName parent, String secretId, Secret secret) {
@@ -358,7 +359,8 @@ public final Secret createSecret(ProjectName parent, String secretId, Secret sec
    *     <p>A secret ID is a string with a maximum length of 255 characters and can contain
    *     uppercase and lowercase letters, numerals, and the hyphen (`-`) and underscore (`_`)
    *     characters.
-   * @param secret A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+   * @param secret Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field
+   *     values.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Secret createSecret(String parent, String secretId, Secret secret) {
@@ -382,9 +384,11 @@ public final Secret createSecret(String parent, String secretId, Secret secret)
    * try (SecretManagerServiceClient secretManagerServiceClient = SecretManagerServiceClient.create()) {
    *   ProjectName parent = ProjectName.of("[PROJECT]");
    *   String secretId = "";
+   *   Secret secret = Secret.newBuilder().build();
    *   CreateSecretRequest request = CreateSecretRequest.newBuilder()
    *     .setParent(parent.toString())
    *     .setSecretId(secretId)
+   *     .setSecret(secret)
    *     .build();
    *   Secret response = secretManagerServiceClient.createSecret(request);
    * }
@@ -408,9 +412,11 @@ public final Secret createSecret(CreateSecretRequest request) {
    * try (SecretManagerServiceClient secretManagerServiceClient = SecretManagerServiceClient.create()) {
    *   ProjectName parent = ProjectName.of("[PROJECT]");
    *   String secretId = "";
+   *   Secret secret = Secret.newBuilder().build();
    *   CreateSecretRequest request = CreateSecretRequest.newBuilder()
    *     .setParent(parent.toString())
    *     .setSecretId(secretId)
+   *     .setSecret(secret)
    *     .build();
    *   ApiFuture&lt;Secret&gt; future = secretManagerServiceClient.createSecretCallable().futureCall(request);
    *   // Do something

proto-google-cloud-secretmanager-v1beta1/src/main/java/com/google/cloud/secretmanager/v1beta1/CreateSecretRequest.java

@@ -247,10 +247,12 @@ public com.google.protobuf.ByteString getSecretIdBytes() {
    *
    *
    * <pre>
-   * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+   * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
    * </pre>
    *
-   * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+   * <code>
+   * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+   * </code>
    *
    * @return Whether the secret field is set.
    */
@@ -261,10 +263,12 @@ public boolean hasSecret() {
    *
    *
    * <pre>
-   * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+   * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
    * </pre>
    *
-   * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+   * <code>
+   * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+   * </code>
    *
    * @return The secret.
    */
@@ -277,10 +281,12 @@ public com.google.cloud.secretmanager.v1beta1.Secret getSecret() {
    *
    *
    * <pre>
-   * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+   * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
    * </pre>
    *
-   * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+   * <code>
+   * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+   * </code>
    */
   public com.google.cloud.secretmanager.v1beta1.SecretOrBuilder getSecretOrBuilder() {
     return getSecret();
@@ -901,10 +907,12 @@ public Builder setSecretIdBytes(com.google.protobuf.ByteString value) {
      *
      *
      * <pre>
-     * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+     * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
      * </pre>
      *
-     * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+     * <code>
+     * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+     * </code>
      *
      * @return Whether the secret field is set.
      */
@@ -915,10 +923,12 @@ public boolean hasSecret() {
      *
      *
      * <pre>
-     * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+     * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
      * </pre>
      *
-     * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+     * <code>
+     * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+     * </code>
      *
      * @return The secret.
      */
@@ -935,10 +945,12 @@ public com.google.cloud.secretmanager.v1beta1.Secret getSecret() {
      *
      *
      * <pre>
-     * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+     * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
      * </pre>
      *
-     * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+     * <code>
+     * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+     * </code>
      */
     public Builder setSecret(com.google.cloud.secretmanager.v1beta1.Secret value) {
       if (secretBuilder_ == null) {
@@ -957,10 +969,12 @@ public Builder setSecret(com.google.cloud.secretmanager.v1beta1.Secret value) {
      *
      *
      * <pre>
-     * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+     * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
      * </pre>
      *
-     * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+     * <code>
+     * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+     * </code>
      */
     public Builder setSecret(
         com.google.cloud.secretmanager.v1beta1.Secret.Builder builderForValue) {
@@ -977,10 +991,12 @@ public Builder setSecret(
      *
      *
      * <pre>
-     * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+     * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
      * </pre>
      *
-     * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+     * <code>
+     * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+     * </code>
      */
     public Builder mergeSecret(com.google.cloud.secretmanager.v1beta1.Secret value) {
       if (secretBuilder_ == null) {
@@ -1003,10 +1019,12 @@ public Builder mergeSecret(com.google.cloud.secretmanager.v1beta1.Secret value)
      *
      *
      * <pre>
-     * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+     * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
      * </pre>
      *
-     * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+     * <code>
+     * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+     * </code>
      */
     public Builder clearSecret() {
       if (secretBuilder_ == null) {
@@ -1023,10 +1041,12 @@ public Builder clearSecret() {
      *
      *
      * <pre>
-     * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+     * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
      * </pre>
      *
-     * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+     * <code>
+     * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+     * </code>
      */
     public com.google.cloud.secretmanager.v1beta1.Secret.Builder getSecretBuilder() {
 
@@ -1037,10 +1057,12 @@ public com.google.cloud.secretmanager.v1beta1.Secret.Builder getSecretBuilder()
      *
      *
      * <pre>
-     * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+     * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
      * </pre>
      *
-     * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+     * <code>
+     * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+     * </code>
      */
     public com.google.cloud.secretmanager.v1beta1.SecretOrBuilder getSecretOrBuilder() {
       if (secretBuilder_ != null) {
@@ -1055,10 +1077,12 @@ public com.google.cloud.secretmanager.v1beta1.SecretOrBuilder getSecretOrBuilder
      *
      *
      * <pre>
-     * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+     * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
      * </pre>
      *
-     * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+     * <code>
+     * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+     * </code>
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.cloud.secretmanager.v1beta1.Secret,

proto-google-cloud-secretmanager-v1beta1/src/main/java/com/google/cloud/secretmanager/v1beta1/CreateSecretRequestOrBuilder.java

@@ -89,10 +89,12 @@ public interface CreateSecretRequestOrBuilder
    *
    *
    * <pre>
-   * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+   * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
    * </pre>
    *
-   * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+   * <code>
+   * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+   * </code>
    *
    * @return Whether the secret field is set.
    */
@@ -101,10 +103,12 @@ public interface CreateSecretRequestOrBuilder
    *
    *
    * <pre>
-   * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+   * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
    * </pre>
    *
-   * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+   * <code>
+   * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+   * </code>
    *
    * @return The secret.
    */
@@ -113,10 +117,12 @@ public interface CreateSecretRequestOrBuilder
    *
    *
    * <pre>
-   * A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+   * Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
    * </pre>
    *
-   * <code>.google.cloud.secrets.v1beta1.Secret secret = 3;</code>
+   * <code>
+   * .google.cloud.secrets.v1beta1.Secret secret = 3 [(.google.api.field_behavior) = REQUIRED];
+   * </code>
    */
   com.google.cloud.secretmanager.v1beta1.SecretOrBuilder getSecretOrBuilder();
 }