Regen all docs. (#700)

* Stop recursing if discovery == {}

* Generate docs with 'make docs'.
diff --git a/docs/dyn/pubsub_v1beta1a.subscriptions.html b/docs/dyn/pubsub_v1beta1a.subscriptions.html
index 55b979a..d804168 100644
--- a/docs/dyn/pubsub_v1beta1a.subscriptions.html
+++ b/docs/dyn/pubsub_v1beta1a.subscriptions.html
@@ -72,7 +72,7 @@
 
 </style>
 
-<h1><a href="pubsub_v1beta1a.html">Google Cloud Pub/Sub API</a> . <a href="pubsub_v1beta1a.subscriptions.html">subscriptions</a></h1>
+<h1><a href="pubsub_v1beta1a.html">Cloud Pub/Sub API</a> . <a href="pubsub_v1beta1a.subscriptions.html">subscriptions</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#acknowledge">acknowledge(body, x__xgafv=None)</a></code></p>
@@ -164,33 +164,33 @@
     The object takes the form of:
 
 { # A subscription resource.
-  "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a
-      # subscriber receives a message before the subscriber should acknowledge or
-      # Nack the message. If the Ack deadline for a message passes without an
-      # Ack or a Nack, the Pub/Sub system will eventually redeliver the message.
-      # If a subscriber acknowledges after the deadline, the Pub/Sub system may
-      # accept the Ack, but it is possible that the message has been already
-      # delivered again. Multiple Acks to the message are allowed and will
-      # succeed.
-      # 
-      # For push delivery, this value is used to set the request timeout for
-      # the call to the push endpoint.
-      # 
-      # For pull delivery, this value is used as the initial value for the Ack
-      # deadline. It may be overridden for each message using its corresponding
-      # ack_id with <code>ModifyAckDeadline</code>.
-      # While a message is outstanding (i.e. it has been delivered to a pull
-      # subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub
-      # system will not deliver that message to another pull subscriber
-      # (on a best-effort basis).
-  "topic": "A String", # The name of the topic from which this subscription is receiving messages.
-  "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
-      # used to configure it.
-    "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", # Name of the subscription.
-}
+    "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+    "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a
+        # subscriber receives a message before the subscriber should acknowledge or
+        # Nack the message. If the Ack deadline for a message passes without an
+        # Ack or a Nack, the Pub/Sub system will eventually redeliver the message.
+        # If a subscriber acknowledges after the deadline, the Pub/Sub system may
+        # accept the Ack, but it is possible that the message has been already
+        # delivered again. Multiple Acks to the message are allowed and will
+        # succeed.
+        # 
+        # For push delivery, this value is used to set the request timeout for
+        # the call to the push endpoint.
+        # 
+        # For pull delivery, this value is used as the initial value for the Ack
+        # deadline. It may be overridden for each message using its corresponding
+        # ack_id with <code>ModifyAckDeadline</code>.
+        # While a message is outstanding (i.e. it has been delivered to a pull
+        # subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub
+        # system will not deliver that message to another pull subscriber
+        # (on a best-effort basis).
+    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+        # used to configure it.
+      "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", # Name of the subscription.
+  }
 
   x__xgafv: string, V1 error format.
     Allowed values
