--- old/src/java.base/share/classes/java/util/Locale.java 2015-09-24 14:38:11.117755626 +0300 +++ new/src/java.base/share/classes/java/util/Locale.java 2015-09-24 14:38:10.713755635 +0300 @@ -825,7 +825,7 @@ * setDefault(Locale.Category, Locale) method. * * @param category - the specified category to get the default locale - * @throws NullPointerException - if category is null + * @throws NullPointerException if category is null * @return the default locale for the specified Category for this instance * of the Java Virtual Machine * @see #setDefault(Locale.Category, Locale) @@ -954,9 +954,9 @@ * * @param category - the specified category to set the default locale * @param newLocale - the new default locale - * @throws SecurityException - if a security manager exists and its + * @throws SecurityException if a security manager exists and its * checkPermission method doesn't allow the operation. - * @throws NullPointerException - if category and/or newLocale is null + * @throws NullPointerException if category and/or newLocale is null * @see SecurityManager#checkPermission(java.security.Permission) * @see PropertyPermission * @see #getDefault(Locale.Category) --- old/src/java.base/share/classes/sun/reflect/generics/factory/CoreReflectionFactory.java 2015-09-24 14:38:12.297755601 +0300 +++ new/src/java.base/share/classes/sun/reflect/generics/factory/CoreReflectionFactory.java 2015-09-24 14:38:11.805755611 +0300 @@ -70,20 +70,20 @@ /** * Factory for this class. Returns an instance of - * CoreReflectionFactory for the declaration and scope + * {@code CoreReflectionFactory} for the declaration and scope * provided. * This factory will produce reflective objects of the appropriate * kind. Classes produced will be those that would be loaded by the - * defining class loader of the declaration d (if d + * defining class loader of the declaration {@code d} (if {@code d} * is a type declaration, or by the defining loader of the declaring - * class of d otherwise. + * class of {@code d} otherwise. *

