dlangspec.pdf?

[Philippe Sigaud]

On Sat, Jan 5, 2013 at 2:13 PM, Andrei Alexandrescu <
SeeWebsiteForEmail at erdani.org> wrote:

> On 1/5/13 4:17 AM, Alex Rønne Petersen wrote:
>
>> But I agree - Markdown would be significantly nicer to write the spec
>> in... Ddoc has a too HTML-y feel to it for general writing.
>>
>
> But Markdown seems to have no macros.


Indeed it has none, good point.

Since I just remade a 180-pages tutorial on D templates in markdown without
much trouble, I guess documentation and tutorial are different beasts. I
felt no need for macros, really, but I can see how they are useful for Ddoc
pages.

Note that markdown was crafted to be readable by itself, even though its
final goal is to be rendered in HTML. Ddoc has no such compulsion (some
macros are a bit obscure for me when I read documentation in raw form)

You know, I always felt Ddoc was a strange sublanguage bolted onto D. An
elegant solution would be to have macros be D code, but I have nothing to
propose here.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.puremagic.com/pipermail/digitalmars-d/attachments/20130105/a6c48916/attachment-0001.html>