From d35393d0022dbae890e0c515efcbd477cabf8310 Mon Sep 17 00:00:00 2001
From: PhongChuong <phong.hoa.chuong@gmail.com>
Date: Thu, 31 Oct 2024 14:43:02 -0400
Subject: [PATCH 1/2] fix parentheses and use @see to link direct link

---
 .../src/main/java/com/google/cloud/bigquery/BigQuery.java  | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuery.java b/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuery.java
index 675e6c1e8..4776f4fb4 100644
--- a/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuery.java
+++ b/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuery.java
@@ -244,8 +244,9 @@ private DatasetListOption(BigQueryRpc.Option option, Object value) {
     }
 
     /**
-     * Returns an option to specify a label filter. See
-     * https://cloud.google.com/bigquery/docs/adding-using-labels#filtering_datasets_using_labels
+     * Returns an option to specify a label filter. @see <a href=
+     * "https://cloud.google.com/bigquery/docs/adding-using-labels#filtering_datasets_using_labels">Filtering
+     * using labels</a>
      *
      * @param labelFilter In the form "labels.key:value"
      */
@@ -1430,7 +1431,7 @@ TableResult listTableData(
   /**
    * Sends a job cancel request. This call will return immediately. The job status can then be
    * checked using either {@link #getJob(JobId, JobOption...)} or {@link #getJob(String,
-   * JobOption...)}).
+   * JobOption...)}.
    *
    * <p>If the location of the job is not "US" or "EU", {@link #cancel(JobId)} must be used instead.
    *

From 2b6efea3e19e73e389a01dacb7608038587011e2 Mon Sep 17 00:00:00 2001
From: PhongChuong <phong.hoa.chuong@gmail.com>
Date: Fri, 1 Nov 2024 12:54:06 -0400
Subject: [PATCH 2/2] more doc fix

---
 .../com/google/cloud/bigquery/BigQuery.java    | 18 +++++++-----------
 1 file changed, 7 insertions(+), 11 deletions(-)

diff --git a/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuery.java b/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuery.java
index 4776f4fb4..613134fa0 100644
--- a/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuery.java
+++ b/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuery.java
@@ -281,7 +281,7 @@ private DatasetOption(BigQueryRpc.Option option, Object value) {
 
     /**
      * Returns an option to specify the dataset's fields to be returned by the RPC call. If this
-     * option is not provided all dataset's fields are returned. { code DatasetOption.fields} can be
+     * option is not provided all dataset's fields are returned. {@code DatasetOption.fields} can be
      * used to specify only the fields of interest. {@link Dataset#getDatasetId()} is always
      * returned, even if not specified.
      */
@@ -865,8 +865,7 @@ public int hashCode() {
   /**
    * Lists the project's datasets. This method returns partial information on each dataset: ({@link
    * Dataset#getDatasetId()}, {@link Dataset#getFriendlyName()} and {@link
-   * Dataset#getGeneratedId()}). To get complete information use either {@link #getDataset(String,
-   * DatasetOption...)} or {@link #getDataset(DatasetId, DatasetOption...)}.
+   * Dataset#getGeneratedId()}). To get complete information use {@link #getDataset}.
    *
    * <p>Example of listing datasets, specifying the page size.
    *
@@ -885,8 +884,7 @@ public int hashCode() {
   /**
    * Lists the datasets in the provided project. This method returns partial information on each
    * dataset: ({@link Dataset#getDatasetId()}, {@link Dataset#getFriendlyName()} and {@link
-   * Dataset#getGeneratedId()}). To get complete information use either {@link #getDataset(String,
-   * DatasetOption...)} or {@link #getDataset(DatasetId, DatasetOption...)}.
+   * Dataset#getGeneratedId()}). To get complete information use either {@link #getDataset}.
    *
    * <p>Example of listing datasets in a project, specifying the page size.
    *
@@ -1206,7 +1204,7 @@ public int hashCode() {
    * Lists the tables in the dataset. This method returns partial information on each table: ({@link
    * Table#getTableId()}, {@link Table#getFriendlyName()}, {@link Table#getGeneratedId()} and type,
    * which is part of {@link Table#getDefinition()}). To get complete information use either {@link
-   * #getTable(TableId, TableOption...)} or {@link #getTable(String, String, TableOption...)}.
+   * #getTable}.
    *
    * <p>Example of listing the tables in a dataset, specifying the page size.
    *
@@ -1226,7 +1224,7 @@ public int hashCode() {
    * Lists the tables in the dataset. This method returns partial information on each table: ({@link
    * Table#getTableId()}, {@link Table#getFriendlyName()}, {@link Table#getGeneratedId()} and type,
    * which is part of {@link Table#getDefinition()}). To get complete information use either {@link
-   * #getTable(TableId, TableOption...)} or {@link #getTable(String, String, TableOption...)}.
+   * #getTable}.
    *
    * <p>Example of listing the tables in a dataset.
    *
@@ -1430,8 +1428,7 @@ TableResult listTableData(
 
   /**
    * Sends a job cancel request. This call will return immediately. The job status can then be
-   * checked using either {@link #getJob(JobId, JobOption...)} or {@link #getJob(String,
-   * JobOption...)}.
+   * checked by using {@link #getJob}.
    *
    * <p>If the location of the job is not "US" or "EU", {@link #cancel(JobId)} must be used instead.
    *
@@ -1455,8 +1452,7 @@ TableResult listTableData(
 
   /**
    * Sends a job cancel request. This call will return immediately. The job status can then be
-   * checked using either {@link #getJob(JobId, JobOption...)} or {@link #getJob(String,
-   * JobOption...)}).
+   * checked using {@link #getJob}.
    *
    * <p>If the location of the job is not "US" or "EU", the {@code jobId} must specify the job
    * location.