[Issue 5136] New: DDoc: listing methods in the 'Jump to' links may be undesirable

[d-bugmail at puremagic.com]

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

           Summary: DDoc: listing methods in the 'Jump to' links may be
                    undesirable
           Product: D
           Version: D2
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: minor
          Priority: P2
         Component: DMD
        AssignedTo: nobody at puremagic.com
        ReportedBy: ntrel-public at yahoo.co.uk


--- Comment #0 from Nick Treleaven <ntrel-public at yahoo.co.uk> 2010-10-30 08:23:13 PDT ---
The 'Jump to' links that appear at the top of Phobos documentation probably
should not include methods of struct, class, interface because this obscures
other module level tags e.g. functions.

This is particularly awkward here:
http://www.digitalmars.com/d/2.0/phobos/std_container.html

1. The template function 'make' is almost lost in the 'Jump to' list because of
the many methods of the container types.

2. Method links are unpredictable when there are duplicate names. E.g. the
'Jump to' link to 'popFront' goes to SList:Range:popFront, but popFront is also
a method of other container ranges, e.g. Array:Range.

Besides removing methods, an alternative solution for (1) would be to color
methods differently.

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