#475 - Added Delombok plugin to build better JavaDoc.

Added Delombok plugin to produce a delomboked version of the sources to then let the JavaDoc plugin use that to render JavaDoc. Without that in place, methods generated via Lombok are completely missing from the Javadoc.

Updated reference links for JavaSE and Spring Framework references in the JavaDoc to the currently used versions.
This commit is contained in:
Oliver Gierke
2017-12-12 11:49:20 +01:00
parent 7fb43acf79
commit 38256fb3d4

View File

@@ -880,6 +880,24 @@
</executions>
</plugin>
<plugin>
<groupId>org.projectlombok</groupId>
<artifactId>lombok-maven-plugin</artifactId>
<version>${lombok}.0</version>
<configuration>
<addOutputDirectory>false</addOutputDirectory>
<sourceDirectory>${project.basedir}/src/main/java</sourceDirectory>
</configuration>
<executions>
<execution>
<phase>generate-sources</phase>
<goals>
<goal>delombok</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
@@ -894,6 +912,7 @@
<!-- copies doc-files subdirectory which contains image resources -->
<docfilessubdirs>true</docfilessubdirs>
<additionalparam>-Xdoclint:none</additionalparam>
<sourcepath>target/generated-sources/delombok</sourcepath>
<links>
<link>https://docs.spring.io/spring/docs/5.0.x/javadoc-api/</link>
<link>https://docs.spring.io/spring-data/commons/docs/current/api/</link>