[Issue 14963] New: Cross-module docs in phobos-prerelease have wrong link targets
via Digitalmars-d-bugs
digitalmars-d-bugs at puremagic.com
Tue Aug 25 20:29:04 PDT 2015
https://issues.dlang.org/show_bug.cgi?id=14963
Issue ID: 14963
Summary: Cross-module docs in phobos-prerelease have wrong link
targets
Product: D
Version: D2
Hardware: All
OS: All
Status: NEW
Severity: normal
Priority: P1
Component: dlang.org
Assignee: nobody at puremagic.com
Reporter: hsteoh at quickfur.ath.cx
For example, look at
http://dlang.org/phobos-prerelease/std_algorithm_searching.html and find the
link to std.range.sortedRange on the table row for `find`. This link
incorrectly points to http://dlang.org/phobos/ (i.e., the docs for the released
version of Phobos, rather than the docs for the prereleased version).
The cause of this problem is the use of absolute URLs in the definition of XREF
and XREF_PACK_NAMED in dlang.org.ddoc. This causes *all* cross-module links in
the prerelease docs to point to the release docs -- a very confusing situation
for someone navigating the prerelease docs. It may even involve broken links if
the link target is for a symbol introduced in git HEAD but not yet in a
release.
XREF and XREF_PACK_NAMED should use relative URLs instead of absolute URLs.
--
More information about the Digitalmars-d-bugs
mailing list