Cross referencing in Ddoc

Walter Bright newshound2 at digitalmars.com
Mon Dec 30 14:13:32 PST 2013


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.



More information about the Digitalmars-d mailing list