www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 14963] New: Cross-module docs in phobos-prerelease have wrong


          Issue ID: 14963
           Summary: Cross-module docs in phobos-prerelease have wrong link
           Product: D
           Version: D2
          Hardware: All
                OS: All
            Status: NEW
          Severity: normal
          Priority: P1
         Component: dlang.org
          Assignee: nobody puremagic.com
          Reporter: hsteoh 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

XREF and XREF_PACK_NAMED should use relative URLs instead of absolute URLs.

Aug 25 2015