--- old/src/java.xml.crypto/share/classes/com/sun/org/apache/xml/internal/security/encryption/ReferenceList.java 2015-08-18 14:21:17.433018228 +0400 +++ new/src/java.xml.crypto/share/classes/com/sun/org/apache/xml/internal/security/encryption/ReferenceList.java 2015-08-18 14:21:17.221018237 +0400 @@ -25,12 +25,12 @@ import java.util.Iterator; /** - * ReferenceList is an element that contains pointers from a key - * value of an EncryptedKey to items encrypted by that key value - * (EncryptedData or EncryptedKey elements). + * {@code ReferenceList} is an element that contains pointers from a key + * value of an {@code EncryptedKey} to items encrypted by that key value + * ({@code EncryptedData} or {@code EncryptedKey} elements). *

* It is defined as follows: - *

+ * <pre>{@code * <element name='ReferenceList'> * <complexType> * <choice minOccurs='1' maxOccurs='unbounded'> @@ -39,7 +39,7 @@ * </choice> * </complexType> * </element> - * + * } * * @author Axl Mattheus * @see Reference @@ -56,54 +56,54 @@ * Adds a reference to this reference list. * * @param reference the reference to add. - * @throws IllegalAccessException if the Reference is not an - * instance of DataReference or KeyReference. + * @throws IllegalAccessException if the {@code Reference} is not an + * instance of {@code DataReference} or {@code KeyReference}. */ void add(Reference reference); /** - * Removes a reference from the ReferenceList. + * Removes a reference from the {@code ReferenceList}. * * @param reference the reference to remove. */ void remove(Reference reference); /** - * Returns the size of the ReferenceList. + * Returns the size of the {@code ReferenceList}. * - * @return the size of the ReferenceList. + * @return the size of the {@code ReferenceList}. */ int size(); /** - * Indicates if the ReferenceList is empty. + * Indicates if the {@code ReferenceList} is empty. * - * @return true if the ReferenceList is - * empty, else false. + * @return {@code true} if the {@code ReferenceList} is + * empty, else {@code false}. */ boolean isEmpty(); /** - * Returns an Iterator over all the References - * contained in this ReferenceList. + * Returns an {@code Iterator} over all the {@code Reference}s + * contained in this {@code ReferenceList}. * * @return Iterator. */ Iterator getReferences(); /** - * DataReference factory method. Returns a - * DataReference. + * {@code DataReference} factory method. Returns a + * {@code DataReference}. * @param uri - * @return a DataReference. + * @return a {@code DataReference}. */ Reference newDataReference(String uri); /** - * KeyReference factory method. Returns a - * KeyReference. + * {@code KeyReference} factory method. Returns a + * {@code KeyReference}. * @param uri - * @return a KeyReference. + * @return a {@code KeyReference}. */ Reference newKeyReference(String uri); }