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/language_v1beta1.documents.html b/docs/dyn/language_v1beta1.documents.html
index b7f5625..37ff1bf 100644
--- a/docs/dyn/language_v1beta1.documents.html
+++ b/docs/dyn/language_v1beta1.documents.html
@@ -98,6 +98,7 @@
The object takes the form of:
{ # The entity analysis request message.
+ "encodingType": "A String", # The encoding type used by the API to calculate offsets.
"document": { # ################################################################ # # Input document.
#
# Represents the input to API methods.
@@ -118,7 +119,6 @@
# details, see https://cloud.google.com/storage/docs/reference-uris.
# NOTE: Cloud Storage object versioning is not supported.
},
- "encodingType": "A String", # The encoding type used by the API to calculate offsets.
}
x__xgafv: string, V1 error format.
@@ -177,6 +177,8 @@
The object takes the form of:
{ # The sentiment analysis request message.
+ "encodingType": "A String", # The encoding type used by the API to calculate sentence offsets for the
+ # sentence sentiment.
"document": { # ################################################################ # # Input document. Currently, `analyzeSentiment` only supports English text
# (Document.language="EN").
#
@@ -198,8 +200,6 @@
# details, see https://cloud.google.com/storage/docs/reference-uris.
# NOTE: Cloud Storage object versioning is not supported.
},
- "encodingType": "A String", # The encoding type used by the API to calculate sentence offsets for the
- # sentence sentiment.
}
x__xgafv: string, V1 error format.
@@ -216,11 +216,11 @@
"polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
# favor of score. Please refer to our documentation at
# https://cloud.google.com/natural-language/docs for more information.
- "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
- # (positive sentiment).
"magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
# the absolute magnitude of sentiment regardless of score (positive or
# negative).
+ "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+ # (positive sentiment).
},
"language": "A String", # The language of the text, which will be the same as the language specified
# in the request or, if not specified, the automatically-detected language.
@@ -238,11 +238,11 @@
"polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
# favor of score. Please refer to our documentation at
# https://cloud.google.com/natural-language/docs for more information.
- "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
- # (positive sentiment).
"magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
# the absolute magnitude of sentiment regardless of score (positive or
# negative).
+ "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+ # (positive sentiment).
},
},
],
@@ -260,6 +260,7 @@
The object takes the form of:
{ # The syntax analysis request message.
+ "encodingType": "A String", # The encoding type used by the API to calculate offsets.
"document": { # ################################################################ # # Input document.
#
# Represents the input to API methods.
@@ -280,7 +281,6 @@
# details, see https://cloud.google.com/storage/docs/reference-uris.
# NOTE: Cloud Storage object versioning is not supported.
},
- "encodingType": "A String", # The encoding type used by the API to calculate offsets.
}
x__xgafv: string, V1 error format.
@@ -294,11 +294,7 @@
{ # The syntax analysis response message.
"tokens": [ # Tokens, along with their syntactic information, in the input document.
{ # Represents the smallest syntactic building block of the text.
- "text": { # Represents an output piece of text. # The token text.
- "content": "A String", # The content of the output text.
- "beginOffset": 42, # The API calculates the beginning offset of the content in the original
- # document according to the EncodingType specified in the API request.
- },
+ "lemma": "A String", # [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
"dependencyEdge": { # Represents dependency parse tree information for a token. # Dependency tree parse for this token.
"headTokenIndex": 42, # Represents the head of this token in the dependency tree.
# This is the index of the token which has an arc going to this token.
@@ -309,19 +305,23 @@
},
"partOfSpeech": { # Represents part of speech information for a token. # Parts of speech tag for this token.
"case": "A String", # The grammatical case.
- "aspect": "A String", # The grammatical aspect.
+ "reciprocity": "A String", # The grammatical reciprocity.
+ "mood": "A String", # The grammatical mood.
"form": "A String", # The grammatical form.
"gender": "A String", # The grammatical gender.
"number": "A String", # The grammatical number.
"person": "A String", # The grammatical person.
"tag": "A String", # The part of speech tag.
"tense": "A String", # The grammatical tense.
- "reciprocity": "A String", # The grammatical reciprocity.
+ "aspect": "A String", # The grammatical aspect.
"proper": "A String", # The grammatical properness.
"voice": "A String", # The grammatical voice.
- "mood": "A String", # The grammatical mood.
},
- "lemma": "A String", # [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
+ "text": { # Represents an output piece of text. # The token text.
+ "content": "A String", # The content of the output text.
+ "beginOffset": 42, # The API calculates the beginning offset of the content in the original
+ # document according to the EncodingType specified in the API request.
+ },
},
],
"language": "A String", # The language of the text, which will be the same as the language specified
@@ -341,11 +341,11 @@
"polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
# favor of score. Please refer to our documentation at
# https://cloud.google.com/natural-language/docs for more information.
- "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
- # (positive sentiment).
"magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
# the absolute magnitude of sentiment regardless of score (positive or
# negative).
+ "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+ # (positive sentiment).
},
},
],
@@ -405,11 +405,7 @@
# Populated if the user enables
# AnnotateTextRequest.Features.extract_syntax.
{ # Represents the smallest syntactic building block of the text.
- "text": { # Represents an output piece of text. # The token text.
- "content": "A String", # The content of the output text.
- "beginOffset": 42, # The API calculates the beginning offset of the content in the original
- # document according to the EncodingType specified in the API request.
- },
+ "lemma": "A String", # [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
"dependencyEdge": { # Represents dependency parse tree information for a token. # Dependency tree parse for this token.
"headTokenIndex": 42, # Represents the head of this token in the dependency tree.
# This is the index of the token which has an arc going to this token.
@@ -420,19 +416,23 @@
},
"partOfSpeech": { # Represents part of speech information for a token. # Parts of speech tag for this token.
"case": "A String", # The grammatical case.
- "aspect": "A String", # The grammatical aspect.
+ "reciprocity": "A String", # The grammatical reciprocity.
+ "mood": "A String", # The grammatical mood.
"form": "A String", # The grammatical form.
"gender": "A String", # The grammatical gender.
"number": "A String", # The grammatical number.
"person": "A String", # The grammatical person.
"tag": "A String", # The part of speech tag.
"tense": "A String", # The grammatical tense.
- "reciprocity": "A String", # The grammatical reciprocity.
+ "aspect": "A String", # The grammatical aspect.
"proper": "A String", # The grammatical properness.
"voice": "A String", # The grammatical voice.
- "mood": "A String", # The grammatical mood.
},
- "lemma": "A String", # [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
+ "text": { # Represents an output piece of text. # The token text.
+ "content": "A String", # The content of the output text.
+ "beginOffset": 42, # The API calculates the beginning offset of the content in the original
+ # document according to the EncodingType specified in the API request.
+ },
},
],
"entities": [ # Entities, along with their semantic information, in the input document.
@@ -475,11 +475,11 @@
"polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
# favor of score. Please refer to our documentation at
# https://cloud.google.com/natural-language/docs for more information.
- "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
- # (positive sentiment).
"magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
# the absolute magnitude of sentiment regardless of score (positive or
# negative).
+ "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+ # (positive sentiment).
},
"language": "A String", # The language of the text, which will be the same as the language specified
# in the request or, if not specified, the automatically-detected language.
@@ -499,11 +499,11 @@
"polarity": 3.14, # DEPRECATED FIELD - This field is being deprecated in
# favor of score. Please refer to our documentation at
# https://cloud.google.com/natural-language/docs for more information.
- "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
- # (positive sentiment).
"magnitude": 3.14, # A non-negative number in the [0, +inf) range, which represents
# the absolute magnitude of sentiment regardless of score (positive or
# negative).
+ "score": 3.14, # Sentiment score between -1.0 (negative sentiment) and 1.0
+ # (positive sentiment).
},
},
],