docs: properly document autoPaginate (#1720)

Author: stephenplusplus

packages/bigquery/src/dataset.js

@@ -360,11 +360,26 @@ Dataset.prototype.delete = function(options, callback) {
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
- * dataset.getTables(function(err, tables, nextQuery, apiResponse) {
- *   // If `nextQuery` is non-null, there are more results to fetch.
+ * dataset.getTables(function(err, tables) {
+ *   // tables is an array of `Table` objects.
  * });
  *
  * //-
+ * // To control how many API requests are made and page through the results
+ * // manually, set `autoPaginate` to `false`.
+ * //-
+ * function callback(err, tables, nextQuery, apiResponse) {
+ *   if (nextQuery) {
+ *     // More results exist.
+ *     dataset.getTables(nextQuery, callback);
+ *   }
+ * }
+ *
+ * dataset.getTables({
+ *   autoPaginate: false
+ * }, callback);
+ *
+ * //-
  * // If the callback is omitted, we'll return a Promise.
  * //-
  * dataset.getTables().then(function(data) {

packages/pubsub/src/topic.js

@@ -278,20 +278,31 @@ Topic.formatName_ = function(projectId, name) {
  * @param {function} callback - The callback function.
  *
  * @example
- * var callback = function(err, subscriptions, nextQuery, apiResponse) {
- *   // If `nextQuery` is non-null, there may be more results to fetch. To do
- *   // so, run `topic.getSubscriptions(nextQuery, callback);`.
- * };
- *
- * // Get all subscriptions for this topic.
- * topic.getSubscriptions(callback);
+ * topic.getSubscriptions(function(err, subscriptions) {
+ *   // subscriptions is an array of `Subscription` objects.
+ * });
  *
  * // Customize the query.
  * topic.getSubscriptions({
  *   pageSize: 3
  * }, callback);
  *
  * //-
+ * // To control how many API requests are made and page through the results
+ * // manually, set `autoPaginate` to `false`.
+ * //-
+ * function callback(err, subscriptions, nextQuery, apiResponse) {
+ *   if (nextQuery) {
+ *     // More results exist.
+ *     topic.getSubscriptions(nextQuery, callback);
+ *   }
+ * }
+ *
+ * topic.getSubscriptions({
+ *   autoPaginate: false
+ * }, callback);
+ *
+ * //-
  * // If the callback is omitted, we'll return a Promise.
  * //-
  * topic.getSubscriptions().then(function(data) {