Would it make sense to use these sgml synopsis as some kind of source of truth, parse them, and automatically generate a parser for a specifc language ?
What problem are you trying to solve here? to whit not everything that can be parsed is documented - usually intentionally.
Could the parser commiters share some lights on how the documentation process interacts with the parser commits ?
Commits that modify the parser are expected to have manual modifications to the relevant documentation as well.
David J.