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.callsets.html b/docs/dyn/genomics_v1.callsets.html
index cc22f1c..261095d 100644
--- a/docs/dyn/genomics_v1.callsets.html
+++ b/docs/dyn/genomics_v1.callsets.html
@@ -106,40 +106,8 @@
The object takes the form of:
{ # A call set is a collection of variant calls, typically for one sample. It
- # belongs to a variant set.
- #
- # For more genomics resource definitions, see [Fundamentals of Google
- # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
- "info": { # A map of additional call set 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 call set name.
- "created": "A String", # The date this call set was created in milliseconds from the epoch.
- "sampleId": "A String", # The sample ID this call set corresponds to.
- "variantSetIds": [ # The IDs of the variant sets this call set belongs to. This field must
- # have exactly length one, as a call set belongs to a single variant set.
- # This field is repeated for compatibility with the
- # [GA4GH 0.5.1
- # API](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variants.avdl#L76).
- "A String",
- ],
- "id": "A String", # The server-generated call set ID, unique across all call sets.
-}
-
- x__xgafv: string, V1 error format.
- Allowed values
- 1 - v1 error format
- 2 - v2 error format
-
-Returns:
- An object of the form:
-
- { # A call set is a collection of variant calls, typically for one sample. It
# belongs to a variant set.
- #
+ #
# For more genomics resource definitions, see [Fundamentals of Google
# Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
"info": { # A map of additional call set information. This must be of the form
@@ -159,7 +127,39 @@
"A String",
],
"id": "A String", # The server-generated call set ID, unique across all call sets.
- }</pre>
+ }
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # A call set is a collection of variant calls, typically for one sample. It
+ # belongs to a variant set.
+ #
+ # For more genomics resource definitions, see [Fundamentals of Google
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
+ "info": { # A map of additional call set 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 call set name.
+ "created": "A String", # The date this call set was created in milliseconds from the epoch.
+ "sampleId": "A String", # The sample ID this call set corresponds to.
+ "variantSetIds": [ # The IDs of the variant sets this call set belongs to. This field must
+ # have exactly length one, as a call set belongs to a single variant set.
+ # This field is repeated for compatibility with the
+ # [GA4GH 0.5.1
+ # API](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variants.avdl#L76).
+ "A String",
+ ],
+ "id": "A String", # The server-generated call set ID, unique across all call sets.
+ }</pre>
</div>
<div class="method">
@@ -211,28 +211,28 @@
An object of the form:
{ # A call set is a collection of variant calls, typically for one sample. It
- # belongs to a variant set.
- #
- # For more genomics resource definitions, see [Fundamentals of Google
- # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
- "info": { # A map of additional call set information. This must be of the form
- # map<string, string[]> (string key mapping to a list of string values).
- "a_key": [
- "",
+ # belongs to a variant set.
+ #
+ # For more genomics resource definitions, see [Fundamentals of Google
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
+ "info": { # A map of additional call set 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 call set name.
+ "created": "A String", # The date this call set was created in milliseconds from the epoch.
+ "sampleId": "A String", # The sample ID this call set corresponds to.
+ "variantSetIds": [ # The IDs of the variant sets this call set belongs to. This field must
+ # have exactly length one, as a call set belongs to a single variant set.
+ # This field is repeated for compatibility with the
+ # [GA4GH 0.5.1
+ # API](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variants.avdl#L76).
+ "A String",
],
- },
- "name": "A String", # The call set name.
- "created": "A String", # The date this call set was created in milliseconds from the epoch.
- "sampleId": "A String", # The sample ID this call set corresponds to.
- "variantSetIds": [ # The IDs of the variant sets this call set belongs to. This field must
- # have exactly length one, as a call set belongs to a single variant set.
- # This field is repeated for compatibility with the
- # [GA4GH 0.5.1
- # API](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variants.avdl#L76).
- "A String",
- ],
- "id": "A String", # The server-generated call set ID, unique across all call sets.
- }</pre>
+ "id": "A String", # The server-generated call set ID, unique across all call sets.
+ }</pre>
</div>
<div class="method">
@@ -251,44 +251,8 @@
The object takes the form of:
{ # A call set is a collection of variant calls, typically for one sample. It
- # belongs to a variant set.
- #
- # For more genomics resource definitions, see [Fundamentals of Google
- # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
- "info": { # A map of additional call set 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 call set name.
- "created": "A String", # The date this call set was created in milliseconds from the epoch.
- "sampleId": "A String", # The sample ID this call set corresponds to.
- "variantSetIds": [ # The IDs of the variant sets this call set belongs to. This field must
- # have exactly length one, as a call set belongs to a single variant set.
- # This field is repeated for compatibility with the
- # [GA4GH 0.5.1
- # API](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variants.avdl#L76).
- "A String",
- ],
- "id": "A String", # The server-generated call set ID, unique across all call sets.
-}
-
- updateMask: string, An optional mask specifying which fields to update. At this time, the only
-mutable field is name. The only
-acceptable value is "name". 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:
-
- { # A call set is a collection of variant calls, typically for one sample. It
# belongs to a variant set.
- #
+ #
# For more genomics resource definitions, see [Fundamentals of Google
# Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
"info": { # A map of additional call set information. This must be of the form
@@ -308,7 +272,43 @@
"A String",
],
"id": "A String", # The server-generated call set ID, unique across all call sets.
- }</pre>
+ }
+
+ updateMask: string, An optional mask specifying which fields to update. At this time, the only
+mutable field is name. The only
+acceptable value is "name". 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:
+
+ { # A call set is a collection of variant calls, typically for one sample. It
+ # belongs to a variant set.
+ #
+ # For more genomics resource definitions, see [Fundamentals of Google
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
+ "info": { # A map of additional call set 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 call set name.
+ "created": "A String", # The date this call set was created in milliseconds from the epoch.
+ "sampleId": "A String", # The sample ID this call set corresponds to.
+ "variantSetIds": [ # The IDs of the variant sets this call set belongs to. This field must
+ # have exactly length one, as a call set belongs to a single variant set.
+ # This field is repeated for compatibility with the
+ # [GA4GH 0.5.1
+ # API](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variants.avdl#L76).
+ "A String",
+ ],
+ "id": "A String", # The server-generated call set ID, unique across all call sets.
+ }</pre>
</div>
<div class="method">
@@ -354,28 +354,28 @@
# results. This field will be empty if there aren't any additional results.
"callSets": [ # The list of matching call sets.
{ # A call set is a collection of variant calls, typically for one sample. It
- # belongs to a variant set.
- #
- # For more genomics resource definitions, see [Fundamentals of Google
- # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
- "info": { # A map of additional call set information. This must be of the form
- # map<string, string[]> (string key mapping to a list of string values).
- "a_key": [
- "",
+ # belongs to a variant set.
+ #
+ # For more genomics resource definitions, see [Fundamentals of Google
+ # Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
+ "info": { # A map of additional call set 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 call set name.
+ "created": "A String", # The date this call set was created in milliseconds from the epoch.
+ "sampleId": "A String", # The sample ID this call set corresponds to.
+ "variantSetIds": [ # The IDs of the variant sets this call set belongs to. This field must
+ # have exactly length one, as a call set belongs to a single variant set.
+ # This field is repeated for compatibility with the
+ # [GA4GH 0.5.1
+ # API](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variants.avdl#L76).
+ "A String",
],
+ "id": "A String", # The server-generated call set ID, unique across all call sets.
},
- "name": "A String", # The call set name.
- "created": "A String", # The date this call set was created in milliseconds from the epoch.
- "sampleId": "A String", # The sample ID this call set corresponds to.
- "variantSetIds": [ # The IDs of the variant sets this call set belongs to. This field must
- # have exactly length one, as a call set belongs to a single variant set.
- # This field is repeated for compatibility with the
- # [GA4GH 0.5.1
- # API](https://github.com/ga4gh/schemas/blob/v0.5.1/src/main/resources/avro/variants.avdl#L76).
- "A String",
- ],
- "id": "A String", # The server-generated call set ID, unique across all call sets.
- },
],
}</pre>
</div>