--- old/src/java.xml/share/classes/javax/xml/datatype/DatatypeFactory.java 2015-04-21 18:33:54.720094845 +0400 +++ new/src/java.xml/share/classes/javax/xml/datatype/DatatypeFactory.java 2015-04-21 18:33:54.632094845 +0400 @@ -32,11 +32,10 @@ import java.util.regex.Pattern; /** - * Factory that creates new javax.xml.datatype Objects that map XML to/from Java Objects. + * Factory that creates new {@code javax.xml.datatype} {@code Object}s that map XML to/from Java {@code Object}s. *

* A new instance of the {@code DatatypeFactory} is created through the {@link #newInstance()} method * that uses the following implementation resolution mechanisms to determine an implementation: - *

*

    *
  1. * If the system property specified by {@link #DATATYPEFACTORY_PROPERTY}, "{@code javax.xml.datatype.DatatypeFactory}", @@ -89,9 +88,9 @@ public abstract class DatatypeFactory { /** - *

    Default property name as defined in JSR 206: Java(TM) API for XML Processing (JAXP) 1.3.

    + * Default property name as defined in JSR 206: Java(TM) API for XML Processing (JAXP) 1.3. * - *

    Default value is {@code javax.xml.datatype.DatatypeFactory}.

    + *

    Default value is {@code javax.xml.datatype.DatatypeFactory}. */ public static final String DATATYPEFACTORY_PROPERTY = // We use a String constant here, rather than calling @@ -100,16 +99,15 @@ "javax.xml.datatype.DatatypeFactory"; /** - *

    Default implementation class name as defined in - * JSR 206: Java(TM) API for XML Processing (JAXP) 1.3.

    + * Default implementation class name as defined in + * JSR 206: Java(TM) API for XML Processing (JAXP) 1.3. * *

    Implementers should specify the name of an appropriate class * to be instantiated if no other implementation resolution mechanism - * succeeds.

    + * succeeds. * *

    Users should not refer to this field; it is intended only to * document a factory implementation detail. - *

    */ public static final String DATATYPEFACTORY_IMPLEMENTATION_CLASS = // We use new String() here to prevent javadoc from generating @@ -130,18 +128,18 @@ Pattern.compile("[^YM]*[DT].*"); /** - *

    Protected constructor to prevent instantiation outside of package.

    + * Protected constructor to prevent instantiation outside of package. * - *

    Use {@link #newInstance()} to create a {@code DatatypeFactory}.

    + *

    Use {@link #newInstance()} to create a {@code DatatypeFactory}. */ protected DatatypeFactory() { } /** - *

    Obtain a new instance of a {@code DatatypeFactory}.

    + * Obtain a new instance of a {@code DatatypeFactory}. * *

    The implementation resolution mechanisms are defined in this - * Class's documentation.

    + * {@code Class}'s documentation. * * @return New instance of a {@code DatatypeFactory} * @@ -161,33 +159,33 @@ } /** - *

    Obtain a new instance of a {@code DatatypeFactory} from class name. + * Obtain a new instance of a {@code DatatypeFactory} from class name. * This function is useful when there are multiple providers in the classpath. * It gives more control to the application as it can specify which provider - * should be loaded.

    + * should be loaded. * *

    Once an application has obtained a reference to a {@code DatatypeFactory} - * it can use the factory to configure and obtain datatype instances.

    + * it can use the factory to configure and obtain datatype instances. * * *

    Tip for Trouble-shooting

    - *

    Setting the jaxp.debug system property will cause + *

    Setting the {@code jaxp.debug} system property will cause * this method to print a lot of debug messages - * to System.err about what it is doing and where it is looking at.

    + * to {@code System.err} about what it is doing and where it is looking at. * - *

    If you have problems try:

    + *

    If you have problems try: * 

          * java -Djaxp.debug=1 YourProgram ....
      *
    * * @param factoryClassName fully qualified factory class name that provides implementation of {@code javax.xml.datatype.DatatypeFactory}. * - * @param classLoader ClassLoader used to load the factory class. If null - * current Thread's context classLoader is used to load the factory class. + * @param classLoader {@code ClassLoader} used to load the factory class. If {@code null} + * current {@code Thread}'s context classLoader is used to load the factory class. * * @return New instance of a {@code DatatypeFactory} * - * @throws DatatypeConfigurationException if factoryClassName is null, or + * @throws DatatypeConfigurationException if {@code factoryClassName} is {@code null}, or * the factory class cannot be loaded, instantiated. * * @see #newInstance() @@ -201,11 +199,11 @@ } /** - *

    Obtain a new instance of a Duration - * specifying the Duration as its string representation, "PnYnMnDTnHnMnS", - * as defined in XML Schema 1.0 section 3.2.6.1.

    + * Obtain a new instance of a {@code Duration} + * specifying the {@code Duration} as its string representation, "PnYnMnDTnHnMnS", + * as defined in XML Schema 1.0 section 3.2.6.1. * - *

    XML Schema Part 2: Datatypes, 3.2.6 duration, defines duration as:

    + *

    XML Schema Part 2: Datatypes, 3.2.6 duration, defines {@code duration} as: *

    * duration represents a duration of time. * The value space of duration is a six-dimensional space where the coordinates designate the @@ -213,28 +211,28 @@ * These components are ordered in their significance by their order of appearance i.e. as * year, month, day, hour, minute, and second. *
    - *

    All six values are set and available from the created {@link Duration}

    + *

    All six values are set and available from the created {@link Duration} * *

    The XML Schema specification states that values can be of an arbitrary size. * Implementations may chose not to or be incapable of supporting arbitrarily large and/or small values. * An {@link UnsupportedOperationException} will be thrown with a message indicating implementation limits - * if implementation capacities are exceeded.

    + * if implementation capacities are exceeded. * - * @param lexicalRepresentation String representation of a Duration. + * @param lexicalRepresentation {@code String} representation of a {@code Duration}. * - * @return New Duration created from parsing the lexicalRepresentation. + * @return New {@code Duration} created from parsing the {@code lexicalRepresentation}. * - * @throws IllegalArgumentException If lexicalRepresentation is not a valid representation of a Duration. + * @throws IllegalArgumentException If {@code lexicalRepresentation} is not a valid representation of a {@code Duration}. * @throws UnsupportedOperationException If implementation cannot support requested values. - * @throws NullPointerException if lexicalRepresentation is null. + * @throws NullPointerException if {@code lexicalRepresentation} is {@code null}. */ public abstract Duration newDuration(final String lexicalRepresentation); /** - *

    Obtain a new instance of a Duration - * specifying the Duration as milliseconds.

    + * Obtain a new instance of a {@code Duration} + * specifying the {@code Duration} as milliseconds. * - *

    XML Schema Part 2: Datatypes, 3.2.6 duration, defines duration as:

    + *

    XML Schema Part 2: Datatypes, 3.2.6 duration, defines {@code duration} as: *

    * duration represents a duration of time. * The value space of duration is a six-dimensional space where the coordinates designate the @@ -243,8 +241,8 @@ * year, month, day, hour, minute, and second. *
    *

    All six values are set by computing their values from the specified milliseconds - * and are available using the get methods of the created {@link Duration}. - * The values conform to and are defined by:

    + * and are available using the {@code get} methods of the created {@link Duration}. + * The values conform to and are defined by: *