--- old/src/java.naming/share/classes/javax/naming/ldap/ControlFactory.java 2015-08-04 13:14:53.392900814 +0300 +++ new/src/java.naming/share/classes/javax/naming/ldap/ControlFactory.java 2015-08-04 13:14:53.068900806 +0300 @@ -65,7 +65,7 @@ * Without this mechanism, the provider would be returning * controls that only contained data in BER encoded format. *
- * Typically, ctl is a "basic" control containing + * Typically, {@code ctl} is a "basic" control containing * BER encoded data. The factory is used to create a specialized * control implementation, usually by decoding the BER encoded data, * that provides methods to access that data in a type-safe and friendly @@ -80,14 +80,14 @@ * it is the only intended factory and that no other control factories * should be tried. This might happen, for example, if the BER data * in the control does not match what is expected of a control with - * the given OID. Since this method throws NamingException, + * the given OID. Since this method throws {@code NamingException}, * any other internally generated exception that should be propagated - * must be wrapped inside a NamingException. + * must be wrapped inside a {@code NamingException}. * * @param ctl A non-null control. * * @return A possibly null Control. - * @exception NamingException If ctl contains invalid data that prevents it + * @exception NamingException If {@code ctl} contains invalid data that prevents it * from being used to create a control. A factory should only throw * an exception if it knows how to produce the control (identified by the OID) * but is unable to because of, for example invalid BER data. @@ -100,14 +100,14 @@ * The following rule is used to create the control: *
ctl
.
+ * return {@code ctl}.
* If an exception is encountered while creating the control, the
* exception is passed up to the caller.
*ctl
; or
- * ctl
if a control object cannot be created using
+ * to find the value of the {@code LdapContext.CONTROL_FACTORIES} property.
+ * @return A control object created using {@code ctl}; or
+ * {@code ctl} if a control object cannot be created using
* the algorithm described above.
* @exception NamingException if a naming exception was encountered
* while attempting to create the control object.
@@ -129,7 +129,7 @@
* exception, it is propagated up to the caller.
* If an error was encountered while loading
* and instantiating the factory and object classes, the exception
- * is wrapped inside a NamingException and then rethrown.
+ * is wrapped inside a {@code NamingException} and then rethrown.
*/
public static Control getControlInstance(Control ctl, Context ctx,
Hashtable,?> env)