• d-bugmail puremagic.com (29/29) Mar 11 2012 http://d.puremagic.com/issues/show_bug.cgi?id=7687

d-bugmail puremagic.com writes:

http://d.puremagic.com/issues/show_bug.cgi?id=7687

           Summary: Ddoc should be able to generate "Jump to" links
           Product: D
           Version: D1 & D2
          Platform: All
               URL: http://dlang.org/phobos/std_array.html
        OS/Version: All
            Status: NEW
          Keywords: ddoc
          Severity: enhancement
          Priority: P2
         Component: DMD
        AssignedTo: nobody puremagic.com
        ReportedBy: smjg iname.com


--- Comment #0 from Stewart Gordon <smjg iname.com> 2012-03-11 10:33:25 PDT ---
Look at almost any page in the D2 Phobos docs.

If you have JavaScript enabled, you'll see that just after loading the page it
adds a set of "Jump to:" links.

The code to do this has been made part of the Phobos Ddoc template.  It works
by scanning the document for anchors and then listing them.

This is ridiculous.  What was the point of writing this JS code to get around a
limitation of Ddoc, rather than fixing the limitation?

Ddoc should be able to generate this list of links itself.  This way, it would
work regardless of whether the user has JS enabled.

Moreover, it would be good to give the user of Ddoc the choice of listing only
module-level symbols or all documented symbols in the module.

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