On 03/10/13 20:06, Jonathan M Davis wrote:
I don't see the problem. If you want the standard set of macros, then look at
the docs. If you want more, then add your own. We need more in the Phobos
docs, so we define more - many of which wouldn't even make sense as standard
macros. I see no reason to restrict Phobos to the standard set of macros.
I wouldn't dream of restricting Phobos just to the standard macros, but I did
find it a little odd to define a new macro that does essentially much the same
as a built-in one. I suppose the logic would be that if you use WEB for
internal dlang.org links, and LINK2 for externals, then you can control the
protocol used for dlang.org -- e.g. switch everything from http to https if that
ever becomes desirable.
I don't know how Walter arrived at the standard ones. I don't think that we
ever mess with those at this point. If we need new ones, we add them to
std.ddoc.
The main problem was that I didn't know about std.ddoc (it's in the dlang.org
repo and not the Phobos one). Now that I know, it's trivial to build a single
Phobos doc file with
dmd -o -D std/whatever.d ../dlang.org/std.ddoc
I'd had some hassles building the docs en masse previously, and it was annoying
to have to rebuild the lot when the goal was to check the tweaked docs of a
single file.
So, thanks for the insight, and apologies if it seems like I'm over-complaining
about a minor issue :-)
Best wishes,
-- Joe
