Documentation 'quick index'

Piotr Szturmaj bncrbme at jadamspam.pl
Mon Nov 28 13:17:02 PST 2011


Jonathan M Davis wrote:
> On Monday, November 28, 2011 22:45:17 Vladimir Panteleev wrote:
>> On Mon, 28 Nov 2011 22:38:49 +0200, Piotr Szturmaj<bncrbme at jadamspam.pl>
>>
>> wrote:
>>> Hi,
>>>
>>> I'm trying to make ddoc index more readable. Here are some early
>>> results:
>>>
>>> http://bot.neostrada.pl/dpl.org/std.datetime.html
>>
>> I think that for something like this to have full benefit, DDoc would need
>> to be fixed so that generated anchors include their context.
>
> Yeah. I'd have made std.datetime's links similar to what's in std.algorithm,
> but as long as anchors aren't unique, there's not much point.

I think that <a name="mangledName"></a> would be the best approach. This 
would make tree generation easier (currently it parses text near to 
anchor) and all anchors would be unique.

> Whether this specific proposal is really the best way to go or not, I don't
> know, but there's no question that the links should represent the hierarchy of
> the module.

Do you mean sort order? This can be made switchable with single checkbox.


More information about the Digitalmars-d mailing list