docs; query options
Fixes gh-1606, dealing with ref docs on creation

Passing values at creation time and setting afterward now consistent
with each other. fixes #1606
added tests for gh-1606
refactor
update History
release 3.6.17