Fix method doc signatures for multiline required parameters (#374)
* Fix method doc signatures for multiline required parameters.
Existing doc generator failed to recognize parameters as required when parameter descriptions
extended over more than one line. Besides presenting incorrect information, resulting
inconsistencies broke checks for automated sample generation.
* Regen docs
diff --git a/docs/dyn/cloudbuild_v1.projects.builds.html b/docs/dyn/cloudbuild_v1.projects.builds.html
index 87c4873..d679463 100644
--- a/docs/dyn/cloudbuild_v1.projects.builds.html
+++ b/docs/dyn/cloudbuild_v1.projects.builds.html
@@ -168,15 +168,6 @@
},
"source": { # Source describes the location of the source in a supported storage # Describes where to find the source files to build.
# service.
- "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
- # Repository.
- "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
- # the build is assumed.
- "branchName": "A String", # Name of the branch to build.
- "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
- "tagName": "A String", # Name of the tag to build.
- "commitSha": "A String", # Explicit commit SHA to build.
- },
"storageSource": { # StorageSource describes the location of the source in an archive file in # If provided, get the source from this location in in Google Cloud
# Storage.
# Google Cloud Storage.
@@ -190,6 +181,15 @@
# [Bucket Name
# Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
},
+ "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
+ # Repository.
+ "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
+ # the build is assumed.
+ "branchName": "A String", # Name of the branch to build.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "tagName": "A String", # Name of the tag to build.
+ "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
+ },
},
"buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
# triggered automatically.
@@ -250,9 +250,9 @@
"projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
# the build is assumed.
"branchName": "A String", # Name of the branch to build.
- "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
- "tagName": "A String", # Name of the tag to build.
"commitSha": "A String", # Explicit commit SHA to build.
+ "tagName": "A String", # Name of the tag to build.
+ "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
},
"fileHashes": { # Hash(es) of the build source, which can be used to verify that the original
# source integrity was maintained in the build. Note that FileHashes will
@@ -383,15 +383,6 @@
},
"source": { # Source describes the location of the source in a supported storage # Describes where to find the source files to build.
# service.
- "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
- # Repository.
- "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
- # the build is assumed.
- "branchName": "A String", # Name of the branch to build.
- "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
- "tagName": "A String", # Name of the tag to build.
- "commitSha": "A String", # Explicit commit SHA to build.
- },
"storageSource": { # StorageSource describes the location of the source in an archive file in # If provided, get the source from this location in in Google Cloud
# Storage.
# Google Cloud Storage.
@@ -405,6 +396,15 @@
# [Bucket Name
# Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
},
+ "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
+ # Repository.
+ "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
+ # the build is assumed.
+ "branchName": "A String", # Name of the branch to build.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "tagName": "A String", # Name of the tag to build.
+ "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
+ },
},
"buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
# triggered automatically.
@@ -465,9 +465,9 @@
"projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
# the build is assumed.
"branchName": "A String", # Name of the branch to build.
- "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
- "tagName": "A String", # Name of the tag to build.
"commitSha": "A String", # Explicit commit SHA to build.
+ "tagName": "A String", # Name of the tag to build.
+ "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
},
"fileHashes": { # Hash(es) of the build source, which can be used to verify that the original
# source integrity was maintained in the build. Note that FileHashes will
@@ -537,12 +537,6 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "metadata": { # Service-specific metadata associated with the operation. It typically
- # contains progress information and common metadata such as create time.
- # Some services might not provide such metadata. Any method that returns a
- # long-running operation should document the metadata type, if any.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
"error": { # The `Status` type defines a logical error model that is suitable for different # The error result of the operation in case of failure or cancellation.
# programming environments, including REST APIs and RPC APIs. It is used by
# [gRPC](https://github.com/grpc). The error model is designed to be:
@@ -622,6 +616,12 @@
"name": "A 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`.
+ "metadata": { # Service-specific metadata associated with the operation. It typically
+ # contains progress information and common metadata such as create time.
+ # Some services might not provide such metadata. Any method that returns a
+ # long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
}</pre>
</div>
@@ -700,15 +700,6 @@
},
"source": { # Source describes the location of the source in a supported storage # Describes where to find the source files to build.
# service.
- "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
- # Repository.
- "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
- # the build is assumed.
- "branchName": "A String", # Name of the branch to build.
- "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
- "tagName": "A String", # Name of the tag to build.
- "commitSha": "A String", # Explicit commit SHA to build.
- },
"storageSource": { # StorageSource describes the location of the source in an archive file in # If provided, get the source from this location in in Google Cloud
# Storage.
# Google Cloud Storage.
@@ -722,6 +713,15 @@
# [Bucket Name
# Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
},
+ "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
+ # Repository.
+ "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
+ # the build is assumed.
+ "branchName": "A String", # Name of the branch to build.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "tagName": "A String", # Name of the tag to build.
+ "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
+ },
},
"buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
# triggered automatically.
@@ -782,9 +782,9 @@
"projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
# the build is assumed.
"branchName": "A String", # Name of the branch to build.
- "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
- "tagName": "A String", # Name of the tag to build.
"commitSha": "A String", # Explicit commit SHA to build.
+ "tagName": "A String", # Name of the tag to build.
+ "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
},
"fileHashes": { # Hash(es) of the build source, which can be used to verify that the original
# source integrity was maintained in the build. Note that FileHashes will
@@ -925,15 +925,6 @@
},
"source": { # Source describes the location of the source in a supported storage # Describes where to find the source files to build.
# service.
- "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
- # Repository.
- "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
- # the build is assumed.
- "branchName": "A String", # Name of the branch to build.
- "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
- "tagName": "A String", # Name of the tag to build.
- "commitSha": "A String", # Explicit commit SHA to build.
- },
"storageSource": { # StorageSource describes the location of the source in an archive file in # If provided, get the source from this location in in Google Cloud
# Storage.
# Google Cloud Storage.
@@ -947,6 +938,15 @@
# [Bucket Name
# Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
},
+ "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
+ # Repository.
+ "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
+ # the build is assumed.
+ "branchName": "A String", # Name of the branch to build.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "tagName": "A String", # Name of the tag to build.
+ "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
+ },
},
"buildTriggerId": "A String", # The ID of the BuildTrigger that triggered this build, if it was
# triggered automatically.
@@ -1007,9 +1007,9 @@
"projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
# the build is assumed.
"branchName": "A String", # Name of the branch to build.
- "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
- "tagName": "A String", # Name of the tag to build.
"commitSha": "A String", # Explicit commit SHA to build.
+ "tagName": "A String", # Name of the tag to build.
+ "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
},
"fileHashes": { # Hash(es) of the build source, which can be used to verify that the original
# source integrity was maintained in the build. Note that FileHashes will