On Thursday, 3 October 2013 at 10:46:00 UTC, Joseph Rushton
Wakeling wrote:
On 02/10/13 21:34, Jonathan M Davis wrote:
It's not a bug at all. It's in
https://github.com/D-Programming-Language/dlang.org/blob/master/std.ddoc
ddoc is a macro language and does not at all restrict you to
what comes with
it, and the standard library uses quite a few macros that are
specific to it
(e.g. XREF for a link to another module in std). When you run
dmd with -D, you
can give it a .ddoc file which contains macros that you define
(or redefine), and
std.ddoc is the one that the standard library uses.
Ahh, OK, thanks.
If you to restrict yourself to the built-in ones in your code,
then use the
ones at
http://dlang.org/ddoc.html
And if you want to define more, then create your own .ddoc
file with them in it.
But Phobos uses std.ddoc, and we add new macros to it when we
feel that it's
appropriate.
Fair enough, but ...
, and is there any particular reason to favour WEB over, say,
LINK2 ?
It's less verbose.
... is there any difference between WEB and LINK2 apart from
the length? And if so, why not just include WEB among the
built-in macros?
Doesn't WEB just add "http://"; before the first parameter?
LINK2 = <a href="$1">$+</a>
WEB = <a href="http://$1";>$+</a>
I don't think there should be too many predefined macros. At
least not all related to HTML. But it's possible to override
them, right?
There are probably plenty of nice-to-have macros that would be
convenient to have always available, but it's pretty trivial to
add them yourself - or just use the phobos ddoc.
