On 2012-04-02 07:52, Ary Manzana wrote:
On 4/2/12 12:39 PM, Jonathan M Davis wrote:
Phobos' macros are in
https://github.com/D-Programming-Language/d-programming-
language.org/blob/master/std.ddoc
As for linking macros,
LREF is used for references within a module.
XREF is used for references to std modules.
CXREF is used for references to core modules.
ECXREF is used for references to etc.c modules.
Again, the same things. D has ddoc and it tries to do everything with
ddoc. No, that's plain wrong. Links to other module members should be
done automatically. And the links should come from the compiler. The
compiler has that knowledge already, why loose it and work on a less
powerful level (ddoc)?
In general I think the compiler should automatically output
cross-references. But there are cases when you want to manually refer to
other parts of the documentation and in these cases you would needed
these macros.
--
/Jacob Carlborg