ddoc crossreferences

[Morusaka]

Morusaka Wrote:

> Ok, with the help of grep i've found a lot of examples in Tango sources, for instance in: tango/text/locale/Core.d
> 
> $(LINK2 #whereToGo, linkName)
> ...
> ...
> ...
> $(ANCHOR whereToGo)
> ...
> ...
> ...
> 

Uhm... I'm not sure where ANCHOR macro is defined... I can't find it.
The macro would expand to something like:

<a name="name" id="id"></a>

but I'm not sure where this line is supposed to be.
If i write something like:

/**
 * <a name="name" id="id"></a>
 * foo description bla bla bla
 * ...
 * ...
 */

void foo()
{
    ....
    ....
}

the link generated by CandyDoc is *AFTER* function foo definition:

(immagine this is CandyDoc documentation)

void foo();
foo description bla bla bla   <----- link points here
...
...
...

so, if you put somewhere this line:

$(LINK2 fooLink, foo)

once clicked, the browser will point to:

foo description bla bla bla

instead of (which i'd prefer)

void foo()
foo description bla bla bla
...
...

Luca.