RFR: 8257639: Update usage of "type" terminology in java.lang.Enum & java.lang.Record

Daniel Fuchs dfuchs at openjdk.java.net
Tue Dec 8 13:46:17 UTC 2020


On Tue, 8 Dec 2020 10:41:06 GMT, Julia Boes <jboes at openjdk.org> wrote:

>> src/java.base/share/classes/java/lang/Enum.java line 62:
>> 
>>> 60:  * java.util.EnumMap map} implementations are available.
>>> 61:  *
>>> 62:  * @param <E> The enum class subclass
>> 
>> I wonder about this one, given that `<E>` is a type. It sounds strange to me - even though I understand that what is meant is that this type should point to a class (a subclass of `java.lang.Enum`).
>
> Makes sense. I suggest the following instead: `The type of enum subclass`.

Maybe: "`The type of the enum subclass.`" would sound better - or just "`The enum subclass`".

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

PR: https://git.openjdk.java.net/jdk/pull/1670


More information about the core-libs-dev mailing list