Tiny tweak to legacy option printing.

Also rewrote some comments for clarity.

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