Re: Apt munges local links to JavaDocs

[Lukas Theussl]

I can confirm that this does NOT work as it should. I have opened 
http://jira.codehaus.org/browse/DOXIA-397

Cheers,
-Lukas


Thom Nichols wrote:
I'm trying to put links in my apt documents that link to javadoc:

{{{../apidocs/groovyx/net/http/ParserRegistry.html#parseText(org.apache.http.HttpResponse)}ParserRegistry}}


I've got the relative path (../) in front, so it should be picked up as a
local (not internal link).  Apt still doesn't like it though and munges it:

[WARNING] [APT Parser] Modified invalid link:
'parseText(org.apache.http.HttpResponse)' to
'../apidocs/groovyx/net/http/ParserRegistry.html#parseTextorg.apache.http.HttpResponse'

So essentially it doesn't like the parens in the anchor (method anchors that
include spaces and commas get munged too.)  Boo!  Now I can't link to
methods in javadocs.  Do I need to add an absolute URI for all of these
links?  As far as I can tell, I'm using doxia-core 1.1.3.  Can someone
confirm for me that it _does_ work (maybe the dependencies aren't resolving
like I think they are?)

I'm using Maven 2.2.1 and running "mvn site:site"

Thanks!

Here's the relevant part of my POM:
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-site-plugin</artifactId>
                 <version>2.1.1</version>
                 <dependencies>
     <!-- For SyntaxHighlighter macro:
http://code.google.com/p/m2-site-tools/ -->
                     <dependency>
                         <groupId>com.anasoft.os</groupId>
                         <artifactId>m2st-doxia-macros</artifactId>
                         <version>${m2st.version}</version>
                     </dependency>
                       <dependency>
                         <groupId>org.apache.maven.doxia</groupId>
                         <artifactId>doxia-sink-api</artifactId>
                          <version>1.1.3</version>
                     </dependency>
                      <dependency>
                         <groupId>org.apache.maven.doxia</groupId>
                         <artifactId>doxia-core</artifactId>
                          <version>1.1.3</version>
                     </dependency>
                 </dependencies>
             </plugin>