RFR: 8341935: javac states that -proc:full is the default but the default as of 23 is -proc:none

[Jan Lahoda]

On Tue, 19 Nov 2024 06:48:52 GMT, Joe Darcy <darcy at openjdk.org> wrote:

> Update javac man page is describe current behavior; includes updates discussed in CSR [JDK-8321319](https://bugs.openjdk.org/browse/JDK-8321319) that were not included in the man pages for JDK 23 GA.

Overall looks good, with one nit comment inline.

src/jdk.compiler/share/man/javac.md line 341:

> 339:     `-proc:none` means that compilation takes place without annotation
> 340:     processing. `-proc:only` means that only annotation processing is done,
> 341:     without any subsequent compilation. and

Nit:
either:
Suggestion:

    without any subsequent compilation.


or:
Suggestion:

    without any subsequent compilation. And


(So that the sentence either starts with a capital letter, or with the `-proc:full`, as the other sentences here do.)

-------------

Marked as reviewed by jlahoda (Reviewer).

PR Review: https://git.openjdk.org/jdk/pull/22227#pullrequestreview-2445601903
PR Review Comment: https://git.openjdk.org/jdk/pull/22227#discussion_r1848441801