docs: regenerate javadocs (#37)

googleapis · Nov 20, 2019 · d0b0677 · d0b0677
1 parent 3c11307
commit d0b0677
Show file tree

Hide file tree

Showing 65 changed files with 1,115 additions and 1,155 deletions.
diff --git a/.github/release-please.yml b/.github/release-please.yml
@@ -1 +1,2 @@
 releaseType: java-yoshi
+bumpMinorPreMajor: true
diff --git a/.kokoro/build.sh b/.kokoro/build.sh
@@ -27,6 +27,7 @@ echo ${JOB_TYPE}
 mvn install -B -V \
   -DskipTests=true \
   -Dclirr.skip=true \
+  -Denforcer.skip=true \
   -Dmaven.javadoc.skip=true \
   -Dgcloud.download.skip=true \
   -T 1C
@@ -38,7 +39,7 @@ fi
 
 case ${JOB_TYPE} in
 test)
-    mvn test -B -Dclirr.skip=true
+    mvn test -B -Dclirr.skip=true -Denforcer.skip=true
     bash ${KOKORO_GFILE_DIR}/codecov.sh
     bash .kokoro/coerce_logs.sh
     ;;
@@ -49,12 +50,17 @@ javadoc)
     mvn javadoc:javadoc javadoc:test-javadoc
     ;;
 integration)
-    mvn -B ${INTEGRATION_TEST_ARGS} -DtrimStackTrace=false -Dclirr.skip=true -fae verify
+    mvn -B ${INTEGRATION_TEST_ARGS} \
+      -DtrimStackTrace=false \
+      -Dclirr.skip=true \
+      -Denforcer.skip=true \
+      -fae \
+      verify
     bash .kokoro/coerce_logs.sh
     ;;
 clirr)
-    mvn -B clirr:check
+    mvn -B -Denforcer.skip=true clirr:check
     ;;
 *)
     ;;
-esac
+esac
diff --git a/.kokoro/dependencies.sh b/.kokoro/dependencies.sh
@@ -23,5 +23,9 @@ echo $JOB_TYPE
 
 export MAVEN_OPTS="-Xmx1024m -XX:MaxPermSize=128m"
 
-mvn install -DskipTests=true -B -V
+# this should run maven enforcer
+mvn install -B -V \
+  -DskipTests=true \
+  -Dclirr.skip=true
+
 mvn -B dependency:analyze -DfailOnWarning=true
diff --git a/...atacatalog/src/main/java/com/google/cloud/datacatalog/v1beta1/PolicyTagManagerClient.java b/...atacatalog/src/main/java/com/google/cloud/datacatalog/v1beta1/PolicyTagManagerClient.java
@@ -32,8 +32,8 @@
 
 // AUTO-GENERATED DOCUMENTATION AND SERVICE
 /**
- * Service Description: Policy tag manager API service allows clients to manage their taxonomies and
- * policy tags data.
+ * Service Description: The policy tag manager API service allows clients to manage their taxonomies
+ * and policy tags.
  *
  * <p>This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
@@ -154,7 +154,7 @@ public PolicyTagManagerStub getStub() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Creates a new taxonomy in a given project.
+   * Creates a taxonomy in the specified project.
    *
    * <p>Sample code:
    *
@@ -174,7 +174,7 @@ public final Taxonomy createTaxonomy(CreateTaxonomyRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Creates a new taxonomy in a given project.
+   * Creates a taxonomy in the specified project.
    *
    * <p>Sample code:
    *
@@ -193,7 +193,8 @@ public final UnaryCallable<CreateTaxonomyRequest, Taxonomy> createTaxonomyCallab
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Deletes a taxonomy. This operation will also delete all policy tags in this taxonomy.
+   * Deletes a taxonomy. This operation will also delete all policy tags in this taxonomy along with
+   * their associated policies.
    *
    * <p>Sample code:
    *
@@ -213,7 +214,8 @@ public final void deleteTaxonomy(DeleteTaxonomyRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Deletes a taxonomy. This operation will also delete all policy tags in this taxonomy.
+   * Deletes a taxonomy. This operation will also delete all policy tags in this taxonomy along with
+   * their associated policies.
    *
    * <p>Sample code:
    *
@@ -271,7 +273,8 @@ public final UnaryCallable<UpdateTaxonomyRequest, Taxonomy> updateTaxonomyCallab
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Lists all taxonomies in a project in a particular location.
+   * Lists all taxonomies in a project in a particular location that the caller has permission to
+   * view.
    *
    * <p>Sample code:
    *
@@ -291,7 +294,8 @@ public final ListTaxonomiesResponse listTaxonomies(ListTaxonomiesRequest request
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Lists all taxonomies in a project in a particular location.
+   * Lists all taxonomies in a project in a particular location that the caller has permission to
+   * view.
    *
    * <p>Sample code:
    *
@@ -350,7 +354,7 @@ public final UnaryCallable<GetTaxonomyRequest, Taxonomy> getTaxonomyCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Creates a policy tag in a taxonomy.
+   * Creates a policy tag in the specified taxonomy.
    *
    * <p>Sample code:
    *
@@ -370,7 +374,7 @@ public final PolicyTag createPolicyTag(CreatePolicyTagRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Creates a policy tag in a taxonomy.
+   * Creates a policy tag in the specified taxonomy.
    *
    * <p>Sample code:
    *
@@ -624,7 +628,7 @@ public final UnaryCallable<SetIamPolicyRequest, Policy> setIamPolicyCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Returns permissions that a caller has on specified resources.
+   * Returns the permissions that a caller has on the specified taxonomy or policy tag.
    *
    * <p>Sample code:
    *
@@ -644,7 +648,7 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD
   /**
-   * Returns permissions that a caller has on specified resources.
+   * Returns the permissions that a caller has on the specified taxonomy or policy tag.
    *
    * <p>Sample code:
    *

diff --git a/...le-cloud-datacatalog/src/main/java/com/google/cloud/datacatalog/v1beta1/package-info.java b/...le-cloud-datacatalog/src/main/java/com/google/cloud/datacatalog/v1beta1/package-info.java
@@ -39,8 +39,8 @@
  *
  * ====================== PolicyTagManagerClient ======================
  *
- * <p>Service Description: Policy tag manager API service allows clients to manage their taxonomies
- * and policy tags data.
+ * <p>Service Description: The policy tag manager API service allows clients to manage their
+ * taxonomies and policy tags.
  *
  * <p>Sample for PolicyTagManagerClient:
  *