archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-26 22:34:27 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8341100: Add index entries for terms used in java.lang.Class

Browse source 
Reviewed-by: liach
This commit is contained in:
Joe Darcy 2024-09-30 16:10:02 +00:00
parent f1bf469b4e
commit 4168faf54c
1 changed files with 8 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

15
src/java.base/share/classes/java/lang/Class.java
View file

@ -140,22 +140,24 @@ import sun.reflect.misc.ReflectUtil;
* }}
*
* It is also possible to get the {@code Class} object for a named
* class or interface (or for {@code void}) using a <i>class literal</i>.
* class or interface (or for {@code void}) using a <dfn>class literal</dfn>
* (JLS {@jls 15.8.2}).
* For example:
*
* {@snippet lang="java" :
* System.out.println("The name of class Foo is: "+Foo.class.getName());
* System.out.println("The name of class Foo is: " + Foo.class.getName()); // @highlight substring="Foo.class"
* }
*
* <p> Some methods of class {@code Class} expose whether the declaration of
* a class or interface in Java source code was <em>enclosed</em> within
* another declaration. Other methods describe how a class or interface
* is situated in a <em>nest</em>. A <a id="nest">nest</a> is a set of
* is situated in a <dfn>{@index "nest"}</dfn>. A <a id="nest">nest</a> is a set of
* classes and interfaces, in the same run-time package, that
* allow mutual access to their {@code private} members.
* The classes and interfaces are known as <em>nestmates</em>.
* The classes and interfaces are known as <dfn>{@index "nestmates"}</dfn>
* (JVMS {@jvms 4.7.29}).
* One nestmate acts as the
* <em>nest host</em>, and enumerates the other nestmates which
* <dfn>nest host</dfn> (JVMS {@jvms 4.7.28}), and enumerates the other nestmates which
* belong to the nest; each of them in turn records it as the nest host.
* The classes and interfaces which belong to a nest, including its host, are
* determined when
@ -167,7 +169,7 @@ import sun.reflect.misc.ReflectUtil;
* <h2><a id=hiddenClasses>Hidden Classes</a></h2>
* A class or interface created by the invocation of
* {@link java.lang.invoke.MethodHandles.Lookup#defineHiddenClass(byte[], boolean, MethodHandles.Lookup.ClassOption...)
* Lookup::defineHiddenClass} is a {@linkplain Class#isHidden() <em>hidden</em>}
* Lookup::defineHiddenClass} is a {@linkplain Class#isHidden() <dfn>hidden</dfn>}
* class or interface.
* All kinds of class, including enum classes and record classes, may be
* hidden classes; all kinds of interface, including annotation interfaces,
@ -216,7 +218,6 @@ import sun.reflect.misc.ReflectUtil;
*
* @see java.lang.ClassLoader#defineClass(byte[], int, int)
* @since 1.0
* @jls 15.8.2 Class Literals
*/
public final class Class<T> implements java.io.Serializable,
GenericDeclaration,