Cross referencing in Ddoc

[Jakob Ovrum]

On Sunday, 29 December 2013 at 17:38:55 UTC, Jacob Carlborg wrote:
> If nothing has happened recently the current situation of cross 
> referencing in Ddoc sucks. What's currently being used in the 
> Phobos documentation is the XREF, CXREF and ECXREF ddoc macros. 
> These macros take two arguments, append "std", "core" or "etc" 
> and form a link of the arguments. The problem with this is that 
> it doesn't work so good for referring to symbols in a deeper 
> package hierarchy.

bootDoc[1] fixes this (thanks to Denis) with a number of standard 
macros that are reasonably easy to use[2].

It also uses JavaScript to "fix" (insofar as JS is a fix for 
anything) the issue of page anchors not supporting nested symbols 
properly.

[1] https://github.com/JakobOvrum/bootDoc

[2] https://github.com/JakobOvrum/bootDoc/wiki/Macros