On Wednesday, 7 January 2015 at 08:46:41 UTC, Vladimir Panteleev
wrote:
* Overzealous linking of words in the documentation that happen
to coincide with symbols in the same module. This should only
be done for text in $(D ...) tags.
According to the specs:
Identifiers in documentation comments that are function
parameters or are names that are in scope at the associated
declaration are emphasized in the output. This emphasis can take
the form of italics, boldface, a hyperlink, etc. How it is
emphasized depends on what it is - a function parameter, type, D
keyword, etc. To prevent unintended emphasis of an identifier, it
can be preceded by an underscore (_). The underscore will be
stripped from the output.
So it's conforming. However, I think this specific part of the
spec cause more problems than it solves. Just think about using
`any`, `all`, `find` and so on in `std.algorithm.
Maybe it's time to update the specs ? :)
