多模块maven项目生成javadoc文档

多模块maven项目生成聚合javadoc文档使用 <aggregate>true</aggregate>设置。
aggregate 在3.1.0版本不生效。

    <plugin>  
        <groupId>org.apache.maven.plugins</groupId>  
        <artifactId>maven-javadoc-plugin</artifactId>  
        <version>2.9.1</version>  
        <configuration>  
            <aggregate>true</aggregate>  
        </configuration>  
    </plugin>  

隐藏坑

1. maven-javadoc-plugin 插件不能放到父pom的 pluginManagement 标签中。
2. 父pom不能指定 <sourcepath>src/main/java</sourcepath>
3. javadoc 和 lombok 多模块项目一起使用暂时没找到解决方案