clean up docs for new parser functions
Merge pull request #1695 from djmitche/future-parser-docs-fixes

clean up docs for new parser functions