[JXR-10] Create a named anchor for each symbol like Javadoc does

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Won't Fix
• Component/s: jxr
• Assignee: Unassigned
• Reporter: Laurent Caillette
• Created: 05/May/04 08:10
• Updated: 20/Dec/14 16:38
• Resolved: 20/Dec/14 15:08

Description

I want to reference source code from XDoc. By now I'm writing a link like this:
<a href="./../xref/com/acme/foo/Foo.html#127">method here</a>

The problem is, my link can lead to a wrong place just after a few cosmetic changes in source code. Of course, automatic link check will not guess the link went wrong.

It would be nice to generate named anchors in XRef the same way Javadoc does, supporting a link like this from XDoc:
<a href="./../xref/com/acme/foo/Foo.html#bar(Object)">method here</a>

Another way to achieve the same result would be to parse Java comments to find a special expression to be transformed in a named anchor, but the Javadoc way seems more straightforward.

Issue Links

• relates to: JXR-13 Cross-reference information
• relates to: JXR-54 Discuss about Forrestdoc and JXR