You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@commons.apache.org by "Liviu Tudor (JIRA)" <ji...@apache.org> on 2012/07/27 22:01:34 UTC
[jira] [Commented] (FUNCTOR-23) aggregator.xml generates broken
JavaDoc links
[ https://issues.apache.org/jira/browse/FUNCTOR-23?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13424103#comment-13424103 ]
Liviu Tudor commented on FUNCTOR-23:
------------------------------------
Looking in the bugs for DOXIA, it turns out that they are planning a fix for this but in the next major release, meanwhile, the only workaround for this is to actually provide full URL's (rather than relative URL's -- which is what causes the problem).
I've changed the URLs to absolute (prefixed with http://commons.apache.org/functor/) only for those cases where the links contained an anchor and about to submit the new patch.
> aggregator.xml generates broken JavaDoc links
> ---------------------------------------------
>
> Key: FUNCTOR-23
> URL: https://issues.apache.org/jira/browse/FUNCTOR-23
> Project: Commons Functor
> Issue Type: Bug
> Reporter: Liviu Tudor
> Assignee: Simone Tripodi
> Priority: Trivial
> Labels: site
> Attachments: FUNCTOR-23.2.patch.bz2, FUNCTOR-23.patch.bz2
>
>
> {{aggregator.xml}} has a few JavaDoc links to methods, as such the anchor url contains a hash (#) as well as a method name followed by brackets (). This triggers Doxia/Velocity into "thinking" that this is a macro call, and as such the links resulted (during {{mvn site}}) do not contain these brackets.
> To fix them, as per https://jira.codehaus.org/browse/MSITE-646, we need to URL-escape the # hash sign (%23).
> This bug is created to propose a patch to {{aggregator.xml}} for this.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira