--- 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(); }