DDoc with cross-references

Ary Manzana ary at esperanto.org.ar
Sun Apr 1 21:29:13 PDT 2012


On 4/2/12 12:20 PM, Ary Manzana wrote:
> I'm planning to add cross-references to the default ddoc output. At
> least that's the simplest thing I could do right now that might improve
> ddoc somehow.
>
> I see the documentation generated for phobos, for example:
>
> http://dlang.org/phobos/std_array.html#Appender
>
> has anchors to the many symbols (in fact, now I notice it's flawed,
> because they are not fully-qualified).
>
> Does anyone know where can I get the macros for generating such output?
> I will need it for generating the cross-links.
>
> But a more appropriate question is: why the default ddoc output doesn't
> generate such anchors by default? At least putting an ID to the
> generated DT...

I also wonder why it's not implemented. I mean, it seems *so* easy to do 
it. Just add a toDdocChars() method to every Dsymbol. For basic types, 
just output their string representation (int, float, etc.). For classes, 
structs, etc, just output:

<a href="module_name.html#struct_name">struct_name</a>

or something like that...


More information about the Digitalmars-d-learn mailing list