Worst Phobos documentation evar!

Adam D. Ruppe via Digitalmars-d digitalmars-d at puremagic.com
Tue Dec 30 11:51:25 PST 2014


On Tuesday, 30 December 2014 at 18:38:05 UTC, H. S. Teoh via 
Digitalmars-d wrote:
> Yeah, one of the most glaring defects of ddoc is the inability 
> to generate tables of contents and/or indices.

Absolutely, though I think this is more of a process thing than a 
ddoc thing - you could easily enough generate those files in a 
makefile as part of the build... I've written a program to do 
this before, but it was years ago and probably doesn't work 
anymore (i based it on the html output.)

> PR, please. ;-) This is a lack in content, that no macro system 
> can make up for, as you said.

I wrote a book, surely that gets me off the hook?! hey i found 
the time to write a rhyme, but those kind of conceptual things 
would take a lot of hours.... probably comparable to the book 
itself...


More information about the Digitalmars-d mailing list