[jira] Issue Comment Edited: (DOXIA-428) Fix broken fragment links in Doxia

["Christian Schlichtherle (JIRA)" <ji...@codehaus.org>]

    [ 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