Improving ddoc

Andrei Alexandrescu via Digitalmars-d digitalmars-d at puremagic.com
Thu Jan 1 02:21:51 PST 2015


On 1/1/15 2:04 AM, Joseph Rushton Wakeling via Digitalmars-d wrote:
> On 31/12/14 20:50, Andrei Alexandrescu via Digitalmars-d wrote:
>> One simple starter would be to allow one escape character, e.g. the
>> backtick
>> (`), as a simple way to expand macros: instead of $(MACRO arg1, arg2)
>> one can
>> write `MACRO arg1, arg2`.
>
> Would that be accompanied by deprecation and removal of the $(MACRO
> arg1, arg2) syntax?

No.

> I ask because for me, one of the biggest annoyances of Ddoc (in terms of
> source readability of the docs) is having to use $(RPAREN) in order to
> avoid Ddoc accidentally seeing a macro where there is none.

cd code/d/phobos
git grep RPAREN | wc -l
       28

RPAREN is indeed more frequent in dlang.org:

cd code/d/phobos
git grep RPAREN | wc -l
       589

Yet that's out of 25479 lines of ddoc source, so one every 43 lines. The 
majority are in changelog.dd; I guess a couple of macros might help there.


Andrei



More information about the Digitalmars-d mailing list