[Code Style] DocBlock and comment fixes and improvements.
Merge pull request #3012 from chrisdavenport/code-style-14

[Code Style] DocBlock and comment fixes and improvements. Thanks @chrisdavenport!