docs: [dialogflow] Reformat some comments and documentation (#9024)

* docs: Reformat some comments and documentation PiperOrigin-RevId: 504029060 Source-Link: googleapis/googleapis@4d9606e Source-Link: googleapis/googleapis-gen@a77ae2d Copy-Tag: eyJwIjoiamF2YS1kaWFsb2dmbG93Ly5Pd2xCb3QueWFtbCIsImgiOiJhNzdhZTJkOTBkZDA1Mzk0MDljOGJhZDk3NjkwOGRmNjEzMDk2ZGVkIn0= * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
googleapis · Feb 1, 2023 · 2c1bd38 · 2c1bd38
1 parent 1750ab3
commit 2c1bd38
Show file tree

Hide file tree

Showing 215 changed files with 4,272 additions and 2,657 deletions.
diff --git a/...loud-dialogflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/AgentsGrpc.java b/...loud-dialogflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/AgentsGrpc.java
@@ -577,7 +577,8 @@ public void trainAgent(
      * The returned `Operation` type has the following method-specific fields:
      * - `metadata`: An empty [Struct
      *   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
-     * - `response`: [ExportAgentResponse][google.cloud.dialogflow.v2beta1.ExportAgentResponse]
+     * - `response`:
+     * [ExportAgentResponse][google.cloud.dialogflow.v2beta1.ExportAgentResponse]
      * </pre>
      */
     public void exportAgent(
@@ -594,11 +595,13 @@ public void exportAgent(
      * Imports the specified agent from a ZIP file.
      * Uploads new intents and entity types without deleting the existing ones.
      * Intents and entity types with the same name are replaced with the new
-     * versions from [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest]. After the import, the imported draft
-     * agent will be trained automatically (unless disabled in agent settings).
-     * However, once the import is done, training may not be completed yet. Please
-     * call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it returns in order to train
-     * explicitly.
+     * versions from
+     * [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest].
+     * After the import, the imported draft agent will be trained automatically
+     * (unless disabled in agent settings). However, once the import is done,
+     * training may not be completed yet. Please call
+     * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait
+     * for the operation it returns in order to train explicitly.
      * This method is a [long-running
      * operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
      * The returned `Operation` type has the following method-specific fields:
@@ -629,8 +632,9 @@ public void importAgent(
      * entity types in the older version are deleted. After the restore, the
      * restored draft agent will be trained automatically (unless disabled in
      * agent settings). However, once the restore is done, training may not be
-     * completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
-     * returns in order to train explicitly.
+     * completed yet. Please call
+     * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait
+     * for the operation it returns in order to train explicitly.
      * This method is a [long-running
      * operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
      * The returned `Operation` type has the following method-specific fields:
@@ -851,7 +855,8 @@ public void trainAgent(
      * The returned `Operation` type has the following method-specific fields:
      * - `metadata`: An empty [Struct
      *   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
-     * - `response`: [ExportAgentResponse][google.cloud.dialogflow.v2beta1.ExportAgentResponse]
+     * - `response`:
+     * [ExportAgentResponse][google.cloud.dialogflow.v2beta1.ExportAgentResponse]
      * </pre>
      */
     public void exportAgent(
@@ -870,11 +875,13 @@ public void exportAgent(
      * Imports the specified agent from a ZIP file.
      * Uploads new intents and entity types without deleting the existing ones.
      * Intents and entity types with the same name are replaced with the new
-     * versions from [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest]. After the import, the imported draft
-     * agent will be trained automatically (unless disabled in agent settings).
-     * However, once the import is done, training may not be completed yet. Please
-     * call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it returns in order to train
-     * explicitly.
+     * versions from
+     * [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest].
+     * After the import, the imported draft agent will be trained automatically
+     * (unless disabled in agent settings). However, once the import is done,
+     * training may not be completed yet. Please call
+     * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait
+     * for the operation it returns in order to train explicitly.
      * This method is a [long-running
      * operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
      * The returned `Operation` type has the following method-specific fields:
@@ -907,8 +914,9 @@ public void importAgent(
      * entity types in the older version are deleted. After the restore, the
      * restored draft agent will be trained automatically (unless disabled in
      * agent settings). However, once the restore is done, training may not be
-     * completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
-     * returns in order to train explicitly.
+     * completed yet. Please call
+     * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait
+     * for the operation it returns in order to train explicitly.
      * This method is a [long-running
      * operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
      * The returned `Operation` type has the following method-specific fields:
@@ -1062,7 +1070,8 @@ public com.google.longrunning.Operation trainAgent(
      * The returned `Operation` type has the following method-specific fields:
      * - `metadata`: An empty [Struct
      *   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
-     * - `response`: [ExportAgentResponse][google.cloud.dialogflow.v2beta1.ExportAgentResponse]
+     * - `response`:
+     * [ExportAgentResponse][google.cloud.dialogflow.v2beta1.ExportAgentResponse]
      * </pre>
      */
     public com.google.longrunning.Operation exportAgent(
@@ -1078,11 +1087,13 @@ public com.google.longrunning.Operation exportAgent(
      * Imports the specified agent from a ZIP file.
      * Uploads new intents and entity types without deleting the existing ones.
      * Intents and entity types with the same name are replaced with the new
-     * versions from [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest]. After the import, the imported draft
-     * agent will be trained automatically (unless disabled in agent settings).
-     * However, once the import is done, training may not be completed yet. Please
-     * call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it returns in order to train
-     * explicitly.
+     * versions from
+     * [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest].
+     * After the import, the imported draft agent will be trained automatically
+     * (unless disabled in agent settings). However, once the import is done,
+     * training may not be completed yet. Please call
+     * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait
+     * for the operation it returns in order to train explicitly.
      * This method is a [long-running
      * operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
      * The returned `Operation` type has the following method-specific fields:
@@ -1112,8 +1123,9 @@ public com.google.longrunning.Operation importAgent(
      * entity types in the older version are deleted. After the restore, the
      * restored draft agent will be trained automatically (unless disabled in
      * agent settings). However, once the restore is done, training may not be
-     * completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
-     * returns in order to train explicitly.
+     * completed yet. Please call
+     * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait
+     * for the operation it returns in order to train explicitly.
      * This method is a [long-running
      * operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
      * The returned `Operation` type has the following method-specific fields:
@@ -1263,7 +1275,8 @@ protected AgentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions ca
      * The returned `Operation` type has the following method-specific fields:
      * - `metadata`: An empty [Struct
      *   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
-     * - `response`: [ExportAgentResponse][google.cloud.dialogflow.v2beta1.ExportAgentResponse]
+     * - `response`:
+     * [ExportAgentResponse][google.cloud.dialogflow.v2beta1.ExportAgentResponse]
      * </pre>
      */
     public com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation>
@@ -1279,11 +1292,13 @@ protected AgentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions ca
      * Imports the specified agent from a ZIP file.
      * Uploads new intents and entity types without deleting the existing ones.
      * Intents and entity types with the same name are replaced with the new
-     * versions from [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest]. After the import, the imported draft
-     * agent will be trained automatically (unless disabled in agent settings).
-     * However, once the import is done, training may not be completed yet. Please
-     * call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it returns in order to train
-     * explicitly.
+     * versions from
+     * [ImportAgentRequest][google.cloud.dialogflow.v2beta1.ImportAgentRequest].
+     * After the import, the imported draft agent will be trained automatically
+     * (unless disabled in agent settings). However, once the import is done,
+     * training may not be completed yet. Please call
+     * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait
+     * for the operation it returns in order to train explicitly.
      * This method is a [long-running
      * operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
      * The returned `Operation` type has the following method-specific fields:
@@ -1313,8 +1328,9 @@ protected AgentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions ca
      * entity types in the older version are deleted. After the restore, the
      * restored draft agent will be trained automatically (unless disabled in
      * agent settings). However, once the restore is done, training may not be
-     * completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait for the operation it
-     * returns in order to train explicitly.
+     * completed yet. Please call
+     * [TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent] and wait
+     * for the operation it returns in order to train explicitly.
      * This method is a [long-running
      * operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
      * The returned `Operation` type has the following method-specific fields:

diff --git a/...alogflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/AnswerRecordsGrpc.java b/...alogflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/AnswerRecordsGrpc.java
@@ -21,7 +21,8 @@
  *
  *
  * <pre>
- * Service for managing [AnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecord].
+ * Service for managing
+ * [AnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecord].
  * </pre>
  */
 @javax.annotation.Generated(
@@ -221,7 +222,8 @@ public AnswerRecordsFutureStub newStub(
    *
    *
    * <pre>
-   * Service for managing [AnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecord].
+   * Service for managing
+   * [AnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecord].
    * </pre>
    */
   public abstract static class AnswerRecordsImplBase implements io.grpc.BindableService {
@@ -306,7 +308,8 @@ public final io.grpc.ServerServiceDefinition bindService() {
    *
    *
    * <pre>
-   * Service for managing [AnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecord].
+   * Service for managing
+   * [AnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecord].
    * </pre>
    */
   public static final class AnswerRecordsStub
@@ -379,7 +382,8 @@ public void updateAnswerRecord(
    *
    *
    * <pre>
-   * Service for managing [AnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecord].
+   * Service for managing
+   * [AnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecord].
    * </pre>
    */
   public static final class AnswerRecordsBlockingStub
@@ -441,7 +445,8 @@ public com.google.cloud.dialogflow.v2beta1.AnswerRecord updateAnswerRecord(
    *
    *
    * <pre>
-   * Service for managing [AnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecord].
+   * Service for managing
+   * [AnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecord].
    * </pre>
    */
   public static final class AnswerRecordsFutureStub