From 3e73363c696d7324b36c7dd956f074d667c01e12 Mon Sep 17 00:00:00 2001 From: Bradley White <14679271+devbww@users.noreply.github.com> Date: Thu, 2 Dec 2021 04:16:24 -0500 Subject: [PATCH] Update "@param options" documentation. --- .../golden/golden_kitchen_sink_client.h | 12 ++++++ .../golden/golden_thing_admin_client.h | 38 +++++++++++++++++++ generator/internal/descriptor_utils_test.cc | 2 + 3 files changed, 52 insertions(+) diff --git a/generator/integration_tests/golden/golden_kitchen_sink_client.h b/generator/integration_tests/golden/golden_kitchen_sink_client.h index e6639632b0a73..bea32e469f27a 100644 --- a/generator/integration_tests/golden/golden_kitchen_sink_client.h +++ b/generator/integration_tests/golden/golden_kitchen_sink_client.h @@ -115,6 +115,7 @@ class GoldenKitchenSinkClient { /// Must be set to a value less than or equal to 3600 (1 hour). If a value is /// not specified, the token's lifetime will be set to a default value of one /// hour. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::GenerateAccessTokenResponse,generator/integration_tests/test.proto#L872} /// /// [google.test.admin.database.v1.GenerateAccessTokenRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L835} @@ -143,6 +144,7 @@ class GoldenKitchenSinkClient { /// grants access to. /// @param include_email Include the service account email in the token. If set to `true`, the /// token will contain `email` and `email_verified` claims. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::GenerateIdTokenResponse,generator/integration_tests/test.proto#L914} /// /// [google.test.admin.database.v1.GenerateIdTokenRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L881} @@ -177,6 +179,7 @@ class GoldenKitchenSinkClient { /// entries in `entries`. If a log entry already has a label with the same key /// as a label in this parameter, then the log entry's label is not changed. /// See [LogEntry][google.logging.v2.LogEntry]. Test delimiter$ + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::WriteLogEntriesResponse,generator/integration_tests/test.proto#L953} /// /// [google.test.admin.database.v1.WriteLogEntriesRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L920} @@ -194,6 +197,7 @@ class GoldenKitchenSinkClient { /// "organizations/[ORGANIZATION_ID]" /// "billingAccounts/[BILLING_ACCOUNT_ID]" /// "folders/[FOLDER_ID]" + /// @param options Optional. Operation options. /// @return std::string /// /// [google.test.admin.database.v1.ListLogsRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L956} @@ -215,6 +219,7 @@ class GoldenKitchenSinkClient { /// "organization/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" /// "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" /// "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::TailLogEntriesResponse,generator/integration_tests/test.proto#L1214} /// /// [google.test.admin.database.v1.TailLogEntriesRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L1182} @@ -234,6 +239,7 @@ class GoldenKitchenSinkClient { /// @param key_types Filters the types of keys the user wants to include in the list /// response. Duplicate key types are not allowed. If no key type /// is provided, all keys are returned. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::ListServiceAccountKeysResponse,generator/integration_tests/test.proto#L1286} /// /// [google.test.admin.database.v1.ListServiceAccountKeysRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L1254} @@ -246,6 +252,7 @@ class GoldenKitchenSinkClient { /// Generates an OAuth 2.0 access token for a service account. /// /// @param request @googleapis_link{google::test::admin::database::v1::GenerateAccessTokenRequest,generator/integration_tests/test.proto#L835} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::GenerateAccessTokenResponse,generator/integration_tests/test.proto#L872} /// /// [google.test.admin.database.v1.GenerateAccessTokenRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L835} @@ -258,6 +265,7 @@ class GoldenKitchenSinkClient { /// Generates an OpenID Connect ID token for a service account. /// /// @param request @googleapis_link{google::test::admin::database::v1::GenerateIdTokenRequest,generator/integration_tests/test.proto#L881} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::GenerateIdTokenResponse,generator/integration_tests/test.proto#L914} /// /// [google.test.admin.database.v1.GenerateIdTokenRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L881} @@ -276,6 +284,7 @@ class GoldenKitchenSinkClient { /// folders) /// /// @param request @googleapis_link{google::test::admin::database::v1::WriteLogEntriesRequest,generator/integration_tests/test.proto#L920} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::WriteLogEntriesResponse,generator/integration_tests/test.proto#L953} /// /// [google.test.admin.database.v1.WriteLogEntriesRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L920} @@ -289,6 +298,7 @@ class GoldenKitchenSinkClient { /// Only logs that have entries are listed. /// /// @param request @googleapis_link{google::test::admin::database::v1::ListLogsRequest,generator/integration_tests/test.proto#L956} + /// @param options Optional. Operation options. /// @return std::string /// /// [google.test.admin.database.v1.ListLogsRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L956} @@ -301,6 +311,7 @@ class GoldenKitchenSinkClient { /// terminated, it will continue reading logs. /// /// @param request @googleapis_link{google::test::admin::database::v1::TailLogEntriesRequest,generator/integration_tests/test.proto#L1182} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::TailLogEntriesResponse,generator/integration_tests/test.proto#L1214} /// /// [google.test.admin.database.v1.TailLogEntriesRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L1182} @@ -313,6 +324,7 @@ class GoldenKitchenSinkClient { /// Lists every [ServiceAccountKey][google.iam.admin.v1.ServiceAccountKey] for a service account. /// /// @param request @googleapis_link{google::test::admin::database::v1::ListServiceAccountKeysRequest,generator/integration_tests/test.proto#L1254} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::ListServiceAccountKeysResponse,generator/integration_tests/test.proto#L1286} /// /// [google.test.admin.database.v1.ListServiceAccountKeysRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L1254} diff --git a/generator/integration_tests/golden/golden_thing_admin_client.h b/generator/integration_tests/golden/golden_thing_admin_client.h index a88ef67a107f7..b2d1bc32d228f 100644 --- a/generator/integration_tests/golden/golden_thing_admin_client.h +++ b/generator/integration_tests/golden/golden_thing_admin_client.h @@ -93,6 +93,7 @@ class GoldenThingAdminClient { /// /// @param parent Required. The instance whose databases should be listed. /// Values are of the form `projects//instances/`. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Database,generator/integration_tests/test.proto#L329} /// /// [google.test.admin.database.v1.ListDatabasesRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L377} @@ -118,6 +119,7 @@ class GoldenThingAdminClient { /// `[a-z][a-z0-9_\-]*[a-z0-9]` and be between 2 and 30 characters in length. /// If the database ID is a reserved word or if it contains a hyphen, the /// database ID must be enclosed in backticks (`` ` ``). + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Database,generator/integration_tests/test.proto#L329} /// /// [google.test.admin.database.v1.CreateDatabaseRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L409} @@ -131,6 +133,7 @@ class GoldenThingAdminClient { /// /// @param name Required. The name of the requested database. Values are of the form /// `projects//instances//databases/`. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Database,generator/integration_tests/test.proto#L329} /// /// [google.test.admin.database.v1.GetDatabaseRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L443} @@ -150,6 +153,7 @@ class GoldenThingAdminClient { /// /// @param database Required. The database to update. /// @param statements Required. DDL statements to be applied to the database. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::UpdateDatabaseDdlMetadata,generator/integration_tests/test.proto#L506} /// /// [google.test.admin.database.v1.UpdateDatabaseDdlRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L470} @@ -164,6 +168,7 @@ class GoldenThingAdminClient { /// `expire_time`. /// /// @param database Required. The database to be dropped. + /// @param options Optional. Operation options. /// /// [google.test.admin.database.v1.DropDatabaseRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L523} /// @@ -176,6 +181,7 @@ class GoldenThingAdminClient { /// be queried using the [Operations][google.longrunning.Operations] API. /// /// @param database Required. The database whose schema we wish to get. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::GetDatabaseDdlResponse,generator/integration_tests/test.proto#L545} /// /// [google.test.admin.database.v1.GetDatabaseDdlRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L534} @@ -199,6 +205,7 @@ class GoldenThingAdminClient { /// the policy is limited to a few 10s of KB. An empty policy is a /// valid policy but certain Cloud Platform services (such as Projects) /// might reject them. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::iam::v1::Policy,google/iam/v1/policy.proto#L88} /// /// [google.iam.v1.SetIamPolicyRequest]: @googleapis_reference_link{google/iam/v1/iam_policy.proto#L98} @@ -243,6 +250,7 @@ class GoldenThingAdminClient { /// /// @param resource REQUIRED: The resource for which the policy is being requested. /// See the operation documentation for the appropriate value for this field. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::iam::v1::Policy,google/iam/v1/policy.proto#L88} /// /// [google.iam.v1.GetIamPolicyRequest]: @googleapis_reference_link{google/iam/v1/iam_policy.proto#L113} @@ -269,6 +277,7 @@ class GoldenThingAdminClient { /// wildcards (such as '*' or 'storage.*') are not allowed. For more /// information see /// [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions). + /// @param options Optional. Operation options. /// @return @googleapis_link{google::iam::v1::TestIamPermissionsResponse,google/iam/v1/iam_policy.proto#L141} /// /// [google.iam.v1.TestIamPermissionsRequest]: @googleapis_reference_link{google/iam/v1/iam_policy.proto#L126} @@ -301,6 +310,7 @@ class GoldenThingAdminClient { /// @param backup_id Required. The id of the backup to be created. The `backup_id` appended to /// `parent` forms the full backup name of the form /// `projects//instances//backups/`. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Backup,generator/integration_tests/backup.proto#L36} /// /// [google.test.admin.database.v1.CreateBackupRequest]: @googleapis_reference_link{generator/integration_tests/backup.proto#L110} @@ -315,6 +325,7 @@ class GoldenThingAdminClient { /// @param name Required. Name of the backup. /// Values are of the form /// `projects//instances//backups/`. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Backup,generator/integration_tests/backup.proto#L36} /// /// [google.test.admin.database.v1.GetBackupRequest]: @googleapis_reference_link{generator/integration_tests/backup.proto#L177} @@ -335,6 +346,7 @@ class GoldenThingAdminClient { /// resource, not to the request message. The field mask must always be /// specified; this prevents any future fields from being erased accidentally /// by clients that do not know about them. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Backup,generator/integration_tests/backup.proto#L36} /// /// [google.test.admin.database.v1.UpdateBackupRequest]: @googleapis_reference_link{generator/integration_tests/backup.proto#L161} @@ -349,6 +361,7 @@ class GoldenThingAdminClient { /// @param name Required. Name of the backup to delete. /// Values are of the form /// `projects//instances//backups/`. + /// @param options Optional. Operation options. /// /// [google.test.admin.database.v1.DeleteBackupRequest]: @googleapis_reference_link{generator/integration_tests/backup.proto#L190} /// @@ -362,6 +375,7 @@ class GoldenThingAdminClient { /// /// @param parent Required. The instance to list backups from. Values are of the /// form `projects//instances/`. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Backup,generator/integration_tests/backup.proto#L36} /// /// [google.test.admin.database.v1.ListBackupsRequest]: @googleapis_reference_link{generator/integration_tests/backup.proto#L203} @@ -400,6 +414,7 @@ class GoldenThingAdminClient { /// `projects//instances//databases/`. /// @param backup Name of the backup from which to restore. Values are of the form /// `projects//instances//backups/`. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Database,generator/integration_tests/test.proto#L329} /// /// [google.test.admin.database.v1.RestoreDatabaseRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L634} @@ -420,6 +435,7 @@ class GoldenThingAdminClient { /// /// @param parent Required. The instance of the database operations. /// Values are of the form `projects//instances/`. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::longrunning::Operation,google/longrunning/operations.proto#L128} /// /// [google.test.admin.database.v1.ListDatabaseOperationsRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L553} @@ -442,6 +458,7 @@ class GoldenThingAdminClient { /// /// @param parent Required. The instance of the backup operations. Values are of /// the form `projects//instances/`. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::longrunning::Operation,google/longrunning/operations.proto#L128} /// /// [google.test.admin.database.v1.ListBackupOperationsRequest]: @googleapis_reference_link{generator/integration_tests/backup.proto#L274} @@ -455,6 +472,7 @@ class GoldenThingAdminClient { /// /// @param name Required. The name of the requested database. Values are of the form /// `projects//instances//databases/`. + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Database,generator/integration_tests/test.proto#L329} /// /// [google.test.admin.database.v1.GetDatabaseRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L443} @@ -469,6 +487,7 @@ class GoldenThingAdminClient { /// `expire_time`. /// /// @param database Required. The database to be dropped. + /// @param options Optional. Operation options. /// /// [google.test.admin.database.v1.DropDatabaseRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L523} /// @@ -479,6 +498,7 @@ class GoldenThingAdminClient { /// Lists Cloud Test databases. /// /// @param request @googleapis_link{google::test::admin::database::v1::ListDatabasesRequest,generator/integration_tests/test.proto#L377} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Database,generator/integration_tests/test.proto#L329} /// /// [google.test.admin.database.v1.ListDatabasesRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L377} @@ -498,6 +518,7 @@ class GoldenThingAdminClient { /// [Database][google.test.admin.database.v1.Database], if successful. /// /// @param request @googleapis_link{google::test::admin::database::v1::CreateDatabaseRequest,generator/integration_tests/test.proto#L409} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Database,generator/integration_tests/test.proto#L329} /// /// [google.test.admin.database.v1.CreateDatabaseRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L409} @@ -510,6 +531,7 @@ class GoldenThingAdminClient { /// Gets the state of a Cloud Test database. /// /// @param request @googleapis_link{google::test::admin::database::v1::GetDatabaseRequest,generator/integration_tests/test.proto#L443} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Database,generator/integration_tests/test.proto#L329} /// /// [google.test.admin.database.v1.GetDatabaseRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L443} @@ -528,6 +550,7 @@ class GoldenThingAdminClient { /// [UpdateDatabaseDdlMetadata][google.test.admin.database.v1.UpdateDatabaseDdlMetadata]. The operation has no response. /// /// @param request @googleapis_link{google::test::admin::database::v1::UpdateDatabaseDdlRequest,generator/integration_tests/test.proto#L470} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::UpdateDatabaseDdlMetadata,generator/integration_tests/test.proto#L506} /// /// [google.test.admin.database.v1.UpdateDatabaseDdlRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L470} @@ -542,6 +565,7 @@ class GoldenThingAdminClient { /// `expire_time`. /// /// @param request @googleapis_link{google::test::admin::database::v1::DropDatabaseRequest,generator/integration_tests/test.proto#L523} + /// @param options Optional. Operation options. /// /// [google.test.admin.database.v1.DropDatabaseRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L523} /// @@ -554,6 +578,7 @@ class GoldenThingAdminClient { /// be queried using the [Operations][google.longrunning.Operations] API. /// /// @param request @googleapis_link{google::test::admin::database::v1::GetDatabaseDdlRequest,generator/integration_tests/test.proto#L534} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::GetDatabaseDdlResponse,generator/integration_tests/test.proto#L545} /// /// [google.test.admin.database.v1.GetDatabaseDdlRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L534} @@ -572,6 +597,7 @@ class GoldenThingAdminClient { /// permission on [resource][google.iam.v1.SetIamPolicyRequest.resource]. /// /// @param request @googleapis_link{google::iam::v1::SetIamPolicyRequest,google/iam/v1/iam_policy.proto#L98} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::iam::v1::Policy,google/iam/v1/policy.proto#L88} /// /// [google.iam.v1.SetIamPolicyRequest]: @googleapis_reference_link{google/iam/v1/iam_policy.proto#L98} @@ -591,6 +617,7 @@ class GoldenThingAdminClient { /// permission on [resource][google.iam.v1.GetIamPolicyRequest.resource]. /// /// @param request @googleapis_link{google::iam::v1::GetIamPolicyRequest,google/iam/v1/iam_policy.proto#L113} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::iam::v1::Policy,google/iam/v1/policy.proto#L88} /// /// [google.iam.v1.GetIamPolicyRequest]: @googleapis_reference_link{google/iam/v1/iam_policy.proto#L113} @@ -612,6 +639,7 @@ class GoldenThingAdminClient { /// `test.backups.list` permission on the containing instance. /// /// @param request @googleapis_link{google::iam::v1::TestIamPermissionsRequest,google/iam/v1/iam_policy.proto#L126} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::iam::v1::TestIamPermissionsResponse,google/iam/v1/iam_policy.proto#L141} /// /// [google.iam.v1.TestIamPermissionsRequest]: @googleapis_reference_link{google/iam/v1/iam_policy.proto#L126} @@ -635,6 +663,7 @@ class GoldenThingAdminClient { /// of different databases can run concurrently. /// /// @param request @googleapis_link{google::test::admin::database::v1::CreateBackupRequest,generator/integration_tests/backup.proto#L110} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Backup,generator/integration_tests/backup.proto#L36} /// /// [google.test.admin.database.v1.CreateBackupRequest]: @googleapis_reference_link{generator/integration_tests/backup.proto#L110} @@ -647,6 +676,7 @@ class GoldenThingAdminClient { /// Gets metadata on a pending or completed [Backup][google.test.admin.database.v1.Backup]. /// /// @param request @googleapis_link{google::test::admin::database::v1::GetBackupRequest,generator/integration_tests/backup.proto#L177} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Backup,generator/integration_tests/backup.proto#L36} /// /// [google.test.admin.database.v1.GetBackupRequest]: @googleapis_reference_link{generator/integration_tests/backup.proto#L177} @@ -659,6 +689,7 @@ class GoldenThingAdminClient { /// Updates a pending or completed [Backup][google.test.admin.database.v1.Backup]. /// /// @param request @googleapis_link{google::test::admin::database::v1::UpdateBackupRequest,generator/integration_tests/backup.proto#L161} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Backup,generator/integration_tests/backup.proto#L36} /// /// [google.test.admin.database.v1.UpdateBackupRequest]: @googleapis_reference_link{generator/integration_tests/backup.proto#L161} @@ -671,6 +702,7 @@ class GoldenThingAdminClient { /// Deletes a pending or completed [Backup][google.test.admin.database.v1.Backup]. /// /// @param request @googleapis_link{google::test::admin::database::v1::DeleteBackupRequest,generator/integration_tests/backup.proto#L190} + /// @param options Optional. Operation options. /// /// [google.test.admin.database.v1.DeleteBackupRequest]: @googleapis_reference_link{generator/integration_tests/backup.proto#L190} /// @@ -683,6 +715,7 @@ class GoldenThingAdminClient { /// starting from the most recent `create_time`. /// /// @param request @googleapis_link{google::test::admin::database::v1::ListBackupsRequest,generator/integration_tests/backup.proto#L203} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Backup,generator/integration_tests/backup.proto#L36} /// /// [google.test.admin.database.v1.ListBackupsRequest]: @googleapis_reference_link{generator/integration_tests/backup.proto#L203} @@ -711,6 +744,7 @@ class GoldenThingAdminClient { /// first restore to complete. /// /// @param request @googleapis_link{google::test::admin::database::v1::RestoreDatabaseRequest,generator/integration_tests/test.proto#L634} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Database,generator/integration_tests/test.proto#L329} /// /// [google.test.admin.database.v1.RestoreDatabaseRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L634} @@ -730,6 +764,7 @@ class GoldenThingAdminClient { /// and pending operations. /// /// @param request @googleapis_link{google::test::admin::database::v1::ListDatabaseOperationsRequest,generator/integration_tests/test.proto#L553} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::longrunning::Operation,google/longrunning/operations.proto#L128} /// /// [google.test.admin.database.v1.ListDatabaseOperationsRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L553} @@ -751,6 +786,7 @@ class GoldenThingAdminClient { /// from the most recently started operation. /// /// @param request @googleapis_link{google::test::admin::database::v1::ListBackupOperationsRequest,generator/integration_tests/backup.proto#L274} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::longrunning::Operation,google/longrunning/operations.proto#L128} /// /// [google.test.admin.database.v1.ListBackupOperationsRequest]: @googleapis_reference_link{generator/integration_tests/backup.proto#L274} @@ -763,6 +799,7 @@ class GoldenThingAdminClient { /// Gets the state of a Cloud Test database. /// /// @param request @googleapis_link{google::test::admin::database::v1::GetDatabaseRequest,generator/integration_tests/test.proto#L443} + /// @param options Optional. Operation options. /// @return @googleapis_link{google::test::admin::database::v1::Database,generator/integration_tests/test.proto#L329} /// /// [google.test.admin.database.v1.GetDatabaseRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L443} @@ -777,6 +814,7 @@ class GoldenThingAdminClient { /// `expire_time`. /// /// @param request @googleapis_link{google::test::admin::database::v1::DropDatabaseRequest,generator/integration_tests/test.proto#L523} + /// @param options Optional. Operation options. /// /// [google.test.admin.database.v1.DropDatabaseRequest]: @googleapis_reference_link{generator/integration_tests/test.proto#L523} /// diff --git a/generator/internal/descriptor_utils_test.cc b/generator/internal/descriptor_utils_test.cc index 5e0501e640f10..fb27d65b5e864 100644 --- a/generator/internal/descriptor_utils_test.cc +++ b/generator/internal/descriptor_utils_test.cc @@ -503,6 +503,7 @@ TEST_F(CreateMethodVarsTest, /// Leading comments about rpc Method0$$. /// /// @param request @googleapis_link{google::protobuf::Bar,google/foo/v1/service.proto#L14} + /// @param options Optional. Operation options. /// )""")); } @@ -518,6 +519,7 @@ TEST_F(CreateMethodVarsTest, /// Leading comments about rpc $$Method6. /// /// @param labels labels $$field comment. + /// @param options Optional. Operation options. /// )""")); }