@@ -201,33 +201,33 @@
   An object of the form:
 
     { # A subscription resource.
-    "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a
-        # subscriber receives a message before the subscriber should acknowledge or
-        # Nack the message. If the Ack deadline for a message passes without an
-        # Ack or a Nack, the Pub/Sub system will eventually redeliver the message.
-        # If a subscriber acknowledges after the deadline, the Pub/Sub system may
-        # accept the Ack, but it is possible that the message has been already
-        # delivered again. Multiple Acks to the message are allowed and will
-        # succeed.
-        #
-        # For push delivery, this value is used to set the request timeout for
-        # the call to the push endpoint.
-        #
-        # For pull delivery, this value is used as the initial value for the Ack
-        # deadline. It may be overridden for each message using its corresponding
-        # ack_id with <code>ModifyAckDeadline</code>.
-        # While a message is outstanding (i.e. it has been delivered to a pull
-        # subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub
-        # system will not deliver that message to another pull subscriber
-        # (on a best-effort basis).
-    "topic": "A String", # The name of the topic from which this subscription is receiving messages.
-    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
-        # used to configure it.
-      "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", # Name of the subscription.
-  }</pre>
+      "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+      "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a
+          # subscriber receives a message before the subscriber should acknowledge or
+          # Nack the message. If the Ack deadline for a message passes without an
+          # Ack or a Nack, the Pub/Sub system will eventually redeliver the message.
+          # If a subscriber acknowledges after the deadline, the Pub/Sub system may
+          # accept the Ack, but it is possible that the message has been already
+          # delivered again. Multiple Acks to the message are allowed and will
+          # succeed.
+          #
+          # For push delivery, this value is used to set the request timeout for
+          # the call to the push endpoint.
+          #
+          # For pull delivery, this value is used as the initial value for the Ack
+          # deadline. It may be overridden for each message using its corresponding
+          # ack_id with <code>ModifyAckDeadline</code>.
+          # While a message is outstanding (i.e. it has been delivered to a pull
+          # subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub
+          # system will not deliver that message to another pull subscriber
+          # (on a best-effort basis).
+      "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+          # used to configure it.
+        "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", # Name of the subscription.
+    }</pre>
 </div>
 
 <div class="method">
@@ -278,33 +278,33 @@
   An object of the form:
 
     { # A subscription resource.
-    "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a
-        # subscriber receives a message before the subscriber should acknowledge or
-        # Nack the message. If the Ack deadline for a message passes without an
-        # Ack or a Nack, the Pub/Sub system will eventually redeliver the message.
-        # If a subscriber acknowledges after the deadline, the Pub/Sub system may
-        # accept the Ack, but it is possible that the message has been already
-        # delivered again. Multiple Acks to the message are allowed and will
-        # succeed.
-        #
-        # For push delivery, this value is used to set the request timeout for
-        # the call to the push endpoint.
-        #
-        # For pull delivery, this value is used as the initial value for the Ack
-        # deadline. It may be overridden for each message using its corresponding
-        # ack_id with <code>ModifyAckDeadline</code>.
-        # While a message is outstanding (i.e. it has been delivered to a pull
-        # subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub
-        # system will not deliver that message to another pull subscriber
-        # (on a best-effort basis).
-    "topic": "A String", # The name of the topic from which this subscription is receiving messages.
-    "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
-        # used to configure it.
-      "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", # Name of the subscription.
-  }</pre>
+      "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+      "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a
+          # subscriber receives a message before the subscriber should acknowledge or
+          # Nack the message. If the Ack deadline for a message passes without an
+          # Ack or a Nack, the Pub/Sub system will eventually redeliver the message.
+          # If a subscriber acknowledges after the deadline, the Pub/Sub system may
+          # accept the Ack, but it is possible that the message has been already
+          # delivered again. Multiple Acks to the message are allowed and will
+          # succeed.
+          #
+          # For push delivery, this value is used to set the request timeout for
+          # the call to the push endpoint.
+          #
+          # For pull delivery, this value is used as the initial value for the Ack
+          # deadline. It may be overridden for each message using its corresponding
+          # ack_id with <code>ModifyAckDeadline</code>.
+          # While a message is outstanding (i.e. it has been delivered to a pull
+          # subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub
+          # system will not deliver that message to another pull subscriber
+          # (on a best-effort basis).
+      "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+          # used to configure it.
+        "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", # Name of the subscription.
+    }</pre>
 </div>
 
 <div class="method">
