Javadoc generation fails with JDK 11 and later

[dvrajitha]

I am getting the following error when building for the 1st time.

> Task :spring-restdocs-core:javadoc
javadoc: error - The code being documented uses modules but the packages defined in https://docs.oracle.com/javase/8/docs/api/ are in the unnamed module.
****************\spring-restdocs-master\spring-restdocs-core\src\main\java\org\springframework\restdocs\payload\PayloadDocumentation.java:71: error: attribute not supported in HTML5: summary
         * <table summary="Paths and their values">
                  ^
***********\spring-restdocs-master\spring-restdocs-core\src\main\java\org\springframework\restdocs\payload\PayloadDocumentation.java:135: error: attribute not supported in HTML5: summary
         * <table summary="Paths and their values">
                  ^
3 errors

> Task :spring-restdocs-core:javadoc FAILED

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':spring-restdocs-core:javadoc'.
> Javadoc generation failed. Generated Javadoc options file (useful for troubleshooting): '**************\spring-restdocs-master\spring-restdocs-core\build\tmp\javadoc\javadoc.options'

* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 37s
59 actionable tasks: 1 executed, 58 up-to-date

[wilkinsona]

REST Docs should be built with Java 8. Are you trying to build with a version greater than that?

[dvrajitha]

@wilkinsona Yes, I am using Java 14.

[wilkinsona]

Thanks. It should work fine if you build with JDK 8. It should be possible to tweak things a little so that it works with JDK 14 as well.