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.