Cross-references in generated ddoc

Ary Manzana ary at esperanto.org.ar
Wed Apr 4 04:38:03 PDT 2012


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.


More information about the Digitalmars-d mailing list