Fix up documentation on comment reference parser to align with wiki#2851

jcollins-g merged 1 commit intodart-lang:masterdart-lang/dartdoc:masterfrom

jcollins-g:update-parser-docjcollins-g/dartdoc:update-parser-docCopy head branch name to clipboard