Minor documentation fixes.

Fixed double-dash literals. Fixed broken :doc: links. Minor case fixes. Minor wording fixes.