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