RFR: 8341483: Clarify special case handling of Types.getArrayType

[Pavel Rappo]

On Fri, 4 Oct 2024 04:10:20 GMT, Joe Darcy <darcy at openjdk.org> wrote:

> Add specification and tests for invalid inputs to getArrayType that generation an exception. As initially written, this PR changes the behavior on NONE and the null type.

src/java.compiler/share/classes/javax/lang/model/util/Types.java line 268:

> 266:      *          an array. All valid types are {@linkplain ReferenceType
> 267:      *          reference types} or {@linkplain PrimitiveType primitive types}.
> 268:      *          Invalid types include null, executable, package, module, and wildcard types.

Should it be somehow more clear that it's not `null`, but the __Null Type__. Maybe you can link to it as follows?

    {@linkplain NullType null}

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

PR Review Comment: https://git.openjdk.org/jdk/pull/21346#discussion_r1788122949