--- old/src/java.naming/share/classes/javax/naming/directory/BasicAttributes.java 2015-08-04 13:14:38.208900476 +0300 +++ new/src/java.naming/share/classes/javax/naming/directory/BasicAttributes.java 2015-08-04 13:14:37.900900469 +0300 @@ -207,17 +207,17 @@ } /** - * Determines whether this BasicAttributes is equal to another - * Attributes - * Two Attributes are equal if they are both instances of - * Attributes, + * Determines whether this {@code BasicAttributes} is equal to another + * {@code Attributes} + * Two {@code Attributes} are equal if they are both instances of + * {@code Attributes}, * treat the case of attribute IDs the same way, and contain the - * same attributes. Each Attribute in this BasicAttributes - * is checked for equality using Object.equals(), which may have - * be overridden by implementations of Attribute). - * If a subclass overrides equals(), - * it should override hashCode() - * as well so that two Attributes instances that are equal + * same attributes. Each {@code Attribute} in this {@code BasicAttributes} + * is checked for equality using {@code Object.equals()}, which may have + * be overridden by implementations of {@code Attribute}). + * If a subclass overrides {@code equals()}, + * it should override {@code hashCode()} + * as well so that two {@code Attributes} instances that are equal * have the same hash code. * @param obj the possibly null object to compare against. * @@ -259,9 +259,9 @@ * The hash code is computed by adding the hash code of * the attributes of this object. If this BasicAttributes * ignores case of its attribute IDs, one is added to the hash code. - * If a subclass overrides hashCode(), - * it should override equals() - * as well so that two Attributes instances that are equal + * If a subclass overrides {@code hashCode()}, + * it should override {@code equals()} + * as well so that two {@code Attributes} instances that are equal * have the same hash code. * * @return an int representing the hash code of this BasicAttributes instance.