add autogenerated comments
tests - add autogenerated comment blocks
tools - add missing comment blocks
Merge pull request #3354 from eileenmcnaughton/comments-extra

Add autogenerated comments to tools & tests