RFR: 8374658: Consider use of "included" rather than "enclosed" in jx.a.p.Processor

[Joe Darcy]

On Wed, 7 Jan 2026 03:46:46 GMT, Joe Darcy <darcy at openjdk.org> wrote:

> The use of "enclosed" in javax.annotation.processing.Processor looks to be using a more colloquial definition than the JLS-eque notion of "enclosed" used in parts of the javax.lang.model API.
> 
> Instead, this PR proposes to switch from "enclosed" to "included," a term already used in RoundEnvironment for the concept in question.

src/java.compiler/share/classes/javax/annotation/processing/Processor.java line 105:

> 103:  * For a given round, the tool computes the set of annotation
> 104:  * interfaces that are present on the elements {@linkplain RoundEnvironment#getElementsAnnotatedWith(TypeElement) included} within the
> 105:  * root elements.  If there is at least one annotation interface

I'll re-flow the paragraph once the wording is agree to; n the initial iteration I wanted to make clear what exactly was changing -- replacing "enclosed" with a link to a method implementing the "included" definition.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/29076#discussion_r2667063717