Type variables will be created or lookup as necessary in the - * scope s. + * scope {@code s}. * @param d - the generic declaration (class, interface, method or * constructor) that this factory services * @param s the scope in which the factory will allocate and search for * type variables - * @return an instance of CoreReflectionFactory + * @return an instance of {@code CoreReflectionFactory} */ public static CoreReflectionFactory make(GenericDeclaration d, Scope s) { return new CoreReflectionFactory(d, s); --- old/src/java.base/share/classes/sun/reflect/generics/factory/GenericsFactory.java 2015-09-24 14:38:13.341755578 +0300 +++ new/src/java.base/share/classes/sun/reflect/generics/factory/GenericsFactory.java 2015-09-24 14:38:12.921755587 +0300 @@ -47,32 +47,32 @@ */ public interface GenericsFactory { /** - * Returns a new type variable declaration. Note that name - * may be empty (but not null). If bounds is - * empty, a bound of java.lang.Object is used. + * Returns a new type variable declaration. Note that {@code name} + * may be empty (but not {@code null}). If {@code bounds} is + * empty, a bound of {@code java.lang.Object} is used. * @param name The name of the type variable * @param bounds An array of abstract syntax trees representing * the upper bound(s) on the type variable being declared * @return a new type variable declaration - * @throws NullPointerException - if any of the actual parameters - * or any of the elements of bounds are null. + * @throws NullPointerException if any of the actual parameters + * or any of the elements of {@code bounds} are {@code null}. */ TypeVariable makeTypeVariable(String name, FieldTypeSignature[] bounds); /** - * Returns an instance of the ParameterizedType interface + * Returns an instance of the {@code ParameterizedType} interface * that corresponds to a generic type instantiation of the - * generic declaration declaration with actual type arguments - * typeArgs. - * If owner is null, the declaring class of - * declaration is used as the owner of this parameterized + * generic declaration {@code declaration} with actual type arguments + * {@code typeArgs}. + * If {@code owner} is {@code null}, the declaring class of + * {@code declaration} is used as the owner of this parameterized * type. *

This method throws a MalformedParameterizedTypeException * under the following circumstances: * If the type declaration does not represent a generic declaration - * (i.e., it is not an instance of GenericDeclaration). + * (i.e., it is not an instance of {@code GenericDeclaration}). * If the number of actual type arguments (i.e., the size of the - * array typeArgs) does not correspond to the number of + * array {@code typeArgs}) does not correspond to the number of * formal type arguments. * If any of the actual type arguments is not an instance of the * bounds on the corresponding formal. @@ -81,39 +81,39 @@ * @param typeArgs - the list of actual type arguments * @return - a parameterized type representing the instantiation * of the declaration with the actual type arguments - * @throws MalformedParameterizedTypeException - if the instantiation + * @throws MalformedParameterizedTypeException if the instantiation * is invalid - * @throws NullPointerException - if any of declaration - * , typeArgs - * or any of the elements of typeArgs are null + * @throws NullPointerException if any of {@code declaration}, + * {@code typeArgs} + * or any of the elements of {@code typeArgs} are {@code null} */ ParameterizedType makeParameterizedType(Type declaration, Type[] typeArgs, Type owner); /** - * Returns the type variable with name name, if such + * Returns the type variable with name {@code name}, if such * a type variable is declared in the * scope used to create this factory. - * Returns null otherwise. + * Returns {@code null} otherwise. * @param name - the name of the type variable to search for - * @return - the type variable with name name, or null - * @throws NullPointerException - if any of actual parameters are - * null + * @return - the type variable with name {@code name}, or {@code null} + * @throws NullPointerException if any of actual parameters are + * {@code null} */ TypeVariable findTypeVariable(String name); /** * Returns a new wildcard type variable. If - * ubs is empty, a bound of java.lang.Object is used. + * {@code ubs} is empty, a bound of {@code java.lang.Object} is used. * @param ubs An array of abstract syntax trees representing * the upper bound(s) on the type variable being declared * @param lbs An array of abstract syntax trees representing * the lower bound(s) on the type variable being declared * @return a new wildcard type variable - * @throws NullPointerException - if any of the actual parameters - * or any of the elements of ubs or lbsare - * null + * @throws NullPointerException if any of the actual parameters + * or any of the elements of {@code ubs} or {@code lbs} are + * {@code null} */ WildcardType makeWildcard(FieldTypeSignature[] ubs, FieldTypeSignature[] lbs); @@ -127,64 +127,64 @@ * a MalformedParameterizedTypeException is thrown. * @param componentType - the component type of the array * @return a (possibly generic) array type. - * @throws MalformedParameterizedTypeException if componentType + * @throws MalformedParameterizedTypeException if {@code componentType} * is a parameterized type with non-wildcard type arguments - * @throws NullPointerException - if any of the actual parameters - * are null + * @throws NullPointerException if any of the actual parameters + * are {@code null} */ Type makeArrayType(Type componentType); /** - * Returns the reflective representation of type byte. - * @return the reflective representation of type byte. + * Returns the reflective representation of type {@code byte}. + * @return the reflective representation of type {@code byte}. */ Type makeByte(); /** - * Returns the reflective representation of type boolean. - * @return the reflective representation of type boolean. + * Returns the reflective representation of type {@code boolean}. + * @return the reflective representation of type {@code boolean}. */ Type makeBool(); /** - * Returns the reflective representation of type short. - * @return the reflective representation of type short. + * Returns the reflective representation of type {@code short}. + * @return the reflective representation of type {@code short}. */ Type makeShort(); /** - * Returns the reflective representation of type char. - * @return the reflective representation of type char. + * Returns the reflective representation of type {@code char}. + * @return the reflective representation of type {@code char}. */ Type makeChar(); /** - * Returns the reflective representation of type int. - * @return the reflective representation of type int. + * Returns the reflective representation of type {@code int}. + * @return the reflective representation of type {@code int}. */ Type makeInt(); /** - * Returns the reflective representation of type long. - * @return the reflective representation of type long. + * Returns the reflective representation of type {@code long}. + * @return the reflective representation of type {@code long}. */ Type makeLong(); /** - * Returns the reflective representation of type float. - * @return the reflective representation of type float. + * Returns the reflective representation of type {@code float}. + * @return the reflective representation of type {@code float}. */ Type makeFloat(); /** - * Returns the reflective representation of type double. - * @return the reflective representation of type double. + * Returns the reflective representation of type {@code double}. + * @return the reflective representation of type {@code double}. */ Type makeDouble(); /** - * Returns the reflective representation of void. - * @return the reflective representation of void. + * Returns the reflective representation of {@code void}. + * @return the reflective representation of {@code void}. */ Type makeVoid(); } --- old/src/java.base/share/classes/sun/reflect/generics/parser/SignatureParser.java 2015-09-24 14:38:14.169755560 +0300 +++ new/src/java.base/share/classes/sun/reflect/generics/parser/SignatureParser.java 2015-09-24 14:38:13.833755567 +0300 @@ -135,7 +135,7 @@ /** * Static factory method. Produces a parser instance. - * @return an instance of SignatureParser + * @return an instance of {@code SignatureParser} */ public static SignatureParser make() { return new SignatureParser(); --- old/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/GenericArrayTypeImpl.java 2015-09-24 14:38:15.281755536 +0300 +++ new/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/GenericArrayTypeImpl.java 2015-09-24 14:38:14.805755546 +0300 @@ -53,10 +53,10 @@ /** - * Returns a Type object representing the component type + * Returns a {@code Type} object representing the component type * of this array. * - * @return a Type object representing the component type + * @return a {@code Type} object representing the component type * of this array * @since 1.5 */ --- old/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/TypeVariableImpl.java 2015-09-24 14:38:16.333755513 +0300 +++ new/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/TypeVariableImpl.java 2015-09-24 14:38:15.921755522 +0300 @@ -46,7 +46,7 @@ import sun.reflect.misc.ReflectUtil; /** - * Implementation of java.lang.reflect.TypeVariable interface + * Implementation of {@code java.lang.reflect.TypeVariable} interface * for core reflection. */ public class TypeVariableImpl @@ -99,9 +99,9 @@ /** - * Returns an array of Type objects representing the + * Returns an array of {@code Type} objects representing the * upper bound(s) of this type variable. Note that if no upper bound is - * explicitly declared, the upper bound is Object. + * explicitly declared, the upper bound is {@code Object}. * *

For each upper bound B: *

* - * @throws TypeNotPresentException if any of the + * @throws {@code TypeNotPresentException} if any of the * bounds refers to a non-existent type declaration - * @throws MalformedParameterizedTypeException if any of the + * @throws {@code MalformedParameterizedTypeException} if any of the * bounds refer to a parameterized type that cannot be instantiated * for any reason * @return an array of Types representing the upper bound(s) of this @@ -129,7 +129,7 @@ } /** - * Returns the GenericDeclaration object representing the + * Returns the {@code GenericDeclaration} object representing the * generic declaration that declared this type variable. * * @return the generic declaration that declared this type variable. --- old/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/WildcardTypeImpl.java 2015-09-24 14:38:17.281755493 +0300 +++ new/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/WildcardTypeImpl.java 2015-09-24 14:38:16.921755500 +0300 @@ -78,9 +78,9 @@ } /** - * Returns an array of Type objects representing the upper + * Returns an array of {@code Type} objects representing the upper * bound(s) of this type variable. Note that if no upper bound is - * explicitly declared, the upper bound is Object. + * explicitly declared, the upper bound is {@code Object}. * *

For each upper bound B : *