document some things missed before
Merge pull request #1803 from akre54/doc-fixes

document some things missed before