Regen docs (#373)

diff --git a/docs/dyn/pubsub_v1beta2.projects.subscriptions.html b/docs/dyn/pubsub_v1beta2.projects.subscriptions.html
index 5d1a152..1f00d47 100644
--- a/docs/dyn/pubsub_v1beta2.projects.subscriptions.html
+++ b/docs/dyn/pubsub_v1beta2.projects.subscriptions.html
@@ -174,23 +174,91 @@
     The object takes the form of:
 
 { # A subscription resource.
+  "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
+      # before the subscriber should acknowledge the message. After message
+      # delivery but before the ack deadline expires and before the message is
+      # acknowledged, it is an outstanding message and will not be delivered
+      # again during that time (on a best-effort basis).
+      # 
+      # For pull subscriptions, this value is used as the initial value for the ack
+      # deadline. To override this value for a given message, call
+      # `ModifyAckDeadline` with the corresponding `ack_id` if using pull.
+      # The maximum custom deadline you can specify is 600 seconds (10 minutes).
+      # 
+      # For push delivery, this value is also used to set the request timeout for
+      # the call to the push endpoint.
+      # 
+      # If the subscriber never acknowledges the message, the Pub/Sub
+      # system will eventually redeliver the message.
+      # 
+      # If this parameter is 0, a default value of 10 seconds is used.
+  "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+      # The value of this field will be `_deleted-topic_` if the topic has been
+      # deleted.
+  "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+      # used to configure it. An empty `pushConfig` signifies that the subscriber
+      # will pull and ack messages using API methods.
+    "attributes": { # Endpoint configuration attributes.
+        #
+        # Every endpoint has a set of API supported attributes that can be used to
+        # control different aspects of the message delivery.
+        #
+        # The currently supported attribute is `x-goog-version`, which you can
+        # use to change the format of the push message. This attribute
+        # indicates the version of the data expected by the endpoint. This
+        # controls the shape of the envelope (i.e. its fields and metadata).
+        # The endpoint version is based on the version of the Pub/Sub
+        # API.
+        #
+        # If not present during the `CreateSubscription` call, it will default to
+        # the version of the API used to make such call. If not present during a
+        # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
+        # calls will always return a valid version, even if the subscription was
+        # created without this attribute.
+        #
+        # The possible values for this attribute are:
+        #
+        # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
+        # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+      "a_key": "A String",
+    },
+    "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+        # For example, a Webhook endpoint might use "https://example.com/push".
+  },
+  "name": "A String", # The name of the subscription. It must have the format
+      # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+      # start with a letter, and contain only letters (`[A-Za-z]`), numbers
+      # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+      # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+      # in length, and it must not start with `"goog"`.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A subscription resource.
     "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
         # before the subscriber should acknowledge the message. After message
         # delivery but before the ack deadline expires and before the message is
         # acknowledged, it is an outstanding message and will not be delivered
         # again during that time (on a best-effort basis).
-        # 
+        #
         # For pull subscriptions, this value is used as the initial value for the ack
         # deadline. To override this value for a given message, call
         # `ModifyAckDeadline` with the corresponding `ack_id` if using pull.
         # The maximum custom deadline you can specify is 600 seconds (10 minutes).
-        # 
+        #
         # For push delivery, this value is also used to set the request timeout for
         # the call to the push endpoint.
-        # 
+        #
         # If the subscriber never acknowledges the message, the Pub/Sub
         # system will eventually redeliver the message.
-        # 
+        #
         # If this parameter is 0, a default value of 10 seconds is used.
     "topic": "A String", # The name of the topic from which this subscription is receiving messages.
         # The value of this field will be `_deleted-topic_` if the topic has been
@@ -231,75 +299,7 @@
         # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
         # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
         # in length, and it must not start with `"goog"`.
-  }
-
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-
-Returns:
-  An object of the form:
-
-    { # A subscription resource.
-      "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
-          # before the subscriber should acknowledge the message. After message
-          # delivery but before the ack deadline expires and before the message is
-          # acknowledged, it is an outstanding message and will not be delivered
-          # again during that time (on a best-effort basis).
-          #
-          # For pull subscriptions, this value is used as the initial value for the ack
-          # deadline. To override this value for a given message, call
-          # `ModifyAckDeadline` with the corresponding `ack_id` if using pull.
-          # The maximum custom deadline you can specify is 600 seconds (10 minutes).
-          #
-          # For push delivery, this value is also used to set the request timeout for
-          # the call to the push endpoint.
-          #
-          # If the subscriber never acknowledges the message, the Pub/Sub
-          # system will eventually redeliver the message.
-          #
-          # If this parameter is 0, a default value of 10 seconds is used.
-      "topic": "A String", # The name of the topic from which this subscription is receiving messages.
-          # The value of this field will be `_deleted-topic_` if the topic has been
-          # deleted.
-      "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
-          # used to configure it. An empty `pushConfig` signifies that the subscriber
-          # will pull and ack messages using API methods.
-        "attributes": { # Endpoint configuration attributes.
-            #
-            # Every endpoint has a set of API supported attributes that can be used to
-            # control different aspects of the message delivery.
-            #
-            # The currently supported attribute is `x-goog-version`, which you can
-            # use to change the format of the push message. This attribute
-            # indicates the version of the data expected by the endpoint. This
-            # controls the shape of the envelope (i.e. its fields and metadata).
-            # The endpoint version is based on the version of the Pub/Sub
-            # API.
-            #
-            # If not present during the `CreateSubscription` call, it will default to
-            # the version of the API used to make such call. If not present during a
-            # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
-            # calls will always return a valid version, even if the subscription was
-            # created without this attribute.
-            #
-            # The possible values for this attribute are:
-            #
-            # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
-            # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
-          "a_key": "A String",
-        },
-        "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
-            # For example, a Webhook endpoint might use "https://example.com/push".
-      },
-      "name": "A String", # The name of the subscription. It must have the format
-          # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
-          # start with a letter, and contain only letters (`[A-Za-z]`), numbers
-          # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
-          # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
-          # in length, and it must not start with `"goog"`.
-    }</pre>
+  }</pre>
 </div>
 
 <div class="method">
