aherbert commented on code in PR #187: URL: https://github.com/apache/maven-compiler-plugin/pull/187#discussion_r1181277904
########## src/site/apt/examples/set-compiler-release.apt.vm: ########## @@ -80,3 +80,30 @@ Setting the <<<--release>>> of the Java Compiler since Java 9. As such, the release number does not start with 1.x anymore. Also note that the supported <<<release>>> targets include the release of the currently used JDK plus a limited number of previous releases. + +* Usage on JDK 8 + + The <<<--release>>> option is used to target an older Java release than the JDK used during the + build process. This flag is not supported using JDK 8. To enable a project that targets Java 8 + to be built using JDK 8 or later requires the conditional usage of the <<<--release>>> option. Review Comment: Revised docs to explicitly state building "using JDK 8 and also JDK 9 or later". I think this is crux of the issue. If you only use one toolchain for the build then there is no issue, just configure it for that toolchain. If you wish your build to be flexible then you require conditional setting of the property. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@maven.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org