[COUCHDB-1850] Documentation missing view emit _id/_rev tricks for ?include_docs=true details

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 1.5.0
• Component/s: Documentation
• Assignee: Alexander Shorin
• Reporter: Nathan Vander Wilt
• Created: 09/Jul/13 19:16
• Updated: 28/Sep/13 13:46
• Resolved: 28/Sep/13 13:46

Description

Both the wiki and the official documentation are missing the indirect "join" fetch possible via include_docs when the view emits another doc's _id e.g. http://stackoverflow.com/a/6059447/179583, http://stackoverflow.com/a/3035522/179583, http://stackoverflow.com/a/2683228/179583 — apparently this was only in the release notes and/or on the Couchbase blog at one time.

Also the official documentation is missing a complete explanation of this note in the wiki:

"If you want to alleviate [stale view vs database inconsistency] concerns you should emit an object with a _rev attribute as in emit(key,

{"_rev": doc._rev}

)." — http://wiki.apache.org/couchdb/HTTP_view_API#Querying_Options

Will this cause the old rev to be fetched? What if it's no longer available?