docs(query+aggregate): add more detail re: maxTimeMS

Fix #4066

lib/aggregate.js

@@ -554,7 +554,10 @@ Aggregate.prototype.allowDiskUse = function(value) {
  *     var agg = Model.aggregate(..).option({ allowDiskUse: true }); // Set the `allowDiskUse` option
  *     agg.options; // `{ allowDiskUse: true }`
  *
- * @param {Object} value keys to merge into current options
+ * @param {Object} options keys to merge into current options
+ * @param [options.maxTimeMS] number limits the time this aggregation will run, see [MongoDB docs on `maxTimeMS`](https://docs.mongodb.com/manual/reference/operator/meta/maxTimeMS/)
+ * @param [options.allowDiskUse] boolean if true, the MongoDB server will use the hard drive to store data during this aggregation
+ * @param [options.collation] object see [`Aggregate.prototype.collation()`](./docs/api.html#aggregate_Aggregate-collation)
  * @see mongodb http://docs.mongodb.org/manual/reference/command/aggregate/
  * @return {Aggregate} this
  * @api public
@@ -621,7 +624,6 @@ Aggregate.prototype.addCursorFlag = function(flag, value) {
  *     Model.aggregate(..).collation({ locale: 'en_US', strength: 1 }).exec();
  *
  * @param {Object} collation options
- * @param {Boolean} value
  * @see mongodb http://mongodb.github.io/node-mongodb-native/2.2/api/Collection.html#aggregate
  */
 

lib/query.js

@@ -1009,6 +1009,9 @@ Query.prototype.read = function read(pref, tags) {
  * The following options are only for `find()`, `findOne()`, `findById()`, and `findOneAndUpdate()`:
  * - [lean](./api.html#query_Query-lean)
  *
+ * The following options are only for all operations **except** `update()`, `updateOne()`, `updateMany()`, `remove()`, `deleteOne()`, and `deleteMany()`:
+ * - [maxTimeMS](https://docs.mongodb.com/manual/reference/operator/meta/maxTimeMS/)
+ *
  * The following options are for all operations:
  * - [collation](https://docs.mongodb.com/manual/reference/collation/)
  *