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

clean up docs for new parser functions
Merge branch 'master' of https://github.com/puppetlabs/puppet