JDK-8321417 : Add -proc:full to describe current default annotation processing policy
  • Type: CSR
  • Component: tools
  • Sub-Component: javac
  • Priority: P4
  • Status: Closed
  • Resolution: Approved
  • Fix Versions: 8-pool,11-pool,17-pool
  • Submitted: 2023-12-05
  • Updated: 2024-01-08
  • Resolved: 2024-01-08
Related Reports
CSR :  
CSR :  
CSR :  
Relates :  
Description
Summary
-------

Add `-proc:full` to explicitly specify both annotation processing and compilation are requested of `javac`. (This is currently the default policy.) No changes from original CSR JDK-8308346.

Problem
-------

The default policy for annotation processing does not have a value for the `-proc` option.

Solution
--------

Add `-proc:full` as a third recognized option, alongside `-proc:none` and `-proc:only`.

Specification
-------------

The `-help` output of `javac` will mention the new alternative:

      -proc:{none,only,full}
            Control whether annotation processing and/or compilation is done.

and the `javac` "manpage" will be updated similar to:

    -`-proc:`\[`none`, `only`\]
    +`-proc:`\[`none`, `only`, `full`\]
     :   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,
    -    without any subsequent compilation.
    +    without any subsequent compilation. `-proc:full` means that annotation
    +    processing is done with subsequent compilation.



Comments
Moving to Approved.
08-01-2024