[ http://jira.codehaus.org/browse/DOXIA-428?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=267427#action_267427 ]
Christian Schlichtherle edited comment on DOXIA-428 at 5/19/11 7:39 AM: ------------------------------------------------------------------------ For example, in an APT file, I have this sentence: {code} For example, by using the multi-threaded method {{{./apidocs/de/schlichtherle/truezip/file/TFile.html#cat(java.io.InputStream, java.io.OutputStream)}<<<TFile.cat(InputStream, OutputStream)>>>}}, you'll never have to write a naive read-then-write loop again. {code} It doesn't work because the fragment gets shredded. was (Author: christian_schlichtherle): For example, in an APT file, I have this sentence: {code} For example, by using the multi-threaded method {{{./apidocs/de/schlichtherle/truezip/file/TFile.html#cat(java.io.InputStream, java.io.OutputStream)}<<<TFile.cat(InputStream, OutputStream)>>>}}, you'll never have to write a naive read-then-write loop again. {code} It doesn't work because > Fix broken fragment links in Doxia > ---------------------------------- > > Key: DOXIA-428 > URL: http://jira.codehaus.org/browse/DOXIA-428 > Project: Maven Doxia > Issue Type: Bug > Components: Module - Apt > Affects Versions: 1.2 > Reporter: Christian Schlichtherle > > Using APT in maven-site-plugin:3.0-beta-3, it is impossible to link to a > class member in Javadoc, because the link requires a fragment to be used > which is shredded by the APT conversion. You can't even link to > Object.toString() because this would be converted to > href="Object.html#toString()". While this makes a perfectly valid fragment > according to RFC 2396, APT shreds it to some unusable result. > Please fix this linking feature - it's utterly broken! APT should not touch > fragments at all when referring to external links. -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa - For more information on JIRA, see: http://www.atlassian.com/software/jira