Escape less-than signs in xml comments
Fix malformed xml comments
Fix spelling of references in xml comments
Clean up some xml comments
Merge pull request #1542 from xt0rted/xml-comments

Cleaning up some of the xml comments