On 4/4/12 6:35 PM, Jacob Carlborg wrote:
On 2012-04-04 07:38, Ary Manzana wrote:
Hi all,
I just submitted a pull request that makes ddoc generate
cross-references... even for templates!
https://github.com/D-Programming-Language/dmd/pull/865
It would be awesome if you can try it with your projects, see if it's
working properly and doesn't choke. I tried it with phobos and it worked
fine.
Also, if someone has ideas about how to solve the issues I describe,
they are more than welcome.
That's awesome.
Looking at http://pancake.io/1e79d0/array.html, none of the templates
are cross-referenced, or was that one of the problems?
Ah, no. That's because I ran it against object.di, which doesn't have
ddoc comments at all. I don't generate cross-references to undocumented
symbols.
I uploaded a new version which I ran against an object.di which has
empty ddocs for everything. Now you can see there are some
cross-references. (if you find some is missing, please tell me).
Why are you not using the mangled name when creating anchors?
I don't think there's need for the mangled name. It's also more natural
to give a link like foo.html?Some.Class than a mangled name.
