google-cloud-spanner 1.6.3 → 1.6.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b024e076f5a48a2b319a0670c319418abceaf4abcaa82c679079a386d53fb1f
-  data.tar.gz: 28a9f44dca3b6b0c412bb87297b06315007f0d9e01f732cfcc60cf37be79b166
+  metadata.gz: 7a7e4d511e0da87129eb3b33152dda498583baf5832222808867822a7097d79a
+  data.tar.gz: 18ada9b93ec395b625c1439a90a2968c495c62eb1fdee3f1ecbbcae79c33f329
 SHA512:
-  metadata.gz: '088ce6f22bf8a3157d27fec39fe7b83ec72eab0fc4568bc7e219af47bb2b8bed0dacb91d64776350e53c2189a2ef3b3670d4bb294ed640cb78455c88012b66c4'
-  data.tar.gz: e9aff1c2b37de448de27c4ad4837c1c2e196a1c9319444a5c5071991a7a83ab0f8cef3def490bd5a6d828905668173c43e76480da33b3cd9412ecaa1baeba53d
+  metadata.gz: 50c14a7f74a351318c61fe1ad2b2342231f8997db010c5793d5d0112e4e545399476c2a2ab3aa3b0505cdef63430d710d864346bca611be19a78861af82a04d0
+  data.tar.gz: d244fd5a527e3759536e797bee8354a7263898a5ac6bd7941d4815c02de432d4b83ef72dbe81cd8fbd7c4d259b59b21bc70311d9e81b5f7ed62ea3d5ee8da9ec

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release History
 
+### 1.6.4 / 2018-09-20
+
+* Update Spanner generated files.
+  * Add DML/PDML code structures.
+* Update documentation.
+  * Change documentation URL to googleapis GitHub org.
+* Fix circular require warning.
+
 ### 1.6.3 / 2018-09-12
 
 * Add missing documentation files to package.

data/LOGGING.md

