Fix spelling and markup in documentation and code comment

* Mark up ``--help`` to avoid generating an en dash
* Use forward slash in Unix command line with a dollar sign ($) prompt
2 files changed