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/genomics_v1.annotationsets.html b/docs/dyn/genomics_v1.annotationsets.html
index 780e01d..4628af6 100644
--- a/docs/dyn/genomics_v1.annotationsets.html
+++ b/docs/dyn/genomics_v1.annotationsets.html
@@ -90,7 +90,7 @@
<code><a href="#search_next">search_next(previous_request, previous_response)</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<p class="toc_element">
- <code><a href="#update">update(annotationSetId, body, x__xgafv=None, updateMask=None)</a></code></p>
+ <code><a href="#update">update(annotationSetId, body, updateMask=None, x__xgafv=None)</a></code></p>
<p class="firstline">Updates an annotation set. The update must respect all mutability</p>
<h3>Method Details</h3>
<div class="method">
@@ -111,33 +111,6 @@
The object takes the form of:
{ # An annotation set is a logical grouping of annotations that share consistent
- # type information and provenance. Examples of annotation sets include 'all
- # genes from refseq', and 'all variant annotations from ClinVar'.
- "info": { # A map of additional read alignment information. This must be of the form
- # map<string, string[]> (string key mapping to a list of string values).
- "a_key": [
- "",
- ],
- },
- "name": "A String", # The display name for this annotation set.
- "sourceUri": "A String", # The source URI describing the file from which this annotation set was
- # generated, if any.
- "referenceSetId": "A String", # The ID of the reference set that defines the coordinate space for this
- # set's annotations.
- "type": "A String", # The type of annotations contained within this set.
- "id": "A String", # The server-generated annotation set ID, unique across all annotation sets.
- "datasetId": "A String", # The dataset to which this annotation set belongs.
-}
-
- x__xgafv: string, V1 error format.
- Allowed values
- 1 - v1 error format
- 2 - v2 error format
-
-Returns:
- An object of the form:
-
- { # An annotation set is a logical grouping of annotations that share consistent
# type information and provenance. Examples of annotation sets include 'all
# genes from refseq', and 'all variant annotations from ClinVar'.
"info": { # A map of additional read alignment information. This must be of the form
@@ -154,7 +127,34 @@
"type": "A String", # The type of annotations contained within this set.
"id": "A String", # The server-generated annotation set ID, unique across all annotation sets.
"datasetId": "A String", # The dataset to which this annotation set belongs.
- }</pre>
+ }
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # An annotation set is a logical grouping of annotations that share consistent
+ # type information and provenance. Examples of annotation sets include 'all
+ # genes from refseq', and 'all variant annotations from ClinVar'.
+ "info": { # A map of additional read alignment information. This must be of the form
+ # map<string, string[]> (string key mapping to a list of string values).
+ "a_key": [
+ "",
+ ],
+ },
+ "name": "A String", # The display name for this annotation set.
+ "sourceUri": "A String", # The source URI describing the file from which this annotation set was
+ # generated, if any.
+ "referenceSetId": "A String", # The ID of the reference set that defines the coordinate space for this
+ # set's annotations.
+ "type": "A String", # The type of annotations contained within this set.
+ "id": "A String", # The server-generated annotation set ID, unique across all annotation sets.
+ "datasetId": "A String", # The dataset to which this annotation set belongs.
+ }</pre>
</div>
<div class="method">
@@ -200,23 +200,23 @@
An object of the form:
{ # An annotation set is a logical grouping of annotations that share consistent
- # type information and provenance. Examples of annotation sets include 'all
- # genes from refseq', and 'all variant annotations from ClinVar'.
- "info": { # A map of additional read alignment information. This must be of the form
- # map<string, string[]> (string key mapping to a list of string values).
- "a_key": [
- "",
- ],
- },
- "name": "A String", # The display name for this annotation set.
- "sourceUri": "A String", # The source URI describing the file from which this annotation set was
- # generated, if any.
- "referenceSetId": "A String", # The ID of the reference set that defines the coordinate space for this
- # set's annotations.
- "type": "A String", # The type of annotations contained within this set.
- "id": "A String", # The server-generated annotation set ID, unique across all annotation sets.
- "datasetId": "A String", # The dataset to which this annotation set belongs.
- }</pre>
+ # type information and provenance. Examples of annotation sets include 'all
+ # genes from refseq', and 'all variant annotations from ClinVar'.
+ "info": { # A map of additional read alignment information. This must be of the form
+ # map<string, string[]> (string key mapping to a list of string values).
+ "a_key": [
+ "",
+ ],
+ },
+ "name": "A String", # The display name for this annotation set.
+ "sourceUri": "A String", # The source URI describing the file from which this annotation set was
+ # generated, if any.
+ "referenceSetId": "A String", # The ID of the reference set that defines the coordinate space for this
+ # set's annotations.
+ "type": "A String", # The type of annotations contained within this set.
+ "id": "A String", # The server-generated annotation set ID, unique across all annotation sets.
+ "datasetId": "A String", # The dataset to which this annotation set belongs.
+ }</pre>
</div>
<div class="method">
@@ -265,23 +265,23 @@
# results. This field will be empty if there aren't any additional results.
"annotationSets": [ # The matching annotation sets.
{ # An annotation set is a logical grouping of annotations that share consistent
- # type information and provenance. Examples of annotation sets include 'all
- # genes from refseq', and 'all variant annotations from ClinVar'.
- "info": { # A map of additional read alignment information. This must be of the form
- # map<string, string[]> (string key mapping to a list of string values).
- "a_key": [
- "",
- ],
+ # type information and provenance. Examples of annotation sets include 'all
+ # genes from refseq', and 'all variant annotations from ClinVar'.
+ "info": { # A map of additional read alignment information. This must be of the form
+ # map<string, string[]> (string key mapping to a list of string values).
+ "a_key": [
+ "",
+ ],
+ },
+ "name": "A String", # The display name for this annotation set.
+ "sourceUri": "A String", # The source URI describing the file from which this annotation set was
+ # generated, if any.
+ "referenceSetId": "A String", # The ID of the reference set that defines the coordinate space for this
+ # set's annotations.
+ "type": "A String", # The type of annotations contained within this set.
+ "id": "A String", # The server-generated annotation set ID, unique across all annotation sets.
+ "datasetId": "A String", # The dataset to which this annotation set belongs.
},
- "name": "A String", # The display name for this annotation set.
- "sourceUri": "A String", # The source URI describing the file from which this annotation set was
- # generated, if any.
- "referenceSetId": "A String", # The ID of the reference set that defines the coordinate space for this
- # set's annotations.
- "type": "A String", # The type of annotations contained within this set.
- "id": "A String", # The server-generated annotation set ID, unique across all annotation sets.
- "datasetId": "A String", # The dataset to which this annotation set belongs.
- },
],
}</pre>
</div>
@@ -301,7 +301,7 @@
</div>
<div class="method">
- <code class="details" id="update">update(annotationSetId, body, x__xgafv=None, updateMask=None)</code>
+ <code class="details" id="update">update(annotationSetId, body, updateMask=None, x__xgafv=None)</code>
<pre>Updates an annotation set. The update must respect all mutability
restrictions and other invariants described on the annotation set resource.
Caller must have WRITE permission for the associated dataset.
@@ -312,38 +312,6 @@
The object takes the form of:
{ # An annotation set is a logical grouping of annotations that share consistent
- # type information and provenance. Examples of annotation sets include 'all
- # genes from refseq', and 'all variant annotations from ClinVar'.
- "info": { # A map of additional read alignment information. This must be of the form
- # map<string, string[]> (string key mapping to a list of string values).
- "a_key": [
- "",
- ],
- },
- "name": "A String", # The display name for this annotation set.
- "sourceUri": "A String", # The source URI describing the file from which this annotation set was
- # generated, if any.
- "referenceSetId": "A String", # The ID of the reference set that defines the coordinate space for this
- # set's annotations.
- "type": "A String", # The type of annotations contained within this set.
- "id": "A String", # The server-generated annotation set ID, unique across all annotation sets.
- "datasetId": "A String", # The dataset to which this annotation set belongs.
-}
-
- x__xgafv: string, V1 error format.
- Allowed values
- 1 - v1 error format
- 2 - v2 error format
- updateMask: string, An optional mask specifying which fields to update. Mutable fields are
-name,
-source_uri, and
-info. If unspecified, all
-mutable fields will be updated.
-
-Returns:
- An object of the form:
-
- { # An annotation set is a logical grouping of annotations that share consistent
# type information and provenance. Examples of annotation sets include 'all
# genes from refseq', and 'all variant annotations from ClinVar'.
"info": { # A map of additional read alignment information. This must be of the form
@@ -360,7 +328,39 @@
"type": "A String", # The type of annotations contained within this set.
"id": "A String", # The server-generated annotation set ID, unique across all annotation sets.
"datasetId": "A String", # The dataset to which this annotation set belongs.
- }</pre>
+ }
+
+ updateMask: string, An optional mask specifying which fields to update. Mutable fields are
+name,
+source_uri, and
+info. If unspecified, all
+mutable fields will be updated.
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # An annotation set is a logical grouping of annotations that share consistent
+ # type information and provenance. Examples of annotation sets include 'all
+ # genes from refseq', and 'all variant annotations from ClinVar'.
+ "info": { # A map of additional read alignment information. This must be of the form
+ # map<string, string[]> (string key mapping to a list of string values).
+ "a_key": [
+ "",
+ ],
+ },
+ "name": "A String", # The display name for this annotation set.
+ "sourceUri": "A String", # The source URI describing the file from which this annotation set was
+ # generated, if any.
+ "referenceSetId": "A String", # The ID of the reference set that defines the coordinate space for this
+ # set's annotations.
+ "type": "A String", # The type of annotations contained within this set.
+ "id": "A String", # The server-generated annotation set ID, unique across all annotation sets.
+ "datasetId": "A String", # The dataset to which this annotation set belongs.
+ }</pre>
</div>
</body></html>
\ No newline at end of file