Worst Phobos documentation evar!

[ketmar via Digitalmars-d]

On Mon, 29 Dec 2014 18:43:56 -0800
Walter Bright via Digitalmars-d <digitalmars-d at puremagic.com> wrote:

> On 12/29/2014 6:37 PM, ketmar via Digitalmars-d wrote:
> > it's great that Ddoc is good for making books. but it's not so great
> > that it's bad for documenting source code.
> 
> I also use it for all the documentation on the Digital Mars site, which include 
> a lot of coding examples, the articles I wrote for Dr. Dobb's about code, all 
> the documentation on walterbright.com, etc.

yes, that's exactly why it's not so great for documenting source code.
you basically invented your own TeX, which has alot of features to
write stand-alone texts, but almost completely unreadable as a source
code documentation without preprocessor. Ddoc is just too powerful.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 181 bytes
Desc: not available
URL: <http://lists.puremagic.com/pipermail/digitalmars-d/attachments/20141230/772519f1/attachment.sig>