test: improve docs for when to use --HEAD etc in `brew test`

After muddling through https://github.com/Homebrew/homebrew/issues/29785 here's improved docs that would have avoided wasting the brewery's time.