add doc for #1000, mention :all for tests

Forgot to document changes I made in #1000