DDoc with cross-references

[Jacob Carlborg]

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