documentation fixes for new code
Merge pull request #1 from Tryptophan/documentation

documentation fixes for new code