Ary Borenszweig wrote:
As for ddoc, I wish there were a way to say "link to some declaration". In Java you have the @link{} tag, in C# the <see cref=""/> tag (I think). When you write documentation, understating declarations it participates with helps understanding the overall picture. There's currently no way to insert links to other declarations, and that makes it hard to navigate ddocs. This also applies for declarations found in parameters, base classes and implemented interfaces, etc.
It also has the benefit of enabling automatic refactoring of that reference, whenever the actual (non-ddoc) code is refactored.
-- Bruno Medeiros - Software Developer, MSc. in CS/E graduate http://www.prowiki.org/wiki4d/wiki.cgi?BrunoMedeiros#D
