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

8339696: Clarify modeling scope of javax.lang.model.element

Browse Source 
Reviewed-by: jjg, jlahoda, prappo
This commit is contained in:
Joe Darcy 2024-09-09 19:24:33 +00:00
parent 77468c284c
commit 6b5958d661
1 changed files with 10 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
src/java.compiler/share/classes/javax/lang/model/element/package-info.java
View File

@ -1,5 +1,5 @@
/*
* Copyright (c) 2005, 2023, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2005, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -32,9 +32,15 @@
* The interfaces in this package do not model the structure of a
* program inside a method body; for example there is no
* representation of a {@code for} loop or {@code try}-{@code finally}
* block. However, the interfaces can model some structures only
* appearing inside method bodies, such as local variables and
* anonymous classes.
* block. Concretely, there is no model of any abstract syntax tree
* (AST) structure of a Java program. However, the interfaces can
* model some structures only appearing inside method bodies, such as
* {@linkplain ElementKind#LOCAL_VARIABLE local variables},
* {@linkplain NestingKind#ANONYMOUS anonymous classes}, and
* {@linkplain ElementKind#EXCEPTION_PARAMETER exception parameters}.
* Therefore, these interfaces can be used by an AST API to model the
* declarations found in the method bodies of Java compilation units
* (JLS {@jls 7.3}).
*
* <p id="accurate_model">When used in the context of annotation
* processing, an accurate model of the element being represented must