Skip to content

Commit

Permalink
8341100: Add index entries for terms used in java.lang.Class
Browse files Browse the repository at this point in the history
Reviewed-by: liach
  • Loading branch information
jddarcy committed Sep 30, 2024
1 parent f1bf469 commit 4168faf
Showing 1 changed file with 8 additions and 7 deletions.
15 changes: 8 additions & 7 deletions src/java.base/share/classes/java/lang/Class.java
Original file line number Diff line number Diff line change
Expand Up @@ -140,22 +140,24 @@
* }}
*
* 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
Expand All @@ -167,7 +169,7 @@
* <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,
Expand Down Expand Up @@ -216,7 +218,6 @@
*
* @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,
Expand Down

1 comment on commit 4168faf

@openjdk-notifier
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please sign in to comment.