Maven 2.x Javadoc Plugin

• Type: Bug
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 2.3
• Fix Version/s: 2.5
• Component/s: None
• Labels:

  None
• Environment:

  any

My taglet artifact has a dependency to commons-lang. But when executing the javadoc target the javadoc process complains with a ClassNotFoundException (in my case StringEscapeUtils but that doesn't matter).
Hmm - I had a look into the source and as far as I can see it the transitive dependencies are not resolved (only resolve is called and not resolveTransitively).

The workaround is to specify the transitive dependencies by hand taglet definitions without <tagletClass> elements:

<plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <configuration>
          <taglets>
            <taglet>

              <tagletClass>com.coremedia.drm.javadoc.api.ExampleTaglet</tagletClass>

              <tagletArtifact>
                <groupId>com.coremedia.drm.roapserver</groupId>
                <artifactId>build-utils</artifactId>
                <version>1.0.9-SNAPSHOT</version>
              </tagletArtifact>
            </taglet>
            <taglet>

              <tagletArtifact>
                <groupId>commons-lang</groupId>
                <artifactId>commons-lang</artifactId>
                <version>2.3</version>
              </tagletArtifact>
            </taglet>
          </taglets>
        </configuration>
      </plugin>

To reproduce remove the second <taglet> element and include an @api.example tag in one of your classes.

1. $i18n.getText("admin.common.words.hide")

   

   build-utils-1.0.9-SNAPSHOT.jar

   25/Feb/08 9:37 AM

   9 kB

   Sebastian Annies

   1. 
      META-INF/MANIFEST.MF 0.1 kB
   2. 
      com/coremedia/.../api/ExampleTaglet.class 4 kB
   3. 
      com/coremedia/.../checkstyle-header.txt 0.1 kB
   4. 
      com/coremedia/.../checkstyle/checkstyle.xml 8 kB
   5. 
      com/coremedia/drm/roapserver/pmd/pmd.xml 3 kB
   6. 
      META-INF/maven/.../build-utils/pom.xml 3 kB
   7. 
      META-INF/maven/.../pom.properties 0.1 kB

   Download Zip

   $i18n.getText("admin.common.words.show")

   

   build-utils-1.0.9-SNAPSHOT.jar

   25/Feb/08 9:37 AM

   9 kB

   Sebastian Annies

• Assignee:

  Vincent Siveton

  Reporter:

  Sebastian Annies

• Created:

  25/Feb/08 9:37 AM

  Updated:

  29/May/08 5:43 PM

  Resolved:

  29/May/08 5:43 PM