Thread overview
[Issue 8794] New: DDoc should provide qualified symbol names suitable for anchors
Oct 10, 2012
Nick Treleaven
Oct 10, 2012
Nick Treleaven
Oct 10, 2012
Brad Anderson
Oct 10, 2012
Nick Treleaven
Oct 22, 2012
Walter Bright
October 10, 2012
http://d.puremagic.com/issues/show_bug.cgi?id=8794

           Summary: DDoc should provide qualified symbol names suitable
                    for anchors
           Product: D
           Version: D2
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: enhancement
          Priority: P2
         Component: DMD
        AssignedTo: nobody@puremagic.com
        ReportedBy: ntrel-public@yahoo.co.uk


--- Comment #0 from Nick Treleaven <ntrel-public@yahoo.co.uk> 2012-10-10 08:59:55 PDT ---
(I looked for existing bugs but found none pertaining only to dmd/ddoc itself,
hence this new one).

Currently anchor links are generated for Phobos using DDOC_PSYMBOL in std.ddoc:

DDOC_PSYMBOL = <a name="$0"></a><span class="ddoc_psymbol">$0</span>

Unfortunately there is no way to get the 'qualified' name e.g. of a member or method. Consequently there are anchor collisions such as enum EditOp.remove instead of free function remove():

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

DDoc should provide a way to get qualified symbol names suitable for anchor links.

I have a pull request almost ready to address this.

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
October 10, 2012
http://d.puremagic.com/issues/show_bug.cgi?id=8794



--- Comment #1 from Nick Treleaven <ntrel-public@yahoo.co.uk> 2012-10-10 09:19:23 PDT ---
> I have a pull request almost ready to address this.

https://github.com/D-Programming-Language/dmd/pull/1174

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
October 10, 2012
http://d.puremagic.com/issues/show_bug.cgi?id=8794


Brad Anderson <eco@gnuk.net> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |eco@gnuk.net


--- Comment #2 from Brad Anderson <eco@gnuk.net> 2012-10-10 09:29:55 PDT ---
Here's the existing bug for this: http://d.puremagic.com/issues/show_bug.cgi?id=6017

This could be marked as a duplicate or vice versa since this has a better title.

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
October 10, 2012
http://d.puremagic.com/issues/show_bug.cgi?id=8794



--- Comment #3 from Nick Treleaven <ntrel-public@yahoo.co.uk> 2012-10-10 09:44:03 PDT ---
Yes, bug #6017 is very similar. I thought my dmd pull request might need a separate issue as it is purely for dmd, whereas the other issue may need a small update to the website's std.ddoc once we have the dmd fix.

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
October 22, 2012
http://d.puremagic.com/issues/show_bug.cgi?id=8794



--- Comment #4 from github-bugzilla@puremagic.com 2012-10-21 20:19:23 PDT ---
Commits pushed to master at https://github.com/D-Programming-Language/dmd

https://github.com/D-Programming-Language/dmd/commit/f56dc1b9fa3fab48229c277a3f3907c7c800aef7 Issue 8794 - Add DDOC_ANCHOR macro for qualified anchor links

https://github.com/D-Programming-Language/dmd/commit/563195f8d0061283cf0ed5f9454ede541fad2137 Merge pull request #1174 from ntrel/ddoc-anchor

Issue 8794 - Add DDOC_ANCHOR macro for qualified anchor links

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
October 22, 2012
http://d.puremagic.com/issues/show_bug.cgi?id=8794


Walter Bright <bugzilla@digitalmars.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
            Version|D2                          |D1 & D2
         Resolution|                            |FIXED


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