[MPOM-269] Remove tagletArtifact from maven-javadoc-plugin

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Duplicate
• Affects Version/s: MAVEN-34
• Component/s: maven-plugins
• Assignee: Slawomir Jaranowski
• Reporter: Robert Scholte
• Created: 06/Oct/21 19:14
• Updated: 18/Dec/21 12:04
• Resolved: 18/Dec/21 12:04

Description

The maven-plugin pom contains the following:

<plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-javadoc-plugin</artifactId>
          <configuration>
            <tagletArtifacts>
              <tagletArtifact combine.id="org.apache.maven.plugin-tools:maven-plugin-tools-javadoc">
                <groupId>org.apache.maven.plugin-tools</groupId>
                <artifactId>maven-plugin-tools-javadoc</artifactId>
                <version>${mavenPluginToolsVersion}</version>
              </tagletArtifact>
            </tagletArtifacts>
          </configuration>
        </plugin>

However, as of 3.6 maven-plugin-tools-javadoc has been dropped because we prefer plugin annotations AND with Java 10 the Taglets API was moved to a different package.

This blocks javadoc generation when mavenPluginToolsVersion is 3.6.0+

Workaround in plugin project:

    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-javadoc-plugin</artifactId>
          <version>3.3.1</version>
          <configuration> <!--  remove after MPOM-269 -->
            <tagletArtifacts combine.self="override"/>
          </configuration>
        </plugin>
    </pluginManagement>

Issue Links

• duplicates: MPOM-250 remove the JavaDoc taglets from maven-parent (both to extract Mojo javadoc annotations and link in javadoc)
• is caused by: MPLUGIN-336 broken in JDK 10/JDK 11 - IllegalArgumentException