Uploaded image for project: 'Maven Javadoc Plugin'
  1. Maven Javadoc Plugin
  2. MJAVADOC-178

Transitive Dependencies to Taglet Artifacts are not resolved nor added to the classpath

    XMLWordPrintableJSON

Details

    • Bug
    • Status: Closed
    • Minor
    • Resolution: Fixed
    • 2.3
    • 2.5
    • None
    • None
    • any

    Description

      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.

      Attachments

        1. build-utils-1.0.9-SNAPSHOT.jar
          9 kB
          Sebastian Annies

        Activity

          People

            siveton Siveton Vincent
            sannies Sebastian Annies
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: