Improve anchors for ddoc (dlang.org)
yao.gomez at gmail.com
Sat Feb 18 10:58:36 PST 2012
On Saturday, 18 February 2012 at 17:24:13 UTC, Martin Nowak wrote:
> Basically every caption in the language reference should have
> an anchor
> so that one can refer to it.
> http://www.dlang.org/template.html#class-templates // <-
Yes, totally agree about that. I think that an index with links
to each section should be included at the beginning of some of
the longer language reference pages, like for example this one:
There's a list of links at the beginning, but they link to the
related specification part.
> For the library reference different scoped members with same
> names collide.
> Listing a flat popFront in the jump-to header is pretty useless.
> Each entry that has more than one member could have it's own
> Jump to: RangeA, RangeB, ...
> struct RangeA;
> Jump to: front, popFront, ...
I think that this is a limitation of how DDOC generates the
of each Phobos module takes the first reference to that symbol,
regardless of whether it corresponds to that or not. Either the
should be improved to cope with this limitation.
More information about the Digitalmars-d