On 12/30/2013 1:25 PM, Sönke Ludwig wrote:
Identifiers in documentation comments that are function parameters or
are names that are in scope at the associated declaration are emphasized
in the output.
So the same problem is already reality - you already have to go through
the documentation to see if there are any mis-highlighted words.
1. having a bad idea is not justification for doing it again :-)
2. the requirement that the name be "in scope" does a pretty good job of
reducing the problem. But cross references, are by definition CROSS references,
i.e. they cross scopes. The whole point of them is they cross scopes, which
means this becomes a much bigger issue.
