--- old/src/java.naming/share/classes/javax/naming/InitialContext.java 2015-08-04 13:14:27.756900243 +0300 +++ new/src/java.naming/share/classes/javax/naming/InitialContext.java 2015-08-04 13:14:27.300900233 +0300 @@ -49,13 +49,13 @@ * The first occurrence of the property from the constructor's * environment parameter and system properties. *
- * When a URL string (a String of the form + * When a URL string (a {@code String} of the form * scheme_id:rest_of_name) is passed as a name parameter to * any method, a URL context factory for handling that scheme is * located and used to resolve the URL. If no such factory is found, * the initial context specified by - * "java.naming.factory.initial" is used. Similarly, when a - * CompositeName object whose first component is a URL string is + * {@code "java.naming.factory.initial"} is used. Similarly, when a + * {@code CompositeName} object whose first component is a URL string is * passed as a name parameter to any method, a URL context factory is * located and used to resolve the first name component. * See {@link NamingManager#getURLContext - * NamingManager.getURLContext()} for a description of how URL + * NamingManager.getURLContext()} for a description of how URL * context factories are located. *
* This default policy of locating the initial context and URL context * factories may be overridden * by calling - * NamingManager.setInitialContextFactoryBuilder(). + * {@code NamingManager.setInitialContextFactoryBuilder()}. *
* NoInitialContextException is thrown when an initial context cannot * be instantiated. This exception can be thrown during any interaction @@ -125,7 +125,7 @@ /** * The environment associated with this InitialContext. * It is initialized to null and is updated by the constructor - * that accepts an environment or by the init() method. + * that accepts an environment or by the {@code init()} method. * @see #addToEnvironment * @see #removeFromEnvironment * @see #getEnvironment @@ -152,14 +152,14 @@ * Constructs an initial context with the option of not * initializing it. This may be used by a constructor in * a subclass when the value of the environment parameter - * is not yet known at the time the InitialContext + * is not yet known at the time the {@code InitialContext} * constructor is called. The subclass's constructor will * call this constructor, compute the value of the environment, - * and then call init() before returning. + * and then call {@code init()} before returning. * * @param lazy * true means do not initialize the initial context; false - * is equivalent to calling new InitialContext() + * is equivalent to calling {@code new InitialContext()} * @throws NamingException if a naming exception is encountered * * @see #init(Hashtable) @@ -174,7 +174,7 @@ /** * Constructs an initial context. * No environment properties are supplied. - * Equivalent to new InitialContext(null). + * Equivalent to {@code new InitialContext(null)}. * * @throws NamingException if a naming exception is encountered * @@ -188,10 +188,10 @@ * Constructs an initial context using the supplied environment. * Environment properties are discussed in the class description. * - *
This constructor will not modify environment + *
This constructor will not modify {@code environment} * or save a reference to it, but may save a clone. * Caller should not modify mutable keys and values in - * environment after it has been passed to the constructor. + * {@code environment} after it has been passed to the constructor. * * @param environment * environment used to create the initial context. @@ -212,7 +212,7 @@ * Initializes the initial context using the supplied environment. * Environment properties are discussed in the class description. * - *
This method will modify environment and save + *
This method will modify {@code environment} and save * a reference to it. The caller may no longer modify it. * * @param environment @@ -245,7 +245,7 @@ * InitialContext ic = new InitialContext(); * Object obj = ic.lookup(); * - *
If name is empty, returns a new instance of this context + *
If {@code name} is empty, returns a new instance of this context
* (which represents the same naming context as this context, but its
* environment may be modified independently and it may be accessed
* concurrently).
@@ -253,7 +253,7 @@
* @param