On Wednesday, 13 March 2013 at 03:47:10 UTC, timotheecour wrote:
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.
In order to link to the local file system, the distribution needs to contain HTML-rendered source code. There is no convention for linking to a specific place in a text file.
I think including .html versions of all Phobos source code is not worth it for the links alone. However, it would be nice if there was a HTML version of the source code, which contained links to each identifier's definitions wherever they appear, such as the LXR project: See e.g. http://lxr.linux.no/#linux+v3.8.2/kernel/acct.c
For for GitHub links, the makefile could create a .ddoc inclusion file which defines the URL base (pointing to GitHub, to the current commit), for the compiler to use when generating the links in the documentation.
