diff -r c5afcee4ff51 -r a5538163e144 jdk/src/java.naming/share/classes/javax/naming/NamingException.java --- a/jdk/src/java.naming/share/classes/javax/naming/NamingException.java Tue Aug 04 22:02:12 2015 -0700 +++ b/jdk/src/java.naming/share/classes/javax/naming/NamingException.java Wed Aug 05 13:40:18 2015 +0300 @@ -194,14 +194,14 @@ /** * Sets the resolved name field of this exception. *

- * name is a composite name. If the intent is to set + * {@code name} is a composite name. If the intent is to set * this field using a compound name or string, you must * "stringify" the compound name, and create a composite * name with a single component using the string. You can then * invoke this method using the resulting composite name. *

- * A copy of name is made and stored. - * Subsequent changes to name do not + * A copy of {@code name} is made and stored. + * Subsequent changes to {@code name} do not * affect the copy in this NamingException and vice versa. * * @param name The possibly null name to set resolved name to. @@ -218,14 +218,14 @@ /** * Sets the remaining name field of this exception. *

- * name is a composite name. If the intent is to set + * {@code name} is a composite name. If the intent is to set * this field using a compound name or string, you must * "stringify" the compound name, and create a composite * name with a single component using the string. You can then * invoke this method using the resulting composite name. *

- * A copy of name is made and stored. - * Subsequent changes to name do not + * A copy of {@code name} is made and stored. + * Subsequent changes to {@code name} do not * affect the copy in this NamingException and vice versa. * @param name The possibly null name to set remaining name to. * If null, it sets the remaining name field to null. @@ -275,11 +275,11 @@ * Add components from 'name' as the last components in * remaining name. *

- * name is a composite name. If the intent is to append + * {@code name} is a composite name. If the intent is to append * a compound name, you should "stringify" the compound name * then invoke the overloaded form that accepts a String parameter. *

- * Subsequent changes to name do not + * Subsequent changes to {@code name} do not * affect the remaining name field in this NamingException and vice versa. * @param name The possibly null name containing ordered components to add. * If name is null, this method does not do anything. @@ -326,7 +326,7 @@ /** * Records the root cause of this NamingException. - * If e is this, this method does not do anything. + * If {@code e} is {@code this}, this method does not do anything. *

* This method predates the general-purpose exception chaining facility. * The {@link #initCause(Throwable)} method is now the preferred means @@ -348,10 +348,10 @@ /** * Returns the cause of this exception. The cause is the * throwable that caused this naming exception to be thrown. - * Returns null if the cause is nonexistent or + * Returns {@code null} if the cause is nonexistent or * unknown. * - * @return the cause of this exception, or null if the + * @return the cause of this exception, or {@code null} if the * cause is nonexistent or unknown. * @see #initCause(Throwable) * @since 1.4 @@ -368,10 +368,10 @@ * This method may be called at most once. * * @param cause the cause, which is saved for later retrieval by - * the {@link #getCause()} method. A null value + * the {@link #getCause()} method. A {@code null} value * indicates that the cause is nonexistent or unknown. - * @return a reference to this NamingException instance. - * @throws IllegalArgumentException if cause is this + * @return a reference to this {@code NamingException} instance. + * @throws IllegalArgumentException if {@code cause} is this * exception. (A throwable cannot be its own cause.) * @throws IllegalStateException if this method has already * been called on this exception.