(#1848) - housekeeping on query() docs

Adds more notes to the db.query()
documentation, especially when we
forgot to mention certain
parameters. Also adds documentation for
options.stale and options.group_level.

The only new code this will require in
order to be accurate is pouchdb/mapreduce#85.