docs: remove nextQuery docs & annotate arrays correctly (#1559)

packages/bigquery/src/dataset.js

@@ -272,8 +272,6 @@ Dataset.prototype.delete = function(options, callback) {
  * @param {?error} callback.err - An error returned while making this request
  * @param {module:bigquery/table[]} callback.tables - The list of tables from
  *     your Dataset.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example

packages/bigquery/src/index.js

@@ -152,8 +152,6 @@ BigQuery.prototype.dataset = function(id) {
  * @param {?error} callback.err - An error returned while making this request
  * @param {module:bigquery/dataset[]} callback.datasets - The list of datasets
  *     in your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -259,8 +257,6 @@ BigQuery.prototype.getDatasets = function(query, callback) {
  * @param {?error} callback.err - An error returned while making this request
  * @param {module:bigquery/job[]} callback.jobs - The list of jobs in your
  *     project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -359,16 +355,7 @@ BigQuery.prototype.job = function(id) {
 /**
  * Run a query scoped to your project.
  *
- * If you provide a callback, this method returns the results from your query to
- * it. When querying large sets of data, it is possible your results won't be
- * returned all at once. In those cases, you will receive a third argument to
- * your callback that can be passed back to this method to return more results.
- *
- * See the examples below for such a workflow.
- *
  * This method also runs as a readable stream if you do not provide a callback.
- * In cases where more results exist, this will automatically run the subsequent
- * queries for you, pushing each row to the stream.
  *
  * @resource [Jobs: query API Documentation]{@link https://cloud.google.com/bigquery/docs/reference/v2/jobs/query}
  *
@@ -388,8 +375,6 @@ BigQuery.prototype.job = function(id) {
  * @param {function=} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request
  * @param {array} callback.rows - The list of results from your query.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example

packages/bigquery/src/table.js

@@ -577,8 +577,6 @@ Table.prototype.export = function(destination, options, callback) {
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request
  * @param {array} callback.rows - The table data from specified set of rows.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example

packages/bigtable/src/index.js

@@ -435,8 +435,6 @@ Bigtable.prototype.createInstance = function(name, options, callback) {
  * @param {?error} callback.error - An error returned while making this request.
  * @param {module:bigtable/instance[]} callback.instances - List of all
  *     instances.
- * @param {object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example

packages/bigtable/src/instance.js

@@ -451,8 +451,6 @@ Instance.prototype.cluster = function(name) {
  * @param {?error} callback.error - An error returned while making this request.
  * @param {module:bigtable/cluster[]} callback.clusters - List of all
  *     Clusters.
- * @param {object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -554,8 +552,6 @@ Instance.prototype.getClusters = function(query, callback) {
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
  * @param {module:bigtable/table[]} callback.tables - List of all Tables.
- * @param {object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example

packages/compute/src/index.js

@@ -579,10 +579,8 @@ Compute.prototype.firewall = function(name) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/address} callback.addresses - Address objects from
+ * @param {module:compute/address[]} callback.addresses - Address objects from
  *     your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -698,8 +696,6 @@ Compute.prototype.getAddresses = function(options, callback) {
  * @param {?error} callback.err - An error returned while making this request.
  * @param {module:compute/autoscaler[]} callback.autoscalers - Autoscaler
  *     objects from your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -815,9 +811,8 @@ Compute.prototype.getAutoscalers = function(options, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/disk} callback.disks - Disk objects from your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
+ * @param {module:compute/disk[]} callback.disks - Disk objects from your
+ *     project.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -932,8 +927,6 @@ Compute.prototype.getDisks = function(options, callback) {
  * @param {?error} callback.err - An error returned while making this request.
  * @param {module:compute/instance-group[]} callback.instanceGroups -
  *     InstanceGroup objects from your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -1045,10 +1038,8 @@ Compute.prototype.getInstanceGroups = function(options, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/firewall} callback.firewalls - Firewall objects from
+ * @param {module:compute/firewall[]} callback.firewalls - Firewall objects from
  *     your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -1154,10 +1145,8 @@ Compute.prototype.getFirewalls = function(options, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/health-check} callback.healthChecks - HealthCheck
+ * @param {module:compute/health-check[]} callback.healthChecks - HealthCheck
  *     objects from your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -1269,8 +1258,6 @@ Compute.prototype.getHealthChecks = function(options, callback) {
  * @param {?error} callback.err - An error returned while making this request.
  * @param {module:compute/machine-type[]} callback.machineTypes - MachineType
  *     objects from your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -1382,10 +1369,8 @@ Compute.prototype.getMachineTypes = function(options, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/network} callback.networks - Network objects from your
- *     project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
+ * @param {module:compute/network[]} callback.networks - Network objects from
+ *     your project.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -1488,10 +1473,8 @@ Compute.prototype.getNetworks = function(options, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/operation} callback.operations - Operation objects
+ * @param {module:compute/operation[]} callback.operations - Operation objects
  *     from your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -1594,10 +1577,8 @@ Compute.prototype.getOperations = function(options, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/region} callback.regions - Region objects that are
+ * @param {module:compute/region[]} callback.regions - Region objects that are
  *     available to your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -1697,9 +1678,8 @@ Compute.prototype.getRegions = function(options, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/rule} callback.rules - Rule objects from this region.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
+ * @param {module:compute/rule[]} callback.rules - Rule objects from your
+ *     project.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -1804,8 +1784,6 @@ Compute.prototype.getRules = function(options, callback) {
  * @param {?error} callback.err - An error returned while making this request.
  * @param {module:compute/service[]} callback.services - Service objects from
  *     your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -1908,10 +1886,8 @@ Compute.prototype.getServices = function(options, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/snapshot} callback.snapshots - Snapshot objects from
+ * @param {module:compute/snapshot[]} callback.snapshots - Snapshot objects from
  *     your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -2014,10 +1990,8 @@ Compute.prototype.getSnapshots = function(options, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/subnetwork} callback.subnetworks - Subnetwork objects
- *     from your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
+ * @param {module:compute/subnetwork[]} callback.subnetworks - Subnetwork
+ *     objects from your project.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -2129,9 +2103,7 @@ Compute.prototype.getSubnetworks = function(options, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/vm} callback.vms - VM objects from your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
+ * @param {module:compute/vm[]} callback.vms - VM objects from your project.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -2243,10 +2215,8 @@ Compute.prototype.getVMs = function(options, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/zone} callback.zones - Zone objects that are available
- *     to your project.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
+ * @param {module:compute/zone[]} callback.zones - Zone objects that are
+ *     available to your project.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example

packages/compute/src/instance-group.js

@@ -258,8 +258,6 @@ InstanceGroup.prototype.delete = function(callback) {
  * @param {?error} callback.err - An error returned while making this request.
  * @param {module:compute/vm[]} callback.vms - VM objects from this isntance
  *     group.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example

packages/compute/src/network.js

@@ -275,10 +275,8 @@ Network.prototype.createSubnetwork = function(name, config, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/subnetwork} callback.subnetworks - Subnetwork objects
- *     from this network.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
+ * @param {module:compute/subnetwork[]} callback.subnetworks - Subnetwork
+ *     objects from this network.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -405,10 +403,8 @@ Network.prototype.firewall = function(name) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/firewall} callback.firewalls - Firewall objects from
+ * @param {module:compute/firewall[]} callback.firewalls - Firewall objects from
  *     this network.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example

packages/compute/src/region.js

@@ -356,10 +356,8 @@ Region.prototype.createRule = function(name, config, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/address} callback.addresses - Address objects from
+ * @param {module:compute/address[]} callback.addresses - Address objects from
  *     this region.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -462,10 +460,8 @@ Region.prototype.getAddresses = function(options, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/operation} callback.operations - Operation objects
+ * @param {module:compute/operation[]} callback.operations - Operation objects
  *     from this region.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -567,9 +563,8 @@ Region.prototype.getOperations = function(options, callback) {
  *     representing part of the larger set of results to view.
  * @param {function} callback - The callback function.
  * @param {?error} callback.err - An error returned while making this request.
- * @param {module:compute/rule} callback.rules - Rule objects from this region.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
+ * @param {module:compute/rule[]} callback.rules - Rule objects from this
+ *     region.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example
@@ -674,8 +669,6 @@ Region.prototype.getRules = function(options, callback) {
  * @param {?error} callback.err - An error returned while making this request.
  * @param {module:compute/subnetwork[]} callback.subnetworks - Subnetwork
  *     objects from this region.
- * @param {?object} callback.nextQuery - If present, query with this object to
- *     check for more results.
  * @param {object} callback.apiResponse - The full API response.
  *
  * @example