Simple step to making Ddoc better

Andrei Alexandrescu via Digitalmars-d digitalmars-d at puremagic.com
Fri Dec 18 08:28:31 PST 2015


On 12/18/2015 11:20 AM, Adam D. Ruppe wrote:
> On Friday, 18 December 2015 at 16:09:43 UTC, Andrei Alexandrescu wrote:
>> Could someone destroy https://issues.dlang.org/show_bug.cgi?id=15460?
>> Should take minutes.
>
>
> I kinda want to toy with cross referencing too. I have an idea: a magic
> macro that expands like Object in specified DDoc contexts to
>
> $(D_SYMBOL_NAME object Object)
>
> yes, it outputs the full name, but not as dots - as different macro
> arguments. Then we can make a recursive macro to put it back together as
> like phobos/object_Object or something. idk yet, but I think we can do
> something.
>
> And we need crosslinking somehow. Even just putting the dotted name that
> we can process in another list (my dpldocs.info for example can find a
> page) is better than nothing.
>
>
> I have so much stuff to do but blargh, I'll look at all this.

What's needed here is to wrap all raw text in DDOC_RAWTEXT as I proposed 
a few days ago. Then external tooling makes cross referencing trivial. 
Wanna work on that? -- Andrei


More information about the Digitalmars-d mailing list