[MJAVADOC-229] javadoc:javadoc goal fails with Maven 2.0.10 or 2.1.0, but works with 2.0.9

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Not A Problem
• Affects Version/s: 2.5
• Environment: Mac OS X 10.5.6; Java 1.5.0_16; Maven 2.0.10 or 2.1.0; maven-javadoc-plugin 2.5
• Assignee: Unassigned
• Reporter: Jonathan Harlap
• Created: 02/Apr/09 11:16
• Updated: 14/Jul/09 07:12
• Resolved: 14/Jul/09 07:12

Description

Attempting to use the maven-javadoc-plugin with a pom.xml that works with Maven 2.0.9 fails to work with 2.0.10 or 2.1.0. The error message produced is:

[INFO] An error has occurred in JavaDocs report generation:Exit code: 1 - javadoc: error - invalid flag: -author

The javadoc plugin configuration from the pom.xml is:

<plugin>
	<groupId>org.apache.maven.plugins</groupId>
	<artifactId>maven-javadoc-plugin</artifactId>
	<executions>
		<execution>
			<goals>
				<goal>javadoc</goal>
			</goals>
			<phase>compile</phase>
		</execution>
	</executions>
	<configuration>
		<encoding>UTF-8</encoding>
		<verbose>false</verbose>
		<show>public</show>
		<subpackages>com.sinfoma.sintransfer.rest.services.resources
		</subpackages>
		<doclet>com.sun.jersey.wadl.resourcedoc.ResourceDoclet
		</doclet>
		<docletArtifacts>
			<docletArtifact>
				<groupId>com.sun.jersey.contribs</groupId>
				<artifactId>wadl-resourcedoc-doclet
				</artifactId>
				<version>${jersey-release-version}
				</version>
			</docletArtifact>
			<!--
				Also specify jersey and xerces as doclet artifacts as the
				ResourceDoclet uses classes provided by them to generate the
				resourcedoc.
			-->
			<docletArtifact>
				<groupId>com.sun.jersey</groupId>
				<artifactId>jersey-server</artifactId>
				<version>${jersey-release-version}
				</version>
			</docletArtifact>
			<docletArtifact>
				<groupId>xerces</groupId>
				<artifactId>xercesImpl</artifactId>
				<version>2.9.1</version>
			</docletArtifact>
		</docletArtifacts>
		<additionalparam>-output ${project.build.outputDirectory}/resourcedoc.xml</additionalparam>
	</configuration>
</plugin>

With the following additional configuration in the active profile:

<plugin>
	<groupId>org.apache.maven.plugins
	</groupId>
	<artifactId>maven-javadoc-plugin</artifactId>
	<configuration>
		<docletArtifacts>
			<docletArtifact>
				<groupId>com.sun.jersey.contribs
				</groupId>
				<artifactId>maven-wadl-plugin</artifactId>
				<version>${jersey-release-version}
				</version>
			</docletArtifact>
			<docletArtifact>
				<groupId>com.sun.jersey.contribs
				</groupId>
				<artifactId>wadl-resourcedoc-doclet
				</artifactId>
				<version>${jersey-release-version}
				</version>
			</docletArtifact>
			<!--
				Also specify jersey and xerces as doclet artifacts as the
				ResourceDoclet uses classes provided by them to generate the
				resourcedoc.
			-->
			<docletArtifact>
				<groupId>com.sun.jersey</groupId>
				<artifactId>jersey-server</artifactId>
				<version>${jersey-release-version}
				</version>
			</docletArtifact>
			<docletArtifact>
				<groupId>xerces</groupId>
				<artifactId>xercesImpl</artifactId>
				<version>2.9.1</version>
			</docletArtifact>
			<docletArtifact>
				<groupId>javax.xml.bind</groupId>
				<artifactId>jaxb-api</artifactId>
				<version>2.1</version>
			</docletArtifact>
			<docletArtifact>
				<groupId>com.sun.xml.bind</groupId>
				<artifactId>jaxb-impl</artifactId>
				<version>2.1.10</version>
			</docletArtifact>
			<docletArtifact>
				<groupId>javax.activation</groupId>
				<artifactId>activation</artifactId>
				<version>1.1</version>
			</docletArtifact>
			<docletArtifact>
				<groupId>javax.xml.stream</groupId>
				<artifactId>stax-api</artifactId>
				<version>1.0</version>
			</docletArtifact>
		</docletArtifacts>
	</configuration>
</plugin>

Issue Links

• is duplicated by: MJAVADOC-234 plugin fails on Java 6 with version 2.5 but works fine for 2.4
• is duplicated by: MJAVADOC-237 maven javadoc fails for alternate doclets since maven 2.0.10