Generate Javadoc without duplicate execution of phase generate-sources.
- The standard goals
javadoc
andtest-javadoc
invoke separate lifecylesgenerate-sources
andgenerate-test-sources
. - In a CI environment you now might execute something like
mvn clean deploy site site-deploy
. - During
site
build the standard reports will triggergenerate-sources
orgenerate-test-sources
again, depending on your build this may take some time, because stuff likeenforcer
or generating stubs from a WDSL will be invoked again, which may lead to longer build times. - See MJAVADOC-369 as well.
- As of version 2.10 two new reports are defined,
javadoc-no-fork
andtest-javadoc-no-fork
which will not trigger above phases a second time. - Configure this in your
reporting
section as follows:- <project>
- ...
- <reporting>
- <excludeDefaults>true</excludeDefaults>
- <plugins>
- <plugin>
- <groupId>org.apache.maven.plugins</groupId>
- <artifactId>maven-javadoc-plugin</artifactId>
- <version>3.11.2</version>
- <reportSets>
- <reportSet>
- <reports>
- <report>javadoc-no-fork</report>
- <report>test-javadoc-no-fork</report>
- </reports>
- </reportSet>
- </reportSets>
- </plugin>
- </plugins>
- </reporting>
- ...
- </project>
Note: These reports may not be used for aggregate reports. For those, see the example of generating aggregate Javadocs without execution of phase compile.