Improve documentation on comparison operators.
More improvements to opCmp docs.

Also, improve wordings to other parts of opEquals / opCmp docs, and add
missing $(D...) macros for D symbols in various places.
Merge pull request #620 from quickfur/opCmp

Improve documentation on comparison operators.