From d4b11bbf9198b446365b25617614434865d7e285 Mon Sep 17 00:00:00 2001
From: kolea2 <45548808+kolea2@users.noreply.github.com>
Date: Thu, 29 Jun 2023 11:05:17 -0400
Subject: [PATCH] docs: fix javadoc errors (#1126)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* docs: fix javadoc errors

* fix

* 🦉 Updates from OwlBot post-processor

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

* more fixes

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
---
 .../java/com/google/cloud/datastore/AggregationQuery.java | 2 +-
 .../com/google/cloud/datastore/AggregationResults.java    | 8 ++++----
 .../main/java/com/google/cloud/datastore/Datastore.java   | 2 +-
 .../main/java/com/google/cloud/datastore/GqlQuery.java    | 2 +-
 .../src/main/java/com/google/cloud/datastore/Query.java   | 2 +-
 .../java/com/google/cloud/datastore/StructuredQuery.java  | 2 +-
 6 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/AggregationQuery.java b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/AggregationQuery.java
index 8e7e7cdc9..210889b1e 100644
--- a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/AggregationQuery.java
+++ b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/AggregationQuery.java
@@ -45,7 +45,7 @@
  * }
  * }</pre>
  *
- * <h4>{@link GqlQuery} example:</h4>
+ * <p>{@link GqlQuery} example:
  *
  * <pre>{@code
  * GqlQuery<?> selectAllGqlQuery = Query.newGqlQueryBuilder(
diff --git a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/AggregationResults.java b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/AggregationResults.java
index f0106886a..d85e8f8ae 100644
--- a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/AggregationResults.java
+++ b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/AggregationResults.java
@@ -24,10 +24,10 @@
 import java.util.Objects;
 
 /**
- * The result of an {@link AggregationQuery} query submission. Contains a {@link
- * List<AggregationResult>} and readTime {@link Timestamp} in it.
+ * The result of an {@link AggregationQuery} query submission. Contains a List&lt;{@link
+ * AggregationResult}&gt; and readTime {@link Timestamp} in it.
  *
- * <p>This can be used to iterate over an underlying {@link List<AggregationResult>} directly.
+ * <p>This can be used to iterate over an underlying List&lt;{@link AggregationResult}&gt; directly.
  */
 public class AggregationResults implements Iterable<AggregationResult> {
 
@@ -41,7 +41,7 @@ public AggregationResults(List<AggregationResult> aggregationResults, Timestamp
     this.readTime = readTime;
   }
 
-  /** Returns {@link Iterator} for underlying {@link List<AggregationResult>}. */
+  /** Returns {@link Iterator} for underlying List&lt;{@link AggregationResult}&gt;. */
   @Override
   public Iterator<AggregationResult> iterator() {
     return this.aggregationResults.iterator();
diff --git a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Datastore.java b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Datastore.java
index d58c001b1..d78bea9a2 100644
--- a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Datastore.java
+++ b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Datastore.java
@@ -484,7 +484,7 @@ interface TransactionCallable<T> {
    * }
    * }</pre>
    *
-   * <h4>{@link GqlQuery} example:</h4>
+   * <p>{@link GqlQuery} example:
    *
    * <pre>{@code
    * GqlQuery<?> selectAllGqlQuery = Query.newGqlQueryBuilder(
diff --git a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/GqlQuery.java b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/GqlQuery.java
index d4f9f3534..de86a24a5 100644
--- a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/GqlQuery.java
+++ b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/GqlQuery.java
@@ -41,7 +41,7 @@
 /**
  * A Google Cloud Datastore GQL query.
  *
- * <h3>A usage example:</h3>
+ * <p>A usage example:
  *
  * <p>When the type of the results is known the preferred usage would be:
  *
diff --git a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Query.java b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Query.java
index 8870cf520..89b8d8807 100644
--- a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Query.java
+++ b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/Query.java
@@ -274,7 +274,7 @@ public static ProjectionEntityQuery.Builder newProjectionEntityQueryBuilder() {
    * // Use aggregationResults
    * }</pre>
    *
-   * <h4>{@link GqlQuery} example:</h4>
+   * <p>{@link GqlQuery} example:
    *
    * <pre>{@code
    * GqlQuery<?> selectAllGqlQuery = Query.newGqlQueryBuilder(
diff --git a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/StructuredQuery.java b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/StructuredQuery.java
index 9b98f063f..30cd05759 100644
--- a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/StructuredQuery.java
+++ b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/StructuredQuery.java
@@ -46,7 +46,7 @@
  * An implementation of a Google Cloud Datastore Query that can be constructed by providing all the
  * specific query elements.
  *
- * <h3>A usage example:</h3>
+ * <p>A usage example:
  *
  * <p>A simple query that returns all entities for a specific kind
  *