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

[Joe Darcy]

On Tue, 19 Nov 2024 14:13:19 GMT, Jan Lahoda <jlahoda at openjdk.org> wrote:

>> Joe Darcy has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Respond to review feedback.
>
> 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.)

Thanks Jan; looking over the whole documentation for `-proc`, decided to format the information as a bulleted list instead. I think that better captures the intent anyway.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/22227#discussion_r1848701187