minor docs and help text improvements

[josharian]

I'm happy to leave off the last commit if you prefer. I really only meant to send the first commit, but kept noticing stuff. :)

[myitcv]

cc @rogpeppe