@@ -347,64 +347,64 @@
   An object of the form:
 
     { # A subscription resource.
-      "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
-          # before the subscriber should acknowledge the message. After message
-          # delivery but before the ack deadline expires and before the message is
-          # acknowledged, it is an outstanding message and will not be delivered
-          # again during that time (on a best-effort basis).
+    "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
+        # before the subscriber should acknowledge the message. After message
+        # delivery but before the ack deadline expires and before the message is
+        # acknowledged, it is an outstanding message and will not be delivered
+        # again during that time (on a best-effort basis).
+        #
+        # For pull subscriptions, this value is used as the initial value for the ack
+        # deadline. To override this value for a given message, call
+        # `ModifyAckDeadline` with the corresponding `ack_id` if using pull.
+        # The maximum custom deadline you can specify is 600 seconds (10 minutes).
+        #
+        # For push delivery, this value is also used to set the request timeout for
+        # the call to the push endpoint.
+        #
+        # If the subscriber never acknowledges the message, the Pub/Sub
+        # system will eventually redeliver the message.
+        #
+        # If this parameter is 0, a default value of 10 seconds is used.
+    "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+        # The value of this field will be `_deleted-topic_` if the topic has been
+        # deleted.
+    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+        # used to configure it. An empty `pushConfig` signifies that the subscriber
+        # will pull and ack messages using API methods.
+      "attributes": { # Endpoint configuration attributes.
           #
-          # For pull subscriptions, this value is used as the initial value for the ack
-          # deadline. To override this value for a given message, call
-          # `ModifyAckDeadline` with the corresponding `ack_id` if using pull.
-          # The maximum custom deadline you can specify is 600 seconds (10 minutes).
+          # Every endpoint has a set of API supported attributes that can be used to
+          # control different aspects of the message delivery.
           #
-          # For push delivery, this value is also used to set the request timeout for
-          # the call to the push endpoint.
+          # The currently supported attribute is `x-goog-version`, which you can
+          # use to change the format of the push message. This attribute
+          # indicates the version of the data expected by the endpoint. This
+          # controls the shape of the envelope (i.e. its fields and metadata).
+          # The endpoint version is based on the version of the Pub/Sub
+          # API.
           #
-          # If the subscriber never acknowledges the message, the Pub/Sub
-          # system will eventually redeliver the message.
+          # If not present during the `CreateSubscription` call, it will default to
+          # the version of the API used to make such call. If not present during a
+          # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
+          # calls will always return a valid version, even if the subscription was
+          # created without this attribute.
           #
-          # If this parameter is 0, a default value of 10 seconds is used.
-      "topic": "A String", # The name of the topic from which this subscription is receiving messages.
-          # The value of this field will be `_deleted-topic_` if the topic has been
-          # deleted.
-      "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
-          # used to configure it. An empty `pushConfig` signifies that the subscriber
-          # will pull and ack messages using API methods.
-        "attributes": { # Endpoint configuration attributes.
-            #
-            # Every endpoint has a set of API supported attributes that can be used to
-            # control different aspects of the message delivery.
-            #
-            # The currently supported attribute is `x-goog-version`, which you can
-            # use to change the format of the push message. This attribute
-            # indicates the version of the data expected by the endpoint. This
-            # controls the shape of the envelope (i.e. its fields and metadata).
-            # The endpoint version is based on the version of the Pub/Sub
-            # API.
-            #
-            # If not present during the `CreateSubscription` call, it will default to
-            # the version of the API used to make such call. If not present during a
-            # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
-            # calls will always return a valid version, even if the subscription was
-            # created without this attribute.
-            #
-            # The possible values for this attribute are:
-            #
-            # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
-            # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
-          "a_key": "A String",
-        },
-        "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
-            # For example, a Webhook endpoint might use "https://example.com/push".
+          # The possible values for this attribute are:
+          #
+          # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
+          # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+        "a_key": "A String",
       },
-      "name": "A String", # The name of the subscription. It must have the format
-          # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
-          # start with a letter, and contain only letters (`[A-Za-z]`), numbers
-          # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
-          # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
-          # in length, and it must not start with `"goog"`.
-    }</pre>
+      "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+          # For example, a Webhook endpoint might use "https://example.com/push".
+    },
+    "name": "A String", # The name of the subscription. It must have the format
+        # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+        # start with a letter, and contain only letters (`[A-Za-z]`), numbers
+        # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+        # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+        # in length, and it must not start with `"goog"`.
+  }</pre>
 </div>
 
 <div class="method">
