doc: update many bash examples that used old-style flags.

some of these had become lies;
some of these still work, but now seem strange

Reviewed at https://rbcommons.com/s/twitter/r/1377/
Sync of https://github.com/pantsbuild/pants/commit/f65be3b781c9b0173a381b33183a4cd3f6c0214b