clean up docs for new parser functions
Merge pull request #1696 from Sharpie/21028-document-future-parser-functions

clean up docs for new parser functions (backport)