On Sun, 18 Jun 2023 18:36:28 GMT, Jens Lidestrom <d...@openjdk.org> wrote:
>> Mandy Chung has updated the pull request incrementally with one additional >> commit since the last revision: >> >> missing 'L' for the array class name > > src/java.base/share/classes/java/lang/Class.java line 395: > >> 393: * attached thread), the system class loader is used. >> 394: * >> 395: * @param className the <a href="#binary-name">binary name</a> >> of the class > > The new text is probably more correct, but it is less easy to understand. I > think "fully qualified name" of a class is a well-known term, but "binary > name" is rather unknown. > > I suggest changing the text to mention both terms. For example like this: > > Suggestion: > > * @param className the <a href="#binary-name">binary name</a>) of > the class, for example its fully qualified name Binary name is defined in JLS. Fully qualified name is ambiguous as it may refer to the internal name or a descriptor string. ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/14528#discussion_r1233401865