stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
Reviewed-by: jlahoda
This commit is contained in:
Joe Darcy 2024-11-20 00:06:24 +00:00
parent acdbf83325
commit f525290000
1 changed files with 33 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
src/jdk.compiler/share/man/javac.md
View File

@ -1,5 +1,5 @@
--- ---
# Copyright (c) 1994, 2023, Oracle and/or its affiliates. All rights reserved. # Copyright (c) 1994, 2024, Oracle and/or its affiliates. All rights reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
# #
# This code is free software; you can redistribute it and/or modify it # This code is free software; you can redistribute it and/or modify it
@ -336,10 +336,18 @@ file system locations may be directories, JAR files or JMOD files.
<a id="option-proc">`-proc:`\[`none`, `only`, `full`\]</a> <a id="option-proc">`-proc:`\[`none`, `only`, `full`\]</a>
: Controls whether annotation processing and compilation are done. : Controls whether annotation processing and compilation are done.
`-proc:none` means that compilation takes place without annotation
processing. `-proc:only` means that only annotation processing is done, - `-proc:none` means that compilation takes place without annotation
without any subsequent compilation. If this option is not used, or processing
`-proc:full` is specified, annotation processing and compilation are done.
- `-proc:only` means that only annotation processing is done,
without any subsequent compilation.
- `-proc:full` means annotation processing and compilation are done.
If this option is not used, annotation processing and compilation
are done if at least one other option is used to explicitly
configure annotation processing.
<a id="option-processor">`-processor` *class1*\[`,`*class2*`,`*class3*...\]</a> <a id="option-processor">`-processor` *class1*\[`,`*class2*`,`*class3*...\]</a>
: Names of the annotation processors to run. This bypasses the default : Names of the annotation processors to run. This bypasses the default
@ -1427,15 +1435,26 @@ The API for annotation processors is defined in the
### How Annotation Processing Works ### How Annotation Processing Works
Unless annotation processing is disabled with the [`-proc:none`](#option-proc) option, the Annotation processing is requested by using an option to configure
compiler searches for any annotation processors that are available. The search annotation processing, such as [`-processor`](#option-processor),
path can be specified with the [`-processorpath`](#option-processor-path) option. If no path is [`--processor-path`](#option-processor-path),
specified, then the user class path is used. Processors are located by means of [`--processor-module-path`](#option-processor-module-path) or by
service provider-configuration files named explicitly enabling processing with the [`-proc:full`](#option-proc)
`META-INF/services/javax.annotation.processing.Processor` on the search path. or [`-proc:only`](#option-proc) options. Annotation processing is
Such files should contain the names of any annotation processors to be used, disabled using the [`-proc:none`](#option-proc) option.
listed one per line. Alternatively, processors can be specified explicitly,
using the [`-processor`](#option-processor) option. If annotation processing is requested, the compiler searches for any
annotation processors that are available.
The search path can be specified with the
[`-processorpath`](#option-processor-path) option. If no path is
specified, then the user class path is used. Processors are located by
means of service provider-configuration files named
`META-INF/services/javax.annotation.processing.Processor` on the
search path. Such files should contain the names of any
annotationation processors to be used, listed one per
line. Alternatively, processors can be specified explicitly, using the
[`-processor`](#option-processor) option.
After scanning the source files and classes on the command line to determine After scanning the source files and classes on the command line to determine
what annotations are present, the compiler queries the processors to determine what annotations are present, the compiler queries the processors to determine