Andrei's Google Talk

lurker lurkers at lurking.org
Sat Aug 14 22:32:49 PDT 2010


Walter Bright Wrote:

> dsimcha wrote:
> > == Quote from Adam Ruppe (destructionator at gmail.com)'s article
> >> To me, the biggest appeal of ddoc is that it doesn't require markup to
> >> give good enough results. It's almost mindless to use.
> > 
> > Not only that, because it doesn't require markup, the docs look good as plain text
> > comments, not just when processed into HTML.
> 
> That wasn't by accident :-). One of the explicit major goals of Ddoc was to not 
> require any markup unless you are getting into more advanced use of it. Some of 
> the design was compromised to make that work, but I think the results are worth it.

Unlike doxygen, Ddoc almost accepts plain english. It's not hard to see how much better designed Ddoc is *for D code*. A generic document generator can never support unit tests, contracts and so forth. I disagree with our ''retard'' completely.


More information about the Digitalmars-d mailing list