Fix many errors reported by -Xdoclint
Merge pull request #430 from sharwell/doclint

Fix many errors reported by -Xdoclint