Maven 3 javadoc plugin ignores configuration

Question

I am using maven 3 and configured my javadoc according to the new maven 3 siteplugin + javadoc configuration. However, all my javadoc configuration options seem to be ignored. Thus, there is no grouping of packages, no links to the source, etc.

My project is a multi-module project, the command I use is: mvn3 clean package javadoc: aggregate

Here is the relevant part of my pom root .:

<build> <!-- Memory management properties for jenkins build. --> <pluginManagement> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <version>2.11</version> <configuration> <argLine>-Xmn8m -Xms32m -Xmx96m -XX:PermSize=32m -XX:MaxPermSize=128m</argLine> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-site-plugin</artifactId> <version>3.0-beta-3</version> <configuration> <reportPlugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <version>2.8</version> <configuration> <verbose>true</verbose> <groups> <group> <title>Hypercube</title> <packages>org.hypercube*</packages> </group> <group> <title>Hyperdrive</title> <packages>org.hyperdrive*</packages> </group> <group> <title>Hydrogen</title> <packages>org.hydrogen*</packages> </group> <group> <title>Fusion-X11</title> <packages>org.fusion.x11*</packages> </group> <group> <title>Fusion-Qt</title> <packages>org.fusion.qt*</packages> </group> </groups> <linksource>true</linksource> <minmemory>16m</minmemory> <maxmemory>128m</maxmemory> </configuration> </plugin> </reportPlugins> </configuration> </plugin> </plugins> </pluginManagement> </build> 

Answer 1

This is because Maven shares the plug-config plugins and reporting modules within the site plugin configuration. The excerpt that you publish will only work when you run mvn site , and not for javadoc purposes directly. This behavior affects all plugins. Afaik is the only way to duplicate the configuration in a “regular” plugin-config as follows:

 <build> <!-- Memory management properties for jenkins build. --> <pluginManagement> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <version>2.11</version> <configuration> <argLine>-Xmn8m -Xms32m -Xmx96m -XX:PermSize=32m -XX:MaxPermSize=128m</argLine> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-site-plugin</artifactId> <version>3.0-beta-3</version> <configuration> <reportPlugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <version>2.8</version> <configuration> <verbose>true</verbose> <groups> <group> <title>Hypercube</title> <packages>org.hypercube*</packages> </group> <group> <title>Hyperdrive</title> <packages>org.hyperdrive*</packages> </group> <group> <title>Hydrogen</title> <packages>org.hydrogen*</packages> </group> <group> <title>Fusion-X11</title> <packages>org.fusion.x11*</packages> </group> <group> <title>Fusion-Qt</title> <packages>org.fusion.qt*</packages> </group> </groups> <linksource>true</linksource> <minmemory>16m</minmemory> <maxmemory>128m</maxmemory> </configuration> </plugin> </reportPlugins> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <version>2.8</version> <configuration> <verbose>true</verbose> <groups> <group> <title>Hypercube</title> <packages>org.hypercube*</packages> </group> <group> <title>Hyperdrive</title> <packages>org.hyperdrive*</packages> </group> <group> <title>Hydrogen</title> <packages>org.hydrogen*</packages> </group> <group> <title>Fusion-X11</title> <packages>org.fusion.x11*</packages> </group> <group> <title>Fusion-Qt</title> <packages>org.fusion.qt*</packages> </group> </groups> <linksource>true</linksource> <minmemory>16m</minmemory> <maxmemory>128m</maxmemory> </configuration> </plugin> </plugins> </pluginManagement> </build>