Some misc doco additions and clean up
Some more minor doco changes
Merge pull request #314 from orien/master

Update some Yardoc documentation