--- 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. *
  • - * The application resource files (jndi.properties). + * The application resource files ({@code jndi.properties}). * * For each property found in both of these two sources, or in * more than one application resource file, the property's value * is determined as follows. If the property is * one of the standard JNDI properties that specify a list of JNDI - * factories (see Context), + * factories (see {@code Context}), * all of the values are * concatenated into a single colon-separated list. For other * properties, only the first value found is used. @@ -68,23 +68,23 @@ * An exception to this policy is made when resolving URL strings, as described * below. *

    - * 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 the type of the returned object * @param name * the name of the object to look up - * @return the object bound to name + * @return the object bound to {@code name} * @throws NamingException if a naming exception is encountered * * @see #doLookup(String) @@ -272,7 +272,7 @@ * @param the type of the returned object * @param name * the name of the object to look up - * @return the object bound to name + * @return the object bound to {@code name} * @throws NamingException if a naming exception is encountered * @since 1.6 */ @@ -506,7 +506,7 @@ * this context. * Since an initial context may never be named relative * to any context other than itself, the value of the - * prefix parameter must be an empty name (""). + * {@code prefix} parameter must be an empty name ({@code ""}). */ public String composeName(String name, String prefix) throws NamingException { @@ -518,7 +518,7 @@ * this context. * Since an initial context may never be named relative * to any context other than itself, the value of the - * prefix parameter must be an empty name. + * {@code prefix} parameter must be an empty name. */ public Name composeName(Name name, Name prefix) throws NamingException