Details
-
Type:
Improvement
-
Status:
Open
-
Priority:
Minor
-
Resolution: Unresolved
-
Affects Version/s: None
-
Fix Version/s: None
-
Component/s: jxr
-
Labels:None
-
Number of attachments :
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-54
Discuss about Forrestdoc and JXR
-
sounds like a JXR bug... should be filed there. We can upgrade to a new version once it is fixed there.