--- old/src/java.naming/share/classes/javax/naming/ReferralException.java 2015-08-04 13:14:34.656900397 +0300 +++ new/src/java.naming/share/classes/javax/naming/ReferralException.java 2015-08-04 13:14:34.364900390 +0300 @@ -33,12 +33,12 @@ * such as that returned by LDAP v3 servers. *
* A service provider provides - * a subclass of ReferralException by providing implementations - * for getReferralInfo() and getReferralContext() (and appropriate + * a subclass of {@code ReferralException} by providing implementations + * for {@code getReferralInfo()} and {@code getReferralContext()} (and appropriate * constructors and/or corresponding "set" methods). *
- * The following code sample shows how ReferralException can be used. - *
{@code + * The following code sample shows how {@code ReferralException} can be used. + **+ * }{@code * while (true) { * try { * bindings = ctx.listBindings(name); @@ -51,12 +51,12 @@ * ctx = e.getReferralContext(); * } * } - * }
- * ReferralException is an abstract class. Concrete implementations + * {@code ReferralException} is an abstract class. Concrete implementations * determine its synchronization and serialization properties. *
- * An environment parameter passed to the getReferralContext() + * An environment parameter passed to the {@code getReferralContext()} * method is owned by the caller. * The service provider will not modify the object or keep a reference to it, * but may keep a reference to a clone of it. @@ -114,7 +114,7 @@ * * @return The non-null context at which to continue the method. * @exception NamingException If a naming exception was encountered. - * Call either retryReferral() or skipReferral() + * Call either {@code retryReferral()} or {@code skipReferral()} * to continue processing referrals. */ public abstract Context getReferralContext() throws NamingException; @@ -127,7 +127,7 @@ * enumeration, the referral exception should provide a context * at which to continue the operation. *
- * The referral context is created using env as its environment
+ * The referral context is created using {@code env} as its environment
* properties.
* This method should be used instead of the no-arg overloaded form
* when the caller needs to use different environment properties for
@@ -143,7 +143,7 @@
*
* @return The non-null context at which to continue the method.
* @exception NamingException If a naming exception was encountered.
- * Call either retryReferral() or skipReferral()
+ * Call either {@code retryReferral()} or {@code skipReferral()}
* to continue processing referrals.
*/
public abstract Context
@@ -153,10 +153,10 @@
/**
* Discards the referral about to be processed.
* A call to this method should be followed by a call to
- * getReferralContext
to allow the processing of
+ * {@code getReferralContext} to allow the processing of
* other referrals to continue.
* The following code fragment shows a typical usage pattern.
- *
* * @return true If more referral processing is pending; false otherwise. */ @@ -174,10 +174,10 @@ /** * Retries the referral currently being processed. * A call to this method should be followed by a call to - *+ *+ * }{@code * } catch (ReferralException e) { * if (!shallIFollow(e.getReferralInfo())) { * if (!e.skipReferral()) { @@ -165,7 +165,7 @@ * } * ctx = e.getReferralContext(); * } - *
getReferralContext
to allow the current
+ * {@code getReferralContext} to allow the current
* referral to be retried.
* The following code fragment shows a typical usage pattern.
- * * */ public abstract void retryReferral();+ *+ * }{@code * } catch (ReferralException e) { * while (true) { * try { @@ -192,7 +192,7 @@ * } * } * } - *