--- old/src/java.base/share/classes/java/lang/Class.java	2018-05-22 05:25:44.886850513 -0400
+++ new/src/java.base/share/classes/java/lang/Class.java	2018-05-22 05:25:43.398764449 -0400
@@ -3854,8 +3854,8 @@
     /**
      * Returns the nest host of the object represented by this {@code Class}.
      *
-     * <p>If there is any error accessing the nest host, or the nest host is
-     * in any way invalid, then {@code this} is returned.
+     * <p>If there is any {@linkplain LinkageError linkage error} accessing the nest host,
+     * or the nest host is in any way invalid, then {@code this} is returned.
      *
      * <p>A <em>nest</em> is a set of classes and interfaces (nestmates) that
      * form an access control context in which each nestmate has access to the
@@ -3863,8 +3863,10 @@
      * The <em>nest host</em> is the class or interface designated to hold the list of
      * classes and interfaces that make up the nest, and to which each of the
      * other nestmates refer.
+     * All nestmates are implicitly defined in the same runtime package.
      *
-     * <p>A class or interface that is not explicitly a member of a nest,
+     * <p>A class or interface that is not explicitly a member of a nest
+     * (such as a primitive or array class),
      * is a member of the nest consisting only of itself, and is the
      * nest host. Every class and interface is a member of exactly one nest.
      *
@@ -3878,8 +3880,8 @@
      * The top-level {@linkplain #getEnclosingClass() enclosing class or interface}
      * is designated as the nest host.
      *
-     * @return the nest host of this class, or {@code this} if we cannot
-     * obtain a valid nest host
+     * @return the nest host of this class, or {@code this} if a valid nest host
+     * cannot be obtained
      * @throws SecurityException
      *         If the returned class is not the current class, and
      *         if a security manager, <i>s</i>, is present and the caller's
@@ -3920,7 +3922,7 @@
     /**
      * Determines if the given {@code Class} is a nestmate of the
      * object represented by this {@code Class}. Two classes are nestmates
-     * if they have the same {@linkplain #getNestHost nest host}.
+     * if they have the same {@linkplain #getNestHost() nest host}.
      *
      * @param  c the class to check
      * @return {@code true} if this class and {@code c} are valid members of the same