@@ -330,33 +330,33 @@
         # <code>ListSubscriptionsRequest</code> to continue.
     "subscription": [ # The subscriptions that match the request.
       { # A subscription resource.
-        "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a
-            # subscriber receives a message before the subscriber should acknowledge or
-            # Nack the message. If the Ack deadline for a message passes without an
-            # Ack or a Nack, the Pub/Sub system will eventually redeliver the message.
-            # If a subscriber acknowledges after the deadline, the Pub/Sub system may
-            # accept the Ack, but it is possible that the message has been already
-            # delivered again. Multiple Acks to the message are allowed and will
-            # succeed.
-            #
-            # For push delivery, this value is used to set the request timeout for
-            # the call to the push endpoint.
-            #
-            # For pull delivery, this value is used as the initial value for the Ack
-            # deadline. It may be overridden for each message using its corresponding
-            # ack_id with <code>ModifyAckDeadline</code>.
-            # While a message is outstanding (i.e. it has been delivered to a pull
-            # subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub
-            # system will not deliver that message to another pull subscriber
-            # (on a best-effort basis).
-        "topic": "A String", # The name of the topic from which this subscription is receiving messages.
-        "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
-            # used to configure it.
-          "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".
+          "topic": "A String", # The name of the topic from which this subscription is receiving messages.
+          "ackDeadlineSeconds": 42, # For either push or pull delivery, the value is the maximum time after a
+              # subscriber receives a message before the subscriber should acknowledge or
+              # Nack the message. If the Ack deadline for a message passes without an
+              # Ack or a Nack, the Pub/Sub system will eventually redeliver the message.
+              # If a subscriber acknowledges after the deadline, the Pub/Sub system may
+              # accept the Ack, but it is possible that the message has been already
+              # delivered again. Multiple Acks to the message are allowed and will
+              # succeed.
+              #
+              # For push delivery, this value is used to set the request timeout for
+              # the call to the push endpoint.
+              #
+              # For pull delivery, this value is used as the initial value for the Ack
+              # deadline. It may be overridden for each message using its corresponding
+              # ack_id with <code>ModifyAckDeadline</code>.
+              # While a message is outstanding (i.e. it has been delivered to a pull
+              # subscriber and the subscriber has not yet Acked or Nacked), the Pub/Sub
+              # system will not deliver that message to another pull subscriber
+              # (on a best-effort basis).
+          "pushConfig": { # Configuration for a push delivery endpoint. # If push delivery is used with this subscription, this field is
+              # used to configure it.
+            "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", # Name of the subscription.
         },
-        "name": "A String", # Name of the subscription.
-      },
     ],
   }</pre>
 </div>
@@ -389,12 +389,12 @@
         # deadline will expire 10 seconds after the ModifyAckDeadline call was made.
         # Specifying zero may immediately make the message available for another pull
         # request.
+    "ackId": "A String", # The acknowledgment ID. Either this or ack_ids must be populated,
+        # not both.
     "ackIds": [ # List of acknowledgment IDs. Either this field or ack_id
         # should be populated, not both.
       "A String",
     ],
-    "ackId": "A String", # The acknowledgment ID. Either this or ack_ids must be populated,
-        # not both.
     "subscription": "A String", # Next Index: 5
         # The name of the subscription from which messages are being pulled.
   }
@@ -539,8 +539,8 @@
             # that receives a PubsubMessage via a Pull call or a push delivery. It must
             # not be populated by a publisher in a Publish call.
       },
-      "subscription": "A String", # The subscription that received the event.
       "truncated": True or False, # Indicates that this subscription has been truncated.
+      "subscription": "A String", # The subscription that received the event.
     },
     "ackId": "A String", # This ID must be used to acknowledge the received event or message.
   }</pre>
@@ -620,8 +620,8 @@
                 # that receives a PubsubMessage via a Pull call or a push delivery. It must
                 # not be populated by a publisher in a Publish call.
           },
-          "subscription": "A String", # The subscription that received the event.
           "truncated": True or False, # Indicates that this subscription has been truncated.
+          "subscription": "A String", # The subscription that received the event.
         },
         "ackId": "A String", # This ID must be used to acknowledge the received event or message.
       },