Minor documentation fixes.

Fixed double-dash literals. Fixed broken :doc: links. Minor case fixes. Minor wording fixes.
Merge pull request #5717 from nanobeep/devel

Minor documentation fixes.