add doc for #1000, mention :all for tests
Merge pull request #1001 from cldwalker/test-doc-tweak

add doc for #1000, mention :all for tests