Worst Phobos documentation evar!
Andrei Alexandrescu via Digitalmars-d
digitalmars-d at puremagic.com
Tue Dec 30 11:54:14 PST 2014
On 12/30/14 11:51 AM, Adam D. Ruppe wrote:
> 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.)
Exactly. And TOCs and indexes are generated wildly differently depending
on the publishing platform. I don't think ddoc should do that.
>> 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...
You're soon to find out that paradoxically writing a book enlists you
for more, not less, work.
Andrei
More information about the Digitalmars-d
mailing list