Add to jsdocs about withOptions(), categories

Author: wooldridge

lib/documents.js

@@ -169,7 +169,7 @@ function wipeOutputTransform(/*headers, data*/) {
 /**
  * Categories of information to read or write for documents.
  * The possible values of the enumeration are
- * content|collections|permissions|properties|quality|metadataValues|metadata where
+ * content|collections|metadataValues|permissions|properties|quality|metadata|none where
  * metadata is an alias for all of the categories other than content.
  * @typedef {enum} documents.categories
  */

lib/query-builder.js

@@ -4986,14 +4986,16 @@ function snippet() {
  * This function may be called on the result of building a query. When the
  * 'debug', 'metrics', 'queryPlan', or 'similarDocs' parameter is set, a
  * search summary object will be returned along with the result documents.
+ * When 'categories' is set to 'none', only a search summary is returned.
  * @method
  * @memberof queryBuilder#
  * @param {documents.categories}  [categories] - the categories of information
  * to retrieve for the result documents
  * @param {number} [concurrencyLevel] - the maximum number of threads to use to calculate facets
  * @param {...string} [forestNames] - the names of forests providing documents
  * for the result set
- * @param {...string} [search] - options modifying the default behaviour of the query
+ * @param {...string} [search] - <a href="https://docs.marklogic.com/guide/search-dev/appendixa#id_77801">options</a>
+ * modifying the default behaviour of the query
  * @param {string|transactions.Transaction}  [txid] - a string
  * transaction id or Transaction object identifying an open
  * multi-statement transaction