Worst Phobos documentation evar!

[Andrei Alexandrescu via Digitalmars-d]

On 12/29/14 6:49 PM, ketmar via Digitalmars-d wrote:
> 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.

I use (La)TeX macros all the time, and although necessary they're beyond 
awful. DDoc macros are a lot nicer and more consistent by comparison. 
They are not, however, as powerful. -- Andrei