ddoc should generate hyperlinks to source code

Walter Bright newshound2 at digitalmars.com
Tue Mar 12 22:11:55 PDT 2013


On 3/12/2013 8:47 PM, timotheecour wrote:
> enhancement request:
> in the ddoc documentation generation, hyperlinks should appear:
>
> bool equal(Range1, Range2)(Range1 r1, Range2 r2);
> => should contain a hyperlink from 'equal' to source code defining that function.
> The hyperlink target should be customizable, either a url (eg: github, making
> sure it's retrieving the proper commit id so that code is in sync with ddoc), or
> local file system for users.
>
> more complex example:
> SortedRange!(Range, less) sort(alias less = "a < b", SwapStrategy ss =
> SwapStrategy.unstable, Range)(Range r);
>
> here hyperlinks should appear on template SortedRange, enum SwapStrategy, and
> the correct overload of sort.
>
> Thanks for any feedback!

It's a good idea.


More information about the Digitalmars-d mailing list