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?
