[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