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@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