doc: group client functions (#10268)

googleapis · Nov 18, 2022 · a471594 · a471594
1 parent b10a35b
commit a471594
Show file tree

Hide file tree

Showing 202 changed files with 808 additions and 808 deletions.
diff --git a/generator/integration_tests/golden/golden_kitchen_sink_client.h b/generator/integration_tests/golden/golden_kitchen_sink_client.h
@@ -66,23 +66,23 @@ class GoldenKitchenSinkClient {
   explicit GoldenKitchenSinkClient(std::shared_ptr<GoldenKitchenSinkConnection> connection, Options opts = {});
   ~GoldenKitchenSinkClient();
 
-  //@{
+  ///@{
   // @name Copy and move support
   GoldenKitchenSinkClient(GoldenKitchenSinkClient const&) = default;
   GoldenKitchenSinkClient& operator=(GoldenKitchenSinkClient const&) = default;
   GoldenKitchenSinkClient(GoldenKitchenSinkClient&&) = default;
   GoldenKitchenSinkClient& operator=(GoldenKitchenSinkClient&&) = default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==(GoldenKitchenSinkClient const& a, GoldenKitchenSinkClient const& b) {
     return a.connection_ == b.connection_;
   }
   friend bool operator!=(GoldenKitchenSinkClient const& a, GoldenKitchenSinkClient const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 
   ///
   /// Generates an OAuth 2.0 access token for a service account.

diff --git a/generator/integration_tests/golden/golden_thing_admin_client.h b/generator/integration_tests/golden/golden_thing_admin_client.h
@@ -70,23 +70,23 @@ class GoldenThingAdminClient {
   explicit GoldenThingAdminClient(std::shared_ptr<GoldenThingAdminConnection> connection, Options opts = {});
   ~GoldenThingAdminClient();
 
-  //@{
+  ///@{
   // @name Copy and move support
   GoldenThingAdminClient(GoldenThingAdminClient const&) = default;
   GoldenThingAdminClient& operator=(GoldenThingAdminClient const&) = default;
   GoldenThingAdminClient(GoldenThingAdminClient&&) = default;
   GoldenThingAdminClient& operator=(GoldenThingAdminClient&&) = default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==(GoldenThingAdminClient const& a, GoldenThingAdminClient const& b) {
     return a.connection_ == b.connection_;
   }
   friend bool operator!=(GoldenThingAdminClient const& a, GoldenThingAdminClient const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 
   ///
   /// Lists Cloud Test databases.

diff --git a/generator/internal/client_generator.cc b/generator/internal/client_generator.cc
@@ -101,23 +101,23 @@ class $client_class_name$ {
       R"""(std::shared_ptr<$connection_class_name$> connection, Options opts = {});
   ~$client_class_name$();
 
-  //@{
+  ///@{
   // @name Copy and move support
   $client_class_name$($client_class_name$ const&) = default;
   $client_class_name$& operator=($client_class_name$ const&) = default;
   $client_class_name$($client_class_name$&&) = default;
   $client_class_name$& operator=($client_class_name$&&) = default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==($client_class_name$ const& a, $client_class_name$ const& b) {
     return a.connection_ == b.connection_;
   }
   friend bool operator!=($client_class_name$ const& a, $client_class_name$ const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 )""");
 
   for (google::protobuf::MethodDescriptor const& method : methods()) {

diff --git a/google/cloud/accessapproval/access_approval_client.h b/google/cloud/accessapproval/access_approval_client.h
@@ -96,15 +96,15 @@ class AccessApprovalClient {
       std::shared_ptr<AccessApprovalConnection> connection, Options opts = {});
   ~AccessApprovalClient();
 
-  //@{
+  ///@{
   // @name Copy and move support
   AccessApprovalClient(AccessApprovalClient const&) = default;
   AccessApprovalClient& operator=(AccessApprovalClient const&) = default;
   AccessApprovalClient(AccessApprovalClient&&) = default;
   AccessApprovalClient& operator=(AccessApprovalClient&&) = default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==(AccessApprovalClient const& a,
                          AccessApprovalClient const& b) {
@@ -114,7 +114,7 @@ class AccessApprovalClient {
                          AccessApprovalClient const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 
   ///
   /// Lists approval requests associated with a project, folder, or

diff --git a/google/cloud/accesscontextmanager/access_context_manager_client.h b/google/cloud/accesscontextmanager/access_context_manager_client.h
@@ -76,16 +76,16 @@ class AccessContextManagerClient {
       Options opts = {});
   ~AccessContextManagerClient();
 
-  //@{
+  ///@{
   // @name Copy and move support
   AccessContextManagerClient(AccessContextManagerClient const&) = default;
   AccessContextManagerClient& operator=(AccessContextManagerClient const&) =
       default;
   AccessContextManagerClient(AccessContextManagerClient&&) = default;
   AccessContextManagerClient& operator=(AccessContextManagerClient&&) = default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==(AccessContextManagerClient const& a,
                          AccessContextManagerClient const& b) {
@@ -95,7 +95,7 @@ class AccessContextManagerClient {
                          AccessContextManagerClient const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 
   ///
   /// Lists all [access policies]

diff --git a/google/cloud/apigateway/api_gateway_client.h b/google/cloud/apigateway/api_gateway_client.h
@@ -67,15 +67,15 @@ class ApiGatewayServiceClient {
       Options opts = {});
   ~ApiGatewayServiceClient();
 
-  //@{
+  ///@{
   // @name Copy and move support
   ApiGatewayServiceClient(ApiGatewayServiceClient const&) = default;
   ApiGatewayServiceClient& operator=(ApiGatewayServiceClient const&) = default;
   ApiGatewayServiceClient(ApiGatewayServiceClient&&) = default;
   ApiGatewayServiceClient& operator=(ApiGatewayServiceClient&&) = default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==(ApiGatewayServiceClient const& a,
                          ApiGatewayServiceClient const& b) {
@@ -85,7 +85,7 @@ class ApiGatewayServiceClient {
                          ApiGatewayServiceClient const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 
   ///
   /// Lists Gateways in a given project and location.

diff --git a/google/cloud/apigeeconnect/connection_client.h b/google/cloud/apigeeconnect/connection_client.h
@@ -65,15 +65,15 @@ class ConnectionServiceClient {
       Options opts = {});
   ~ConnectionServiceClient();
 
-  //@{
+  ///@{
   // @name Copy and move support
   ConnectionServiceClient(ConnectionServiceClient const&) = default;
   ConnectionServiceClient& operator=(ConnectionServiceClient const&) = default;
   ConnectionServiceClient(ConnectionServiceClient&&) = default;
   ConnectionServiceClient& operator=(ConnectionServiceClient&&) = default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==(ConnectionServiceClient const& a,
                          ConnectionServiceClient const& b) {
@@ -83,7 +83,7 @@ class ConnectionServiceClient {
                          ConnectionServiceClient const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 
   ///
   /// Lists connections that are currently active for the given Apigee Connect

diff --git a/google/cloud/apikeys/api_keys_client.h b/google/cloud/apikeys/api_keys_client.h
@@ -66,23 +66,23 @@ class ApiKeysClient {
                          Options opts = {});
   ~ApiKeysClient();
 
-  //@{
+  ///@{
   // @name Copy and move support
   ApiKeysClient(ApiKeysClient const&) = default;
   ApiKeysClient& operator=(ApiKeysClient const&) = default;
   ApiKeysClient(ApiKeysClient&&) = default;
   ApiKeysClient& operator=(ApiKeysClient&&) = default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==(ApiKeysClient const& a, ApiKeysClient const& b) {
     return a.connection_ == b.connection_;
   }
   friend bool operator!=(ApiKeysClient const& a, ApiKeysClient const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 
   ///
   /// Creates a new API key.

diff --git a/google/cloud/appengine/applications_client.h b/google/cloud/appengine/applications_client.h
@@ -65,15 +65,15 @@ class ApplicationsClient {
       std::shared_ptr<ApplicationsConnection> connection, Options opts = {});
   ~ApplicationsClient();
 
-  //@{
+  ///@{
   // @name Copy and move support
   ApplicationsClient(ApplicationsClient const&) = default;
   ApplicationsClient& operator=(ApplicationsClient const&) = default;
   ApplicationsClient(ApplicationsClient&&) = default;
   ApplicationsClient& operator=(ApplicationsClient&&) = default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==(ApplicationsClient const& a,
                          ApplicationsClient const& b) {
@@ -83,7 +83,7 @@ class ApplicationsClient {
                          ApplicationsClient const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 
   ///
   /// Gets information about an application.

diff --git a/google/cloud/appengine/authorized_certificates_client.h b/google/cloud/appengine/authorized_certificates_client.h
@@ -66,17 +66,17 @@ class AuthorizedCertificatesClient {
       Options opts = {});
   ~AuthorizedCertificatesClient();
 
-  //@{
+  ///@{
   // @name Copy and move support
   AuthorizedCertificatesClient(AuthorizedCertificatesClient const&) = default;
   AuthorizedCertificatesClient& operator=(AuthorizedCertificatesClient const&) =
       default;
   AuthorizedCertificatesClient(AuthorizedCertificatesClient&&) = default;
   AuthorizedCertificatesClient& operator=(AuthorizedCertificatesClient&&) =
       default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==(AuthorizedCertificatesClient const& a,
                          AuthorizedCertificatesClient const& b) {
@@ -86,7 +86,7 @@ class AuthorizedCertificatesClient {
                          AuthorizedCertificatesClient const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 
   ///
   /// Lists all SSL certificates the user is authorized to administer.

diff --git a/google/cloud/appengine/authorized_domains_client.h b/google/cloud/appengine/authorized_domains_client.h
@@ -67,15 +67,15 @@ class AuthorizedDomainsClient {
       Options opts = {});
   ~AuthorizedDomainsClient();
 
-  //@{
+  ///@{
   // @name Copy and move support
   AuthorizedDomainsClient(AuthorizedDomainsClient const&) = default;
   AuthorizedDomainsClient& operator=(AuthorizedDomainsClient const&) = default;
   AuthorizedDomainsClient(AuthorizedDomainsClient&&) = default;
   AuthorizedDomainsClient& operator=(AuthorizedDomainsClient&&) = default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==(AuthorizedDomainsClient const& a,
                          AuthorizedDomainsClient const& b) {
@@ -85,7 +85,7 @@ class AuthorizedDomainsClient {
                          AuthorizedDomainsClient const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 
   ///
   /// Lists all domains the user is authorized to administer.

diff --git a/google/cloud/appengine/domain_mappings_client.h b/google/cloud/appengine/domain_mappings_client.h
@@ -65,15 +65,15 @@ class DomainMappingsClient {
       std::shared_ptr<DomainMappingsConnection> connection, Options opts = {});
   ~DomainMappingsClient();
 
-  //@{
+  ///@{
   // @name Copy and move support
   DomainMappingsClient(DomainMappingsClient const&) = default;
   DomainMappingsClient& operator=(DomainMappingsClient const&) = default;
   DomainMappingsClient(DomainMappingsClient&&) = default;
   DomainMappingsClient& operator=(DomainMappingsClient&&) = default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==(DomainMappingsClient const& a,
                          DomainMappingsClient const& b) {
@@ -83,7 +83,7 @@ class DomainMappingsClient {
                          DomainMappingsClient const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 
   ///
   /// Lists the domain mappings on an application.

diff --git a/google/cloud/appengine/firewall_client.h b/google/cloud/appengine/firewall_client.h
@@ -73,23 +73,23 @@ class FirewallClient {
                           Options opts = {});
   ~FirewallClient();
 
-  //@{
+  ///@{
   // @name Copy and move support
   FirewallClient(FirewallClient const&) = default;
   FirewallClient& operator=(FirewallClient const&) = default;
   FirewallClient(FirewallClient&&) = default;
   FirewallClient& operator=(FirewallClient&&) = default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==(FirewallClient const& a, FirewallClient const& b) {
     return a.connection_ == b.connection_;
   }
   friend bool operator!=(FirewallClient const& a, FirewallClient const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 
   ///
   /// Lists the firewall rules of an application.

diff --git a/google/cloud/appengine/instances_client.h b/google/cloud/appengine/instances_client.h
@@ -65,23 +65,23 @@ class InstancesClient {
                            Options opts = {});
   ~InstancesClient();
 
-  //@{
+  ///@{
   // @name Copy and move support
   InstancesClient(InstancesClient const&) = default;
   InstancesClient& operator=(InstancesClient const&) = default;
   InstancesClient(InstancesClient&&) = default;
   InstancesClient& operator=(InstancesClient&&) = default;
-  //@}
+  ///@}
 
-  //@{
+  ///@{
   // @name Equality
   friend bool operator==(InstancesClient const& a, InstancesClient const& b) {
     return a.connection_ == b.connection_;
   }
   friend bool operator!=(InstancesClient const& a, InstancesClient const& b) {
     return !(a == b);
   }
-  //@}
+  ///@}
 
   ///
   /// Lists the instances of a version.