www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 11575] New: [dox] std.algorithm.remove navigation link points to wrong place

https://d.puremagic.com/issues/show_bug.cgi?id=11575

           Summary: [dox] std.algorithm.remove navigation link points to
                    wrong place
           Product: D
           Version: D2
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: DMD
        AssignedTo: nobody puremagic.com
        ReportedBy: hsteoh quickfur.ath.cx



This issue is ultimately caused by Ddoc generating non-unique link anchor ids
for identifiers. Anchor ids need to be the fully-qualified identifier, not just
the last component, since otherwise a module that contains both a module-level
function named 'remove' and a documented enum member named 'remove' (as in this
case) will have two identical HTML tag id's, which is both spec-violating and
leads to wrong behaviour like the 'remove' link at the top of the page pointing
to the wrong version of 'delete' in the documentation body.

This isn't specific to std.algorithm, of course; any module that have nested
members with the same identifier as a module-level symbol will have this
problem.

-- 
Configure issuemail: https://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
Nov 21 2013