@@ -5,7 +5,7 @@ To enable logging for this library, set the logger for the underlying
 that you set may be a Ruby stdlib
 [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as
 shown below, or a
-[`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-logging/latest/Google/Cloud/Logging/Logger)
+[`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/docs/google-cloud-logging/latest/Google/Cloud/Logging/Logger)
 that will write logs to [Stackdriver
 Logging](https://cloud.google.com/logging/). See
 [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)

data/OVERVIEW.md

@@ -21,7 +21,7 @@ When you first use Cloud Spanner, you must create an instance, which is an
 allocation of resources that are used by Cloud Spanner databases. When you
 create an instance, you choose where your data is stored and how many nodes are
 used for your data. (For more information, see [Configuration
-Guide](https://googlecloudplatform.github.io/google-cloud-ruby/docs/stackdriver/latest/file.INSTRUMENTATION_CONFIGURATION)).
+Guide](https://googleapis.github.io/google-cloud-ruby/docs/stackdriver/latest/file.INSTRUMENTATION_CONFIGURATION)).
 
 Use {Google::Cloud::Spanner::Project#create_instance Project#create_instance} to
 create an instance:

data/lib/google/cloud/spanner/admin/database/v1/database_admin_client.rb

@@ -282,7 +282,7 @@ module Google
               #
               # @param parent [String]
               #   Required. The instance whose databases should be listed.
-              #   Values are of the form +projects/<project>/instances/<instance>+.
+              #   Values are of the form `projects/<project>/instances/<instance>`.
               # @param page_size [Integer]
               #   The maximum number of resources contained in the underlying API
               #   response. If page streaming is performed per-resource, this
@@ -335,7 +335,7 @@ module Google
 
               # Creates a new Cloud Spanner database and starts to prepare it for serving.
               # The returned {Google::Longrunning::Operation long-running operation} will
-              # have a name of the format +<database_name>/operations/<operation_id>+ and
+              # have a name of the format `<database_name>/operations/<operation_id>` and
               # can be used to track preparation of the database. The
               # {Google::Longrunning::Operation#metadata metadata} field type is
               # {Google::Spanner::Admin::Database::V1::CreateDatabaseMetadata CreateDatabaseMetadata}. The
@@ -344,13 +344,13 @@ module Google
               #
               # @param parent [String]
               #   Required. The name of the instance that will serve the new database.
-              #   Values are of the form +projects/<project>/instances/<instance>+.
+              #   Values are of the form `projects/<project>/instances/<instance>`.
               # @param create_statement [String]
-              #   Required. A +CREATE DATABASE+ statement, which specifies the ID of the
+              #   Required. A `CREATE DATABASE` statement, which specifies the ID of the
               #   new database.  The database ID must conform to the regular expression
-              #   +[a-z][a-z0-9_\-]*[a-z0-9]+ and be between 2 and 30 characters in length.
+              #   `[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 (+ + +).
+              #   database ID must be enclosed in backticks (`` ` ``).
               # @param extra_statements [Array<String>]
               #   An optional list of DDL statements to run inside the newly created
               #   database. Statements can create tables, indexes, etc. These
@@ -367,7 +367,7 @@ module Google
               #   database_admin_client = Google::Cloud::Spanner::Admin::Database.new(version: :v1)
               #   formatted_parent = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
               #
-              #   # TODO: Initialize +create_statement+:
+              #   # TODO: Initialize `create_statement`:
               #   create_statement = ''
               #
               #   # Register a callback during the method call.
@@ -423,7 +423,7 @@ module Google
               #
               # @param name [String]
               #   Required. The name of the requested database. Values are of the form
-              #   +projects/<project>/instances/<instance>/databases/<database>+.
+              #   `projects/<project>/instances/<instance>/databases/<database>`.
               # @param options [Google::Gax::CallOptions]
               #   Overrides the default settings for this call, e.g, timeout,
               #   retries, etc.
@@ -453,7 +453,7 @@ module Google
               # Updates the schema of a Cloud Spanner database by
               # creating/altering/dropping tables, columns, indexes, etc. The returned
               # {Google::Longrunning::Operation long-running operation} will have a name of
-              # the format +<database_name>/operations/<operation_id>+ and can be used to
+              # the format `<database_name>/operations/<operation_id>` and can be used to
               # track execution of the schema change(s). The
               # {Google::Longrunning::Operation#metadata metadata} field type is
               # {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlMetadata UpdateDatabaseDdlMetadata}.  The operation has no response.
@@ -464,7 +464,7 @@ module Google
               #   DDL statements to be applied to the database.
               # @param operation_id [String]
               #   If empty, the new update request is assigned an
-              #   automatically-generated operation ID. Otherwise, +operation_id+
+              #   automatically-generated operation ID. Otherwise, `operation_id`
               #   is used to construct the name of the resulting
               #   {Google::Longrunning::Operation Operation}.
               #
@@ -472,16 +472,16 @@ module Google
               #   whether the statements were executed in the event that the
               #   {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl} call is replayed,
               #   or the return value is otherwise lost: the {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest#database database} and
-              #   +operation_id+ fields can be combined to form the
+              #   `operation_id` fields can be combined to form the
               #   {Google::Longrunning::Operation#name name} of the resulting
-              #   {Google::Longrunning::Operation longrunning::Operation}: +<database>/operations/<operation_id>+.
+              #   {Google::Longrunning::Operation longrunning::Operation}: `<database>/operations/<operation_id>`.
               #
-              #   +operation_id+ should be unique within the database, and must be
-              #   a valid identifier: +[a-z][a-z0-9_]*+. Note that
+              #   `operation_id` should be unique within the database, and must be
+              #   a valid identifier: `[a-z][a-z0-9_]*`. Note that
               #   automatically-generated operation IDs always begin with an
               #   underscore. If the named operation already exists,
               #   {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl} returns
-              #   +ALREADY_EXISTS+.
+              #   `ALREADY_EXISTS`.
               # @param options [Google::Gax::CallOptions]
               #   Overrides the default settings for this call, e.g, timeout,
               #   retries, etc.
@@ -493,7 +493,7 @@ module Google
               #   database_admin_client = Google::Cloud::Spanner::Admin::Database.new(version: :v1)
               #   formatted_database = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdminClient.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
               #
-              #   # TODO: Initialize +statements+:
+              #   # TODO: Initialize `statements`:
               #   statements = []
               #
               #   # Register a callback during the method call.
@@ -610,15 +610,15 @@ module Google
               # Sets the access control policy on a database resource. Replaces any
               # existing policy.
               #
-              # Authorization requires +spanner.databases.setIamPolicy+ permission on
+              # Authorization requires `spanner.databases.setIamPolicy` permission on
               # {Google::Iam::V1::SetIamPolicyRequest#resource resource}.
               #
               # @param resource [String]
               #   REQUIRED: The resource for which the policy is being specified.
-              #   +resource+ is usually specified as a path. For example, a Project
-              #   resource is specified as +projects/\\{project}+.
+              #   `resource` is usually specified as a path. For example, a Project
+              #   resource is specified as `projects/{project}`.
               # @param policy [Google::Iam::V1::Policy | Hash]
-              #   REQUIRED: The complete policy to be applied to the +resource+. The size of
+              #   REQUIRED: The complete policy to be applied to the `resource`. The size of
               #   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.
@@ -638,7 +638,7 @@ module Google
               #   database_admin_client = Google::Cloud::Spanner::Admin::Database.new(version: :v1)
               #   formatted_resource = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdminClient.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
               #
-              #   # TODO: Initialize +policy+:
+              #   # TODO: Initialize `policy`:
               #   policy = {}
               #   response = database_admin_client.set_iam_policy(formatted_resource, policy)
 
@@ -658,13 +658,13 @@ module Google
               # Gets the access control policy for a database resource. Returns an empty
               # policy if a database exists but does not have a policy set.
               #
-              # Authorization requires +spanner.databases.getIamPolicy+ permission on
+              # Authorization requires `spanner.databases.getIamPolicy` permission on
               # {Google::Iam::V1::GetIamPolicyRequest#resource resource}.
               #
               # @param resource [String]
               #   REQUIRED: The resource for which the policy is being requested.
-              #   +resource+ is usually specified as a path. For example, a Project
-              #   resource is specified as +projects/\\{project}+.
+              #   `resource` is usually specified as a path. For example, a Project
+              #   resource is specified as `projects/{project}`.
               # @param options [Google::Gax::CallOptions]
               #   Overrides the default settings for this call, e.g, timeout,
               #   retries, etc.
@@ -694,16 +694,16 @@ module Google
               # Returns permissions that the caller has on the specified database resource.
               #
               # Attempting this RPC on a non-existent Cloud Spanner database will result in
-              # a NOT_FOUND error if the user has +spanner.databases.list+ permission on
+              # a NOT_FOUND error if the user has `spanner.databases.list` permission on
               # the containing Cloud Spanner instance. Otherwise returns an empty set of
               # permissions.
               #
               # @param resource [String]
               #   REQUIRED: The resource for which the policy detail is being requested.
-              #   +resource+ is usually specified as a path. For example, a Project
-              #   resource is specified as +projects/\\{project}+.
+              #   `resource` is usually specified as a path. For example, a Project
+              #   resource is specified as `projects/{project}`.
               # @param permissions [Array<String>]
-              #   The set of permissions to check for the +resource+. Permissions with
+              #   The set of permissions to check for the `resource`. Permissions with
               #   wildcards (such as '*' or 'storage.*') are not allowed. For more
               #   information see
               #   [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
@@ -721,7 +721,7 @@ module Google
               #   database_admin_client = Google::Cloud::Spanner::Admin::Database.new(version: :v1)
               #   formatted_resource = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdminClient.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
               #
-              #   # TODO: Initialize +permissions+:
+              #   # TODO: Initialize `permissions`:
               #   permissions = []
               #   response = database_admin_client.test_iam_permissions(formatted_resource, permissions)
 

data/lib/google/cloud/spanner/admin/database/v1/doc/google/iam/v1/iam_policy.rb

@@ -16,46 +16,46 @@
 module Google
   module Iam
     module V1
-      # Request message for +SetIamPolicy+ method.
+      # Request message for `SetIamPolicy` method.
       # @!attribute [rw] resource
       #   @return [String]
       #     REQUIRED: The resource for which the policy is being specified.
-      #     +resource+ is usually specified as a path. For example, a Project
-      #     resource is specified as +projects/\\{project}+.
+      #     `resource` is usually specified as a path. For example, a Project
+      #     resource is specified as `projects/{project}`.
       # @!attribute [rw] policy
       #   @return [Google::Iam::V1::Policy]
-      #     REQUIRED: The complete policy to be applied to the +resource+. The size of
+      #     REQUIRED: The complete policy to be applied to the `resource`. The size of
       #     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.
       class SetIamPolicyRequest; end
 
-      # Request message for +GetIamPolicy+ method.
+      # Request message for `GetIamPolicy` method.
       # @!attribute [rw] resource
       #   @return [String]
       #     REQUIRED: The resource for which the policy is being requested.
-      #     +resource+ is usually specified as a path. For example, a Project
-      #     resource is specified as +projects/\\{project}+.
+      #     `resource` is usually specified as a path. For example, a Project
+      #     resource is specified as `projects/{project}`.
       class GetIamPolicyRequest; end
 
-      # Request message for +TestIamPermissions+ method.
+      # Request message for `TestIamPermissions` method.
       # @!attribute [rw] resource
       #   @return [String]
       #     REQUIRED: The resource for which the policy detail is being requested.
-      #     +resource+ is usually specified as a path. For example, a Project
-      #     resource is specified as +projects/\\{project}+.
+      #     `resource` is usually specified as a path. For example, a Project
+      #     resource is specified as `projects/{project}`.
       # @!attribute [rw] permissions
       #   @return [Array<String>]
-      #     The set of permissions to check for the +resource+. Permissions with
+      #     The set of permissions to check for the `resource`. Permissions with
       #     wildcards (such as '*' or 'storage.*') are not allowed. For more
       #     information see
       #     [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
       class TestIamPermissionsRequest; end
 
-      # Response message for +TestIamPermissions+ method.
+      # Response message for `TestIamPermissions` method.
       # @!attribute [rw] permissions
       #   @return [Array<String>]
-      #     A subset of +TestPermissionsRequest.permissions+ that the caller is
+      #     A subset of `TestPermissionsRequest.permissions` that the caller is
       #     allowed.
       class TestIamPermissionsResponse; end
     end

data/lib/google/cloud/spanner/admin/database/v1/doc/google/iam/v1/policy.rb

@@ -20,9 +20,9 @@ module Google
       # specify access control policies for Cloud Platform resources.
       #
       #
-      # A +Policy+ consists of a list of +bindings+. A +Binding+ binds a list of
-      # +members+ to a +role+, where the members can be user accounts, Google groups,
-      # Google domains, and service accounts. A +role+ is a named list of permissions
+      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # `members` to a `role`, where the members can be user accounts, Google groups,
+      # Google domains, and service accounts. A `role` is a named list of permissions
       # defined by IAM.
       #
       # **Example**
@@ -49,55 +49,55 @@ module Google
       # [IAM developer's guide](https://cloud.google.com/iam).
       # @!attribute [rw] version
       #   @return [Integer]
-      #     Version of the +Policy+. The default version is 0.
+      #     Version of the `Policy`. The default version is 0.
       # @!attribute [rw] bindings
       #   @return [Array<Google::Iam::V1::Binding>]
-      #     Associates a list of +members+ to a +role+.
-      #     Multiple +bindings+ must not be specified for the same +role+.
-      #     +bindings+ with no members will result in an error.
+      #     Associates a list of `members` to a `role`.
+      #     Multiple `bindings` must not be specified for the same `role`.
+      #     `bindings` with no members will result in an error.
       # @!attribute [rw] etag
       #   @return [String]
-      #     +etag+ is used for optimistic concurrency control as a way to help
+      #     `etag` is used for optimistic concurrency control as a way to help
       #     prevent simultaneous updates of a policy from overwriting each other.
-      #     It is strongly suggested that systems make use of the +etag+ in the
+      #     It is strongly suggested that systems make use of the `etag` in the
       #     read-modify-write cycle to perform policy updates in order to avoid race
-      #     conditions: An +etag+ is returned in the response to +getIamPolicy+, and
-      #     systems are expected to put that etag in the request to +setIamPolicy+ to
+      #     conditions: An `etag` is returned in the response to `getIamPolicy`, and
+      #     systems are expected to put that etag in the request to `setIamPolicy` to
       #     ensure that their change will be applied to the same version of the policy.
       #
-      #     If no +etag+ is provided in the call to +setIamPolicy+, then the existing
+      #     If no `etag` is provided in the call to `setIamPolicy`, then the existing
       #     policy is overwritten blindly.
       class Policy; end
 
-      # Associates +members+ with a +role+.
+      # Associates `members` with a `role`.
       # @!attribute [rw] role
       #   @return [String]
-      #     Role that is assigned to +members+.
-      #     For example, +roles/viewer+, +roles/editor+, or +roles/owner+.
+      #     Role that is assigned to `members`.
+      #     For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
       #     Required
       # @!attribute [rw] members
       #   @return [Array<String>]
       #     Specifies the identities requesting access for a Cloud Platform resource.
-      #     +members+ can have the following values:
+      #     `members` can have the following values:
       #
-      #     * +allUsers+: A special identifier that represents anyone who is
+      #     * `allUsers`: A special identifier that represents anyone who is
       #       on the internet; with or without a Google account.
       #
-      #     * +allAuthenticatedUsers+: A special identifier that represents anyone
+      #     * `allAuthenticatedUsers`: A special identifier that represents anyone
       #       who is authenticated with a Google account or a service account.
       #
-      #     * +user:\\{emailid}+: An email address that represents a specific Google
-      #       account. For example, +alice@gmail.com+ or +joe@example.com+.
+      #     * `user:{emailid}`: An email address that represents a specific Google
+      #       account. For example, `alice@gmail.com` or `joe@example.com`.
       #
       #
-      #     * +serviceAccount:\\{emailid}+: An email address that represents a service
-      #       account. For example, +my-other-app@appspot.gserviceaccount.com+.
+      #     * `serviceAccount:{emailid}`: An email address that represents a service
+      #       account. For example, `my-other-app@appspot.gserviceaccount.com`.
       #
-      #     * +group:\\{emailid}+: An email address that represents a Google group.
-      #       For example, +admins@example.com+.
+      #     * `group:{emailid}`: An email address that represents a Google group.
+      #       For example, `admins@example.com`.
       #
-      #     * +domain:\\{domain}+: A Google Apps domain name that represents all the
-      #       users of that domain. For example, +google.com+ or +example.com+.
+      #     * `domain:{domain}`: A Google Apps domain name that represents all the
+      #       users of that domain. For example, `google.com` or `example.com`.
       class Binding; end
 
       # The difference delta between two policies.
@@ -114,8 +114,8 @@ module Google
       #     Required
       # @!attribute [rw] role
       #   @return [String]
-      #     Role that is assigned to +members+.
-      #     For example, +roles/viewer+, +roles/editor+, or +roles/owner+.
+      #     Role that is assigned to `members`.
+      #     For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
       #     Required
       # @!attribute [rw] member
       #   @return [String]

data/lib/google/cloud/spanner/admin/database/v1/doc/google/longrunning/operations.rb

@@ -21,7 +21,7 @@ module Google
     #   @return [String]
     #     The server-assigned name, which is only unique within the same service that
     #     originally returns it. If you use the default HTTP mapping, the
-    #     +name+ should have the format of +operations/some/unique/name+.
+    #     `name` should have the format of `operations/some/unique/name`.
     # @!attribute [rw] metadata
     #   @return [Google::Protobuf::Any]
     #     Service-specific metadata associated with the operation.  It typically
@@ -30,8 +30,8 @@ module Google
     #     long-running operation should document the metadata type, if any.
     # @!attribute [rw] done
     #   @return [true, false]
-    #     If the value is +false+, it means the operation is still in progress.
-    #     If true, the operation is completed, and either +error+ or +response+ is
+    #     If the value is `false`, it means the operation is still in progress.
+    #     If true, the operation is completed, and either `error` or `response` is
     #     available.
     # @!attribute [rw] error
     #   @return [Google::Rpc::Status]
@@ -39,13 +39,13 @@ module Google
     # @!attribute [rw] response
     #   @return [Google::Protobuf::Any]
     #     The normal response of the operation in case of success.  If the original
-    #     method returns no data on success, such as +Delete+, the response is
-    #     +google.protobuf.Empty+.  If the original method is standard
-    #     +Get+/+Create+/+Update+, the response should be the resource.  For other
-    #     methods, the response should have the type +XxxResponse+, where +Xxx+
+    #     method returns no data on success, such as `Delete`, the response is
+    #     `google.protobuf.Empty`.  If the original method is standard
+    #     `Get`/`Create`/`Update`, the response should be the resource.  For other
+    #     methods, the response should have the type `XxxResponse`, where `Xxx`
     #     is the original method name.  For example, if the original method name
-    #     is +TakeSnapshot()+, the inferred response type is
-    #     +TakeSnapshotResponse+.
+    #     is `TakeSnapshot()`, the inferred response type is
+    #     `TakeSnapshotResponse`.
     class Operation; end
 
     # The request message for {Google::Longrunning::Operations::GetOperation Operations::GetOperation}.

data/lib/google/cloud/spanner/admin/database/v1/doc/google/protobuf/any.rb

@@ -15,7 +15,7 @@
 
 module Google
   module Protobuf
-    # +Any+ contains an arbitrary serialized protocol buffer message along with a
+    # `Any` contains an arbitrary serialized protocol buffer message along with a
     # URL that describes the type of the serialized message.
     #
     # Protobuf library provides support to pack/unpack Any values in the form
@@ -69,9 +69,9 @@ module Google
     #
     # = JSON
     #
-    # The JSON representation of an +Any+ value uses the regular
+    # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
-    # additional field +@type+ which contains the type URL. Example:
+    # additional field `@type` which contains the type URL. Example:
     #
     #     package google.profile;
     #     message Person {
@@ -87,7 +87,7 @@ module Google
     #
     # If the embedded message type is well-known and has a custom JSON
     # representation, that representation will be embedded adding a field
-    # +value+ which holds the custom JSON in addition to the +@type+
+    # `value` which holds the custom JSON in addition to the `@type`
     # field. Example (for message {Google::Protobuf::Duration}):
     #
     #     {
@@ -99,15 +99,15 @@ module Google
     #     A URL/resource name that uniquely identifies the type of the serialized
     #     protocol buffer message. The last segment of the URL's path must represent
     #     the fully qualified name of the type (as in
-    #     +path/google.protobuf.Duration+). The name should be in a canonical form
+    #     `path/google.protobuf.Duration`). The name should be in a canonical form
     #     (e.g., leading "." is not accepted).
     #
     #     In practice, teams usually precompile into the binary all types that they
     #     expect it to use in the context of Any. However, for URLs which use the
-    #     scheme +http+, +https+, or no scheme, one can optionally set up a type
+    #     scheme `http`, `https`, or no scheme, one can optionally set up a type
     #     server that maps type URLs to message definitions as follows:
     #
-    #     * If no scheme is provided, +https+ is assumed.
+    #     * If no scheme is provided, `https` is assumed.
     #     * An HTTP GET on the URL must yield a {Google::Protobuf::Type}
     #       value in binary format, or produce an error.
     #     * Applications are allowed to cache lookup results based on the
@@ -120,7 +120,7 @@ module Google
     #     protobuf release, and it is not used for type URLs beginning with
     #     type.googleapis.com.
     #
-    #     Schemes other than +http+, +https+ (or the empty scheme) might be
+    #     Schemes other than `http`, `https` (or the empty scheme) might be
     #     used with implementation specific semantics.
     # @!attribute [rw] value
     #   @return [String]

data/lib/google/cloud/spanner/admin/database/v1/doc/google/protobuf/empty.rb

@@ -23,7 +23,7 @@ module Google
     #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
     #     }
     #
-    # The JSON representation for +Empty+ is empty JSON object +{}+.
+    # The JSON representation for `Empty` is empty JSON object `{}`.
     class Empty; end
   end
 end

data/lib/google/cloud/spanner/admin/database/v1/doc/google/rpc/status.rb

@@ -15,7 +15,7 @@
 
 module Google
   module Rpc
-    # The +Status+ type defines a logical error model that is suitable for different
+    # The `Status` type defines a logical error model that is suitable for different
     # programming environments, including REST APIs and RPC APIs. It is used by
     # [gRPC](https://github.com/grpc). The error model is designed to be:
     #
@@ -24,7 +24,7 @@ module Google
     #
     # = Overview
     #
-    # The +Status+ message contains three pieces of data: error code, error message,
+    # The `Status` message contains three pieces of data: error code, error message,
     # and error details. The error code should be an enum value of
     # {Google::Rpc::Code}, but it may accept additional error codes if needed.  The
     # error message should be a developer-facing English message that helps
@@ -32,40 +32,40 @@ module Google
     # error message is needed, put the localized message in the error details or
     # localize it in the client. The optional error details may contain arbitrary
     # information about the error. There is a predefined set of error detail types
-    # in the package +google.rpc+ that can be used for common error conditions.
+    # in the package `google.rpc` that can be used for common error conditions.
     #
     # = Language mapping
     #
-    # The +Status+ message is the logical representation of the error model, but it
-    # is not necessarily the actual wire format. When the +Status+ message is
+    # The `Status` message is the logical representation of the error model, but it
+    # is not necessarily the actual wire format. When the `Status` message is
     # exposed in different client libraries and different wire protocols, it can be
     # mapped differently. For example, it will likely be mapped to some exceptions
     # in Java, but more likely mapped to some error codes in C.
     #
     # = Other uses
     #
-    # The error model and the +Status+ message can be used in a variety of
+    # The error model and the `Status` message can be used in a variety of
     # environments, either with or without APIs, to provide a
     # consistent developer experience across different environments.
     #
     # Example uses of this error model include:
     #
     # * Partial errors. If a service needs to return partial errors to the client,
-    #   it may embed the +Status+ in the normal response to indicate the partial
+    #   it may embed the `Status` in the normal response to indicate the partial
     #   errors.
     #
     # * Workflow errors. A typical workflow has multiple steps. Each step may
-    #   have a +Status+ message for error reporting.
+    #   have a `Status` message for error reporting.
     #
     # * Batch operations. If a client uses batch request and batch response, the
-    #   +Status+ message should be used directly inside batch response, one for
+    #   `Status` message should be used directly inside batch response, one for
     #   each error sub-response.
     #
     # * Asynchronous operations. If an API call embeds asynchronous operation
     #   results in its response, the status of those operations should be
-    #   represented directly using the +Status+ message.
+    #   represented directly using the `Status` message.
     #
-    # * Logging. If some API errors are stored in logs, the message +Status+ could
+    # * Logging. If some API errors are stored in logs, the message `Status` could
     #   be used directly after any stripping needed for security/privacy reasons.
     # @!attribute [rw] code
     #   @return [Integer]