Docs/fixit: normalize docs for 'page_size' / 'max_results' / 'page_token' (#6842)

Author: tseaver

packages/google-cloud-spanner/google/cloud/spanner_v1/client.py

@@ -191,10 +191,18 @@ def list_instance_configs(self, page_size=None, page_token=None):
         See `RPC docs`_.
 
         :type page_size: int
-        :param page_size: (Optional) Maximum number of results to return.
+        :param page_size:
+            Optional. The maximum number of configs in each page of results
+            from this request. Non-positive values are ignored. Defaults
+            to a sensible value set by the API.
 
         :type page_token: str
-        :param page_token: (Optional) Token for fetching next page of results.
+        :param page_token:
+            Optional. If present, return the next batch of configs, using
+            the value, which must correspond to the ``nextPageToken`` value
+            returned in the previous response.  Deprecated: use the ``pages``
+            property of the returned iterator instead of manually passing
+            the token.
 
         :rtype: :class:`~google.api_core.page_iterator.Iterator`
         :returns:
@@ -256,10 +264,18 @@ def list_instances(self, filter_="", page_size=None, page_token=None):
                         the ``ListInstancesRequest`` docs above for examples.
 
         :type page_size: int
-        :param page_size: (Optional) Maximum number of results to return.
+        :param page_size:
+            Optional. The maximum number of instances in each page of results
+            from this request. Non-positive values are ignored. Defaults
+            to a sensible value set by the API.
 
         :type page_token: str
-        :param page_token: (Optional) Token for fetching next page of results.
+        :param page_token:
+            Optional. If present, return the next batch of instances, using
+            the value, which must correspond to the ``nextPageToken`` value
+            returned in the previous response.  Deprecated: use the ``pages``
+            property of the returned iterator instead of manually passing
+            the token.
 
         :rtype: :class:`~google.api_core.page_iterator.Iterator`
         :returns:

packages/google-cloud-spanner/google/cloud/spanner_v1/instance.py

@@ -338,10 +338,18 @@ def list_databases(self, page_size=None, page_token=None):
         https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.database.v1#google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases
 
         :type page_size: int
-        :param page_size: (Optional) Maximum number of results to return.
+        :param page_size:
+            Optional. The maximum number of databases in each page of results
+            from this request. Non-positive values are ignored. Defaults
+            to a sensible value set by the API.
 
         :type page_token: str
-        :param page_token: (Optional) Token for fetching next page of results.
+        :param page_token:
+            Optional. If present, return the next batch of databases, using
+            the value, which must correspond to the ``nextPageToken`` value
+            returned in the previous response.  Deprecated: use the ``pages``
+            property of the returned iterator instead of manually passing
+            the token.
 
         :rtype: :class:`~google.api._ore.page_iterator.Iterator`
         :returns: