docs

lib/model.js

@@ -839,6 +839,7 @@ Model.remove = function remove (conditions, callback) {
  * @param {Object} [options] optional
  * @param {Function} [callback]
  * @return {Query}
+ * @see field selection #query_Query-select
  * @api public
  */
 
@@ -905,6 +906,7 @@ Model._applyNamedScope = function _applyNamedScope (query) {
  * @param {Object} [options] optional
  * @param {Function} [callback]
  * @return {Query}
+ * @see field selection #query_Query-select
  * @api public
  */
 
@@ -926,6 +928,7 @@ Model.findById = function findById (id, fields, options, callback) {
  * @param {Object} [options] optional
  * @param {Function} [callback]
  * @return {Query}
+ * @see field selection #query_Query-select
  * @api public
  */
 

lib/query.js

@@ -2071,13 +2071,13 @@ Query.prototype._findAndModify = function (type, callback) {
 }
 
 /**
- * Specifies paths which should be populated.
+ * Specifies paths which should be populated with other documents.
  *
  * Paths are populated after the query executes and a response is received. A separate query is then executed for each path specified for population. After a response for each query has also been returned, the results are passed to the callback.
  *
- * ####Example
+ * ####Example:
  *
- *     Kitten.find().populate('owner').exec(function (err, kitten) {
+ *     Kitten.findOne().populate('owner').exec(function (err, kitten) {
  *       console.log(kitten.owner.name) // Max
  *     })
  *