On Tuesday, August 23, 2011 12:50 Adam D. Ruppe wrote: > Jonathan M Davis wrote: > > DDoc does not understand scoping at all. > > Actually, DDoc understands scoping very well, and even outputs > the data with appropriate nesting in HTML! > > The problem is that the <a name=""> anchors discard that > information for whatever reason. > > I'm not sure if it's just another crappy macro in the std.ddoc or > if it's that the full name isn't made available by ddoc, but either > way, the HTML actually does show scopes properly. A post-processor > can create proper anchors from just that existing structure!
You're right. Aside from the anchors, ddoc deals with the scoping properly, but as far as the anchors go, ddoc doesn't deal with the scoping property at all. I'm fairly certain that the anchors are generated by ddoc, not std.ddoc (it generates the links at the top of the page using the anchors, but as far as I can tell, the anchors exist before std.ddoc does it's thing). So, unless ddoc itself is fixed, the only way to get proper anchors is to process the files after ddoc has done its thing, which really isn't acceptable. It needs to be fixed. The problem is that we need someone who knows enough about ddoc to be able to fix it to take the time to fix it - either that or someone needs to learn. I've been tempted to dig in and do it so that std.datetime's links can be made sane, but the task seems daunting enough that I haven't really looked into it yet. I may have to though if no one else steps up, since std.datetime's links really need to be improved. - Jonathan M Davis
