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