Ddoc WEB function

[Joseph Rushton Wakeling]

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?