@@ -415,8 +415,7 @@
 
 Args:
   resource: string, REQUIRED: The resource for which the policy is being requested.
-`resource` is usually specified as a path. For example, a Project
-resource is specified as `projects/{project}`. (required)
+See the operation documentation for the appropriate value for this field. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -527,64 +526,64 @@
         # `ListSubscriptionsRequest` to get more subscriptions.
     "subscriptions": [ # The subscriptions that match the request.
       { # A subscription resource.
-          "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
-              # before the subscriber should acknowledge the message. After message
-              # delivery but before the ack deadline expires and before the message is
-              # acknowledged, it is an outstanding message and will not be delivered
-              # again during that time (on a best-effort basis).
+        "ackDeadlineSeconds": 42, # This value is the maximum time after a subscriber receives a message
+            # before the subscriber should acknowledge the message. After message
+            # delivery but before the ack deadline expires and before the message is
+            # acknowledged, it is an outstanding message and will not be delivered
+            # again during that time (on a best-effort basis).
+            #
+            # For pull subscriptions, this value is used as the initial value for the ack
+            # deadline. To override this value for a given message, call
+            # `ModifyAckDeadline` with the corresponding `ack_id` if using pull.
+            # The maximum custom deadline you can specify is 600 seconds (10 minutes).
+            #
+            # For push delivery, this value is also used to set the request timeout for
+            # the call to the push endpoint.
+            #
+            # If the subscriber never acknowledges the message, the Pub/Sub
+            # system will eventually redeliver the message.
+            #
+            # If this parameter is 0, a default value of 10 seconds is used.
+        "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+            # The value of this field will be `_deleted-topic_` if the topic has been
+            # deleted.
+        "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+            # used to configure it. An empty `pushConfig` signifies that the subscriber
+            # will pull and ack messages using API methods.
+          "attributes": { # Endpoint configuration attributes.
               #
-              # For pull subscriptions, this value is used as the initial value for the ack
-              # deadline. To override this value for a given message, call
-              # `ModifyAckDeadline` with the corresponding `ack_id` if using pull.
-              # The maximum custom deadline you can specify is 600 seconds (10 minutes).
+              # Every endpoint has a set of API supported attributes that can be used to
+              # control different aspects of the message delivery.
               #
-              # For push delivery, this value is also used to set the request timeout for
-              # the call to the push endpoint.
+              # The currently supported attribute is `x-goog-version`, which you can
+              # use to change the format of the push message. This attribute
+              # indicates the version of the data expected by the endpoint. This
+              # controls the shape of the envelope (i.e. its fields and metadata).
+              # The endpoint version is based on the version of the Pub/Sub
+              # API.
               #
-              # If the subscriber never acknowledges the message, the Pub/Sub
-              # system will eventually redeliver the message.
+              # If not present during the `CreateSubscription` call, it will default to
+              # the version of the API used to make such call. If not present during a
+              # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
+              # calls will always return a valid version, even if the subscription was
+              # created without this attribute.
               #
-              # If this parameter is 0, a default value of 10 seconds is used.
-          "topic": "A String", # The name of the topic from which this subscription is receiving messages.
-              # The value of this field will be `_deleted-topic_` if the topic has been
-              # deleted.
-          "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
-              # used to configure it. An empty `pushConfig` signifies that the subscriber
-              # will pull and ack messages using API methods.
-            "attributes": { # Endpoint configuration attributes.
-                #
-                # Every endpoint has a set of API supported attributes that can be used to
-                # control different aspects of the message delivery.
-                #
-                # The currently supported attribute is `x-goog-version`, which you can
-                # use to change the format of the push message. This attribute
-                # indicates the version of the data expected by the endpoint. This
-                # controls the shape of the envelope (i.e. its fields and metadata).
-                # The endpoint version is based on the version of the Pub/Sub
-                # API.
-                #
-                # If not present during the `CreateSubscription` call, it will default to
-                # the version of the API used to make such call. If not present during a
-                # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
-                # calls will always return a valid version, even if the subscription was
-                # created without this attribute.
-                #
-                # The possible values for this attribute are:
-                #
-                # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
-                # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
-              "a_key": "A String",
-            },
-            "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
-                # For example, a Webhook endpoint might use "https://example.com/push".
+              # The possible values for this attribute are:
+              #
+              # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
+              # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+            "a_key": "A String",
           },
-          "name": "A String", # The name of the subscription. It must have the format
-              # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
-              # start with a letter, and contain only letters (`[A-Za-z]`), numbers
-              # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
-              # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
-              # in length, and it must not start with `"goog"`.
+          "pushEndpoint": "A String", # A URL locating the endpoint to which messages should be pushed.
+              # For example, a Webhook endpoint might use "https://example.com/push".
         },
+        "name": "A String", # The name of the subscription. It must have the format
+            # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+            # start with a letter, and contain only letters (`[A-Za-z]`), numbers
+            # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+            # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+            # in length, and it must not start with `"goog"`.
+      },
     ],
   }</pre>
 </div>
@@ -783,8 +782,7 @@
 
 Args:
   resource: string, REQUIRED: The resource for which the policy is being specified.
-`resource` is usually specified as a path. For example, a Project
-resource is specified as `projects/{project}`. (required)
+See the operation documentation for the appropriate value for this field. (required)
   body: object, The request body. (required)
     The object takes the form of:
 
@@ -968,8 +966,7 @@
 
 Args:
   resource: string, REQUIRED: The resource for which the policy detail is being requested.
-`resource` is usually specified as a path. For example, a Project
-resource is specified as `projects/{project}`. (required)
+See the operation documentation for the appropriate value for this field. (required)
   body: object, The request body. (required)
     The object takes the form of: