Clarify the documentation on `cargo test`

Closes #812
auto merge of #816 : alexcrichton/cargo/issue-812, r=brson

Closes #812