How to work around the stricter Java 8 Javadoc when using Maven

by

For now, the easiest way I know to work around the stricter Java 8 Javadoc when using Maven is deactivating it.

Since the parameter -Xdoclint:none only exists in Java 8, defining this parameter breaks the build for any other Java. To prevent this, we can create a profile that will be active only for Java 8, making sure our solution works regardless of the Java version.

<profiles>
    <profile>
        <id>disable-java8-doclint</id>
        <activation>
            <jdk>[1.8,)</jdk>
        </activation>
        <properties>
            <additionalparam>-Xdoclint:none</additionalparam>
        </properties>
    </profile>
</profiles>

Just add that to your POM and you’re good to go.

For maven-javadoc-plugin 3.0.0 users:

Replace

<additionalparam>-Xdoclint:none</additionalparam>

by

<doclint>none</doclint>

Thanks @banterCZ!

More Related Contents:

  1. Maven is not working in Java 8 when Javadoc tags are incomplete
  2. What’s the difference between Instant and LocalDateTime?
  3. How to parse/format dates with LocalDateTime? (Java 8)
  4. PermGen elimination in JDK 8
  5. Dealing with “Xerces hell” in Java/Maven?
  6. How to install Java 8 on Mac
  7. Maven – Always download sources and javadocs
  8. UnsupportedTemporalTypeException when formatting Instant to String
  9. How to convert a Java 8 Stream to an Array?
  10. How to sum a list of integers with java streams?
  11. Why does Stream not implement Iterable?
  12. In Java 8, is there a ByteStream class?
  13. LambdaConversionException with generics: JVM bug?
  14. Cannot change version of project facet Dynamic Web Module to 3.0?
  15. functional interface that takes nothing and returns nothing [duplicate]
  16. Does Stream.forEach respect the encounter order of sequential streams?
  17. Configure active profile in SpringBoot via Maven
  18. Adding resources in IntelliJ for Maven project
  19. Java 8 Supplier with arguments in the constructor
  20. How to create a Java / Maven project that works in Visual Studio Code?
  21. Maven spring boot run debug with arguments
  22. How to sum values in a Map with a stream?
  23. Java access bean methods with LambdaMetafactory
  24. Why can we use ‘this’ as an instance method parameter?
  25. What kind of List does Collectors.toList() return?
  26. Java 8 LocalDate – How do I get all dates between two dates?
  27. Please Explain Java 8 Method Reference to instance Method using class name
  28. NoClassDefFoundError sun/io/ByteToCharConverter with InterBase JDBC driver
  29. JavaFX Maven Plug-in: No plugin found for prefix ‘jfx’ in the current project and in the plugin groups
  30. non-interference requirement on Java 8 streams

Leave a Comment