RFR: 8339696: Clarify modeling scope of javax.lang.model.element [v2]

[Jonathan Gibbons]

On Mon, 9 Sep 2024 15:09:40 GMT, Joe Darcy <darcy at openjdk.org> wrote:

>> Clarify that while javax.lang.model does not include an AST API, it is intended to be usable by an AST API.
>
> Joe Darcy has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Reflow paragraph.

src/java.compiler/share/classes/javax/lang/model/element/package-info.java line 35:

> 33:  * program inside a method body; for example there is no
> 34:  * representation of a {@code for} loop or {@code try}-{@code finally}
> 35:  * block. Concretely, there is no model of the abstract syntax tree

I suggest changing `the` (definite article) to something less definite, like `any`.
This would then correspond to the grammar on line 41 "an AST API"

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

PR Review Comment: https://git.openjdk.org/jdk/pull/20900#discussion_r1750793727