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...
