Update docs for Maven 4 and release option #294
Conversation
src/site/apt/index.apt.vm
Outdated
| default compiler used to compile Java sources is javax.tools.JavaCompiler. | ||
| Other compilers than <<<javac>>> can be used. | ||
| default compiler used to compile Java sources is <<<javac>>>. | ||
| If you want to use another compiler, refer to the {{{./non-javac-compilers} guide: Using Non-Javac Compilers}}. |
There was a problem hiding this comment.
Can we use non javac compilers after: #271 @gnodet @desruisseaux ?
There was a problem hiding this comment.
Yes. Any compiler that implements the javax.tool.JavaCompiler interface should work. It is the case of Eclipse compiler for instance. I'm not sure if it has been tested however (not on my side), but we will fix issues or report them to ECJ if we found some.
There was a problem hiding this comment.
So should we update non-javac-compilers guide?
There was a problem hiding this comment.
So should we update
non-javac-compilersguide?
And shall I do it in this PR or do you (@desruisseaux) want to do it, when "the work on sources" (see other comment) is done?
There was a problem hiding this comment.
non-javac-compilers guide - in next PR, the best with IT
There was a problem hiding this comment.
non-javac-compilers guide - in next PR, the best with IT
created https://issues.apache.org/jira/browse/MCOMPILER-609 for this.
| @@ -28,21 +28,25 @@ | |||
|
|
|||
| Setting the <<<-source>>> and <<<-target>>> of the Java Compiler | |||
|
|
|||
| (If you're are using version <<<3.13.0>>> or newer of the Compiler Plugin, use the recommended | |||
| {{{../examples/set-compiler-release.html}<<<maven.compiler.release>>> property}}.) | |||
|
|
|||
There was a problem hiding this comment.
Note: this section may need to be updated later, after the work on <sources> element has been completed. The recommended approach would then be to specify the release together with the declaration of the sources.
No change needed now, it is just a reminder for revisiting later.
This PR updates several parts of the documentation to Maven 4 based on JDK 17 and aligns the docs to the new Java version schema. In particular on the front page it's mentioned that "8" is the default, where in the code it's actual "1.8" - but I wanted to keep docs consistent here.
Note: For Maven 3 branch I will create a separate PR later (maybe starting this evening)