jdk-sandbox: comparison jaxp/src/java.xml/share/classes/javax/xml/datatype/DatatypeFactory.java

equal deleted inserted replaced

-:ac3f5a39d4ff
+:8493f5fc1052
 import java.util.GregorianCalendar;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 /**
-* Factory that creates new <code>javax.xml.datatype</code> <code>Object</code>s that map XML to/from Java <code>Object</code>s.
+* Factory that creates new {@code javax.xml.datatype} {@code Object}s that map XML to/from Java {@code Object}s.
 * <p>
 * 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:
-* <p>
 * <ol>
 *    <li>
 *      If the system property specified by {@link #DATATYPEFACTORY_PROPERTY}, "{@code javax.xml.datatype.DatatypeFactory}",
 *      exists, a class with the name of the property value is instantiated.
 *      Any Exception thrown during the instantiation process is wrapped as a {@link DatatypeConfigurationException}.
 * @since 1.5
 */
 public abstract class DatatypeFactory {
 /**
-* <p>Default property name as defined in JSR 206: Java(TM) API for XML Processing (JAXP) 1.3.</p>
+* Default property name as defined in JSR 206: Java(TM) API for XML Processing (JAXP) 1.3.
 *
-* <p>Default value is {@code javax.xml.datatype.DatatypeFactory}.</p>
+* <p>Default value is {@code javax.xml.datatype.DatatypeFactory}.
 */
 public static final String DATATYPEFACTORY_PROPERTY =
 // We use a String constant here, rather than calling
 // DatatypeFactory.class.getName() - in order to make javadoc
 // generate a See Also: Constant Field Value link.
 "javax.xml.datatype.DatatypeFactory";
 /**
-* <p>Default implementation class name as defined in
+* Default implementation class name as defined in
-* <em>JSR 206: Java(TM) API for XML Processing (JAXP) 1.3</em>.</p>
+* <em>JSR 206: Java(TM) API for XML Processing (JAXP) 1.3</em>.
 *
 * <p>Implementers should specify the name of an appropriate class
 * to be instantiated if no other implementation resolution mechanism
-* succeeds.</p>
+* succeeds.
 *
 * <p>Users should not refer to this field; it is intended only to
 * document a factory implementation detail.
-* </p>
 */
 public static final String DATATYPEFACTORY_IMPLEMENTATION_CLASS =
 // We use new String() here to prevent javadoc from generating
 // a See Also: Constant Field Value link.
 new String("com.sun.org.apache.xerces.internal.jaxp.datatype.DatatypeFactoryImpl");
 private static final Pattern XDTSCHEMA_DTD =
 Pattern.compile("[^YM]*[DT].*");
 /**
-* <p>Protected constructor to prevent instantiation outside of package.</p>
+* Protected constructor to prevent instantiation outside of package.
 *
-* <p>Use {@link #newInstance()} to create a {@code DatatypeFactory}.</p>
+* <p>Use {@link #newInstance()} to create a {@code DatatypeFactory}.
 */
 protected DatatypeFactory() {
 }
 /**
-* <p>Obtain a new instance of a {@code DatatypeFactory}.</p>
+* Obtain a new instance of a {@code DatatypeFactory}.
 *
 * <p>The implementation resolution mechanisms are <a href="#DatatypeFactory.newInstance">defined</a> in this
-* <code>Class</code>'s documentation.</p>
+* {@code Class}'s documentation.
 *
 * @return New instance of a {@code DatatypeFactory}
 *
 * @throws DatatypeConfigurationException If the implementation is not
 *   available or cannot be instantiated.
 /* The fallback implementation class name */
 DATATYPEFACTORY_IMPLEMENTATION_CLASS);
 }
 /**
-* <p>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.</p>
+* should be loaded.
 *
 * <p>Once an application has obtained a reference to a {@code DatatypeFactory}
-* it can use the factory to configure and obtain datatype instances.</P>
+* it can use the factory to configure and obtain datatype instances.
 *
 *
 * <h2>Tip for Trouble-shooting</h2>
-* <p>Setting the <code>jaxp.debug</code> system property will cause
+* <p>Setting the {@code jaxp.debug} system property will cause
 * this method to print a lot of debug messages
-* to <code>System.err</code> about what it is doing and where it is looking at.</p>
+* to {@code System.err} about what it is doing and where it is looking at.
 *
-* <p> If you have problems try:</p>
+* <p> If you have problems try:
 * <pre>
 * java -Djaxp.debug=1 YourProgram ....
 * </pre>
 *
 * @param factoryClassName fully qualified factory class name that provides implementation of {@code javax.xml.datatype.DatatypeFactory}.
 *
-* @param classLoader <code>ClassLoader</code> used to load the factory class. If <code>null</code>
+* @param classLoader {@code ClassLoader} used to load the factory class. If {@code null}
-*                     current <code>Thread</code>'s context classLoader is used to load the factory class.
+*                     current {@code Thread}'s context classLoader is used to load the factory class.
 *
 * @return New instance of a {@code DatatypeFactory}
 *
-* @throws DatatypeConfigurationException if <code>factoryClassName</code> is <code>null</code>, or
+* @throws DatatypeConfigurationException if {@code factoryClassName} is {@code null}, or
 *                                   the factory class cannot be loaded, instantiated.
 *
 * @see #newInstance()
 *
 * @since 1.6
 return FactoryFinder.newInstance(DatatypeFactory.class,
 factoryClassName, classLoader, false);
 }
 /**
-* <p>Obtain a new instance of a <code>Duration</code>
+* Obtain a new instance of a {@code Duration}
-* specifying the <code>Duration</code> as its string representation, "PnYnMnDTnHnMnS",
+* specifying the {@code Duration} as its string representation, "PnYnMnDTnHnMnS",
-* as defined in XML Schema 1.0 section 3.2.6.1.</p>
+* as defined in XML Schema 1.0 section 3.2.6.1.
 *
-* <p>XML Schema Part 2: Datatypes, 3.2.6 duration, defines <code>duration</code> as:</p>
+* <p>XML Schema Part 2: Datatypes, 3.2.6 duration, defines {@code duration} as:
 * <blockquote>
 * duration represents a duration of time.
 * The value space of duration is a six-dimensional space where the coordinates designate the
 * Gregorian year, month, day, hour, minute, and second components defined in Section 5.5.3.2 of [ISO 8601], respectively.
 * These components are ordered in their significance by their order of appearance i.e. as
 * year, month, day, hour, minute, and second.
 * </blockquote>
-* <p>All six values are set and available from the created {@link Duration}</p>
+* <p>All six values are set and available from the created {@link Duration}
 *
 * <p>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.</p>
+* if implementation capacities are exceeded.
 *
-* @param lexicalRepresentation <code>String</code> representation of a <code>Duration</code>.
+* @param lexicalRepresentation {@code String} representation of a {@code Duration}.
 *
-* @return New <code>Duration</code> created from parsing the <code>lexicalRepresentation</code>.
+* @return New {@code Duration} created from parsing the {@code lexicalRepresentation}.
 *
-* @throws IllegalArgumentException If <code>lexicalRepresentation</code> is not a valid representation of a <code>Duration</code>.
+* @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 <code>lexicalRepresentation</code> is <code>null</code>.
+* @throws NullPointerException if {@code lexicalRepresentation} is {@code null}.
 */
 public abstract Duration newDuration(final String lexicalRepresentation);
 /**
-* <p>Obtain a new instance of a <code>Duration</code>
+* Obtain a new instance of a {@code Duration}
-* specifying the <code>Duration</code> as milliseconds.</p>
+* specifying the {@code Duration} as milliseconds.
 *
-* <p>XML Schema Part 2: Datatypes, 3.2.6 duration, defines <code>duration</code> as:</p>
+* <p>XML Schema Part 2: Datatypes, 3.2.6 duration, defines {@code duration} as:
 * <blockquote>
 * duration represents a duration of time.
 * The value space of duration is a six-dimensional space where the coordinates designate the
 * Gregorian year, month, day, hour, minute, and second components defined in Section 5.5.3.2 of [ISO 8601], respectively.
 * These components are ordered in their significance by their order of appearance i.e. as
 * year, month, day, hour, minute, and second.
 * </blockquote>
 * <p>All six values are set by computing their values from the specified milliseconds
-* and are available using the <code>get</code> methods of  the created {@link Duration}.
+* and are available using the {@code get} methods of  the created {@link Duration}.
-* The values conform to and are defined by:</p>
+* The values conform to and are defined by:
 * <ul>
 *   <li>ISO 8601:2000(E) Section 5.5.3.2 Alternative format</li>
 *   <li><a href="http://www.w3.org/TR/xmlschema-2/#isoformats">
 *     W3C XML Schema 1.0 Part 2, Appendix D, ISO 8601 Date and Time Formats</a>
 *   </li>
 * {@link java.util.Calendar#YEAR} = 1970,
 * {@link java.util.Calendar#MONTH} = {@link java.util.Calendar#JANUARY},
 * {@link java.util.Calendar#DATE} = 1, etc.
 * This is important as there are variations in the Gregorian Calendar,
 * e.g. leap years have different days in the month = {@link java.util.Calendar#FEBRUARY}
-* so the result of {@link Duration#getMonths()} and {@link Duration#getDays()} can be influenced.</p>
+* so the result of {@link Duration#getMonths()} and {@link Duration#getDays()} can be influenced.
 *
 * @param durationInMilliSeconds Duration in milliseconds to create.
 *
-* @return New <code>Duration</code> representing <code>durationInMilliSeconds</code>.
+* @return New {@code Duration} representing {@code durationInMilliSeconds}.
 */
 public abstract Duration newDuration(final long durationInMilliSeconds);
 /**
-* <p>Obtain a new instance of a <code>Duration</code>
+* Obtain a new instance of a {@code Duration}
-* specifying the <code>Duration</code> as isPositive, years, months, days, hours, minutes, seconds.</p>
+* specifying the {@code Duration} as isPositive, years, months, days, hours, minutes, seconds.
 *
 * <p>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.</p>
+* if implementation capacities are exceeded.
 *
-* <p>A <code>null</code> value indicates that field is not set.</p>
+* <p>A {@code null} value indicates that field is not set.
 *
-* @param isPositive Set to <code>false</code> to create a negative duration. When the length
+* @param isPositive Set to {@code false} to create a negative duration. When the length
 *   of the duration is zero, this parameter will be ignored.
-* @param years of this <code>Duration</code>
+* @param years of this {@code Duration}
-* @param months of this <code>Duration</code>
+* @param months of this {@code Duration}
-* @param days of this <code>Duration</code>
+* @param days of this {@code Duration}
-* @param hours of this <code>Duration</code>
+* @param hours of this {@code Duration}
-* @param minutes of this <code>Duration</code>
+* @param minutes of this {@code Duration}
-* @param seconds of this <code>Duration</code>
+* @param seconds of this {@code Duration}
 *
-* @return New <code>Duration</code> created from the specified values.
+* @return New {@code Duration} created from the specified values.
 *
 * @throws IllegalArgumentException If the values are not a valid representation of a
-* <code>Duration</code>: if all the fields (years, months, ...) are null or
+* {@code Duration}: if all the fields (years, months, ...) are null or
 * if any of the fields is negative.
 * @throws UnsupportedOperationException If implementation cannot support requested values.
 */
 public abstract Duration newDuration(
 final boolean isPositive,
 final BigInteger hours,
 final BigInteger minutes,
 final BigDecimal seconds);
 /**
-* <p>Obtain a new instance of a <code>Duration</code>
+* Obtain a new instance of a {@code Duration}
-* specifying the <code>Duration</code> as isPositive, years, months, days, hours, minutes, seconds.</p>
+* specifying the {@code Duration} as isPositive, years, months, days, hours, minutes, seconds.
 *
-* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.</p>
+* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.
 *
-* @param isPositive Set to <code>false</code> to create a negative duration. When the length
+* @param isPositive Set to {@code false} to create a negative duration. When the length
 *   of the duration is zero, this parameter will be ignored.
-* @param years of this <code>Duration</code>
+* @param years of this {@code Duration}
-* @param months of this <code>Duration</code>
+* @param months of this {@code Duration}
-* @param days of this <code>Duration</code>
+* @param days of this {@code Duration}
-* @param hours of this <code>Duration</code>
+* @param hours of this {@code Duration}
-* @param minutes of this <code>Duration</code>
+* @param minutes of this {@code Duration}
-* @param seconds of this <code>Duration</code>
+* @param seconds of this {@code Duration}
 *
-* @return New <code>Duration</code> created from the specified values.
+* @return New {@code Duration} created from the specified values.
 *
 * @throws IllegalArgumentException If the values are not a valid representation of a
-* <code>Duration</code>: if any of the fields is negative.
+* {@code Duration}: if any of the fields is negative.
 *
 * @see #newDuration(
 *   boolean isPositive,
 *   BigInteger years,
 *   BigInteger months,
 realSeconds
 );
 }
 /**
-* <p>Create a <code>Duration</code> of type <code>xdt:dayTimeDuration</code> by parsing its <code>String</code> representation,
+* Create a {@code Duration} of type {@code xdt:dayTimeDuration}
+* by parsing its {@code String} representation,
 * "<em>PnDTnHnMnS</em>", <a href="http://www.w3.org/TR/xpath-datamodel#dayTimeDuration">
-*   XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration</a>.</p>
+*   XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration</a>.
 *
-* <p>The datatype <code>xdt:dayTimeDuration</code> is a subtype of <code>xs:duration</code>
+* <p>The datatype {@code xdt:dayTimeDuration} is a subtype of {@code xs:duration}
 * whose lexical representation contains only day, hour, minute, and second components.
-* This datatype resides in the namespace <code>http://www.w3.org/2003/11/xpath-datatypes</code>.</p>
+* This datatype resides in the namespace {@code http://www.w3.org/2003/11/xpath-datatypes}.
 *
-* <p>All four values are set and available from the created {@link Duration}</p>
+* <p>All four values are set and available from the created {@link Duration}
 *
 * <p>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.</p>
+* if implementation capacities are exceeded.
 *
 * @param lexicalRepresentation Lexical representation of a duration.
 *
-* @return New <code>Duration</code> created using the specified <code>lexicalRepresentation</code>.
+* @return New {@code Duration} created using the specified {@code lexicalRepresentation}.
 *
-* @throws IllegalArgumentException If <code>lexicalRepresentation</code> is not a valid representation of a <code>Duration</code> expressed only in terms of days and time.
+* @throws IllegalArgumentException If {@code lexicalRepresentation} is
+*         not a valid representation of a {@code Duration} expressed only in terms of days and time.
 * @throws UnsupportedOperationException If implementation cannot support requested values.
-* @throws NullPointerException If <code>lexicalRepresentation</code> is <code>null</code>.
+* @throws NullPointerException If {@code lexicalRepresentation} is {@code null}.
 */
 public Duration newDurationDayTime(final String lexicalRepresentation) {
 // lexicalRepresentation must be non-null
 if (lexicalRepresentation == null) {
 throw new NullPointerException(
 return newDuration(lexicalRepresentation);
 }
 /**
-* <p>Create a <code>Duration</code> of type <code>xdt:dayTimeDuration</code> using the specified milliseconds as defined in
+* Create a {@code Duration} of type {@code xdt:dayTimeDuration}
+* using the specified milliseconds as defined in
 * <a href="http://www.w3.org/TR/xpath-datamodel#dayTimeDuration">
-*   XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration</a>.</p>
+*   XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration</a>.
 *
-* <p>The datatype <code>xdt:dayTimeDuration</code> is a subtype of <code>xs:duration</code>
+* <p>The datatype {@code xdt:dayTimeDuration} is a subtype of {@code xs:duration}
 * whose lexical representation contains only day, hour, minute, and second components.
-* This datatype resides in the namespace <code>http://www.w3.org/2003/11/xpath-datatypes</code>.</p>
+* This datatype resides in the namespace {@code http://www.w3.org/2003/11/xpath-datatypes}.
 *
 * <p>All four values are set by computing their values from the specified milliseconds
-* and are available using the <code>get</code> methods of  the created {@link Duration}.
+* and are available using the {@code get} methods of  the created {@link Duration}.
-* The values conform to and are defined by:</p>
+* The values conform to and are defined by:
 * <ul>
 *   <li>ISO 8601:2000(E) Section 5.5.3.2 Alternative format</li>
 *   <li><a href="http://www.w3.org/TR/xmlschema-2/#isoformats">
 *     W3C XML Schema 1.0 Part 2, Appendix D, ISO 8601 Date and Time Formats</a>
 *   </li>
 * {@link java.util.Calendar#YEAR} = 1970,
 * {@link java.util.Calendar#MONTH} = {@link java.util.Calendar#JANUARY},
 * {@link java.util.Calendar#DATE} = 1, etc.
 * This is important as there are variations in the Gregorian Calendar,
 * e.g. leap years have different days in the month = {@link java.util.Calendar#FEBRUARY}
-* so the result of {@link Duration#getDays()} can be influenced.</p>
+* so the result of {@link Duration#getDays()} can be influenced.
 *
-* <p>Any remaining milliseconds after determining the day, hour, minute and second are discarded.</p>
+* <p>Any remaining milliseconds after determining the day, hour, minute and second are discarded.
 *
-* @param durationInMilliseconds Milliseconds of <code>Duration</code> to create.
+* @param durationInMilliseconds Milliseconds of {@code Duration} to create.
 *
-* @return New <code>Duration</code> created with the specified <code>durationInMilliseconds</code>.
+* @return New {@code Duration} created with the specified {@code durationInMilliseconds}.
 *
 * @see <a href="http://www.w3.org/TR/xpath-datamodel#dayTimeDuration">
 *   XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration</a>
 */
 public Duration newDurationDayTime(final long durationInMilliseconds) {
 return newDuration(durationInMilliseconds);
 }
 /**
-* <p>Create a <code>Duration</code> of type <code>xdt:dayTimeDuration</code> using the specified
+* Create a {@code Duration} of type {@code xdt:dayTimeDuration} using the specified
-* <code>day</code>, <code>hour</code>, <code>minute</code> and <code>second</code> as defined in
+* {@code day}, {@code hour}, {@code minute} and {@code second} as defined in
 * <a href="http://www.w3.org/TR/xpath-datamodel#dayTimeDuration">
-*   XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration</a>.</p>
+*   XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration</a>.
 *
-* <p>The datatype <code>xdt:dayTimeDuration</code> is a subtype of <code>xs:duration</code>
+* <p>The datatype {@code xdt:dayTimeDuration} is a subtype of {@code xs:duration}
 * whose lexical representation contains only day, hour, minute, and second components.
-* This datatype resides in the namespace <code>http://www.w3.org/2003/11/xpath-datatypes</code>.</p>
+* This datatype resides in the namespace {@code http://www.w3.org/2003/11/xpath-datatypes}.
 *
 * <p>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.</p>
+* if implementation capacities are exceeded.
 *
-* <p>A <code>null</code> value indicates that field is not set.</p>
+* <p>A {@code null} value indicates that field is not set.
 *
-* @param isPositive Set to <code>false</code> to create a negative duration. When the length
+* @param isPositive Set to {@code false} to create a negative duration. When the length
 *   of the duration is zero, this parameter will be ignored.
-* @param day Day of <code>Duration</code>.
+* @param day Day of {@code Duration}.
-* @param hour Hour of <code>Duration</code>.
+* @param hour Hour of {@code Duration}.
-* @param minute Minute of <code>Duration</code>.
+* @param minute Minute of {@code Duration}.
-* @param second Second of <code>Duration</code>.
+* @param second Second of {@code Duration}.
 *
-* @return New <code>Duration</code> created with the specified <code>day</code>, <code>hour</code>, <code>minute</code>
+* @return New {@code Duration} created with the specified {@code day}, {@code hour}, {@code minute}
-* and <code>second</code>.
+* and {@code second}.
 *
 * @throws IllegalArgumentException If the values are not a valid representation of a
-* <code>Duration</code>: if all the fields (day, hour, ...) are null or
+* {@code Duration}: if all the fields (day, hour, ...) are null or
 * if any of the fields is negative.
 * @throws UnsupportedOperationException If implementation cannot support requested values.
 */
 public Duration newDurationDayTime(
 final boolean isPositive,
 (second != null)? new BigDecimal(second):null
 );
 }
 /**
-* <p>Create a <code>Duration</code> of type <code>xdt:dayTimeDuration</code> using the specified
+* Create a {@code Duration} of type {@code xdt:dayTimeDuration} using the specified
-* <code>day</code>, <code>hour</code>, <code>minute</code> and <code>second</code> as defined in
+* {@code day}, {@code hour}, {@code minute} and {@code second} as defined in
 * <a href="http://www.w3.org/TR/xpath-datamodel#dayTimeDuration">
-*   XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration</a>.</p>
+*   XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration</a>.
 *
-* <p>The datatype <code>xdt:dayTimeDuration</code> is a subtype of <code>xs:duration</code>
+* <p>The datatype {@code xdt:dayTimeDuration} is a subtype of {@code xs:duration}
 * whose lexical representation contains only day, hour, minute, and second components.
-* This datatype resides in the namespace <code>http://www.w3.org/2003/11/xpath-datatypes</code>.</p>
+* This datatype resides in the namespace {@code http://www.w3.org/2003/11/xpath-datatypes}.
 *
-* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.</p>
+* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.
 *
-* @param isPositive Set to <code>false</code> to create a negative duration. When the length
+* @param isPositive Set to {@code false} to create a negative duration. When the length
 *   of the duration is zero, this parameter will be ignored.
-* @param day Day of <code>Duration</code>.
+* @param day Day of {@code Duration}.
-* @param hour Hour of <code>Duration</code>.
+* @param hour Hour of {@code Duration}.
-* @param minute Minute of <code>Duration</code>.
+* @param minute Minute of {@code Duration}.
-* @param second Second of <code>Duration</code>.
+* @param second Second of {@code Duration}.
 *
-* @return New <code>Duration</code> created with the specified <code>day</code>, <code>hour</code>, <code>minute</code>
+* @return New {@code Duration} created with the specified {@code day}, {@code hour}, {@code minute}
-* and <code>second</code>.
+* and {@code second}.
 *
 * @throws IllegalArgumentException If the values are not a valid representation of a
-* <code>Duration</code>: if any of the fields (day, hour, ...) is negative.
+* {@code Duration}: if any of the fields (day, hour, ...) is negative.
 */
 public Duration newDurationDayTime(
 final boolean isPositive,
 final int day,
 final int hour,
 BigInteger.valueOf((long) second)
 );
 }
 /**
-* <p>Create a <code>Duration</code> of type <code>xdt:yearMonthDuration</code> by parsing its <code>String</code> representation,
+* Create a {@code Duration} of type {@code xdt:yearMonthDuration}
+* by parsing its {@code String} representation,
 * "<em>PnYnM</em>", <a href="http://www.w3.org/TR/xpath-datamodel#yearMonthDuration">
-*   XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration</a>.</p>
+*   XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration</a>.
 *
-* <p>The datatype <code>xdt:yearMonthDuration</code> is a subtype of <code>xs:duration</code>
+* <p>The datatype {@code xdt:yearMonthDuration} is a subtype of {@code xs:duration}
 * whose lexical representation contains only year and month components.
-* This datatype resides in the namespace {@link javax.xml.XMLConstants#W3C_XPATH_DATATYPE_NS_URI}.</p>
+* This datatype resides in the namespace {@link javax.xml.XMLConstants#W3C_XPATH_DATATYPE_NS_URI}.
 *
-* <p>Both values are set and available from the created {@link Duration}</p>
+* <p>Both values are set and available from the created {@link Duration}
 *
 * <p>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.
+* Implementations may chose not to or be incapable of supporting
-* An {@link UnsupportedOperationException} will be thrown with a message indicating implementation limits
+* arbitrarily large and/or small values. An {@link UnsupportedOperationException}
-* if implementation capacities are exceeded.</p>
+* will be thrown with a message indicating implementation limits
+* if implementation capacities are exceeded.
 *
 * @param lexicalRepresentation Lexical representation of a duration.
 *
-* @return New <code>Duration</code> created using the specified <code>lexicalRepresentation</code>.
+* @return New {@code Duration} created using the specified {@code lexicalRepresentation}.
 *
-* @throws IllegalArgumentException If <code>lexicalRepresentation</code> is not a valid representation of a <code>Duration</code> expressed only in terms of years and months.
+* @throws IllegalArgumentException If {@code lexicalRepresentation} is not a valid representation of a {@code Duration} expressed only in terms of years and months.
 * @throws UnsupportedOperationException If implementation cannot support requested values.
-* @throws NullPointerException If <code>lexicalRepresentation</code> is <code>null</code>.
+* @throws NullPointerException If {@code lexicalRepresentation} is {@code null}.
 */
 public Duration newDurationYearMonth(
 final String lexicalRepresentation) {
 // lexicalRepresentation must be non-null
 return newDuration(lexicalRepresentation);
 }
 /**
-* <p>Create a <code>Duration</code> of type <code>xdt:yearMonthDuration</code> using the specified milliseconds as defined in
+* Create a {@code Duration} of type {@code xdt:yearMonthDuration}
+* using the specified milliseconds as defined in
 * <a href="http://www.w3.org/TR/xpath-datamodel#yearMonthDuration">
-*   XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration</a>.</p>
+*   XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration</a>.
 *
-* <p>The datatype <code>xdt:yearMonthDuration</code> is a subtype of <code>xs:duration</code>
+* <p>The datatype {@code xdt:yearMonthDuration} is a subtype of {@code xs:duration}
 * whose lexical representation contains only year and month components.
-* This datatype resides in the namespace {@link javax.xml.XMLConstants#W3C_XPATH_DATATYPE_NS_URI}.</p>
+* This datatype resides in the namespace {@link javax.xml.XMLConstants#W3C_XPATH_DATATYPE_NS_URI}.
 *
 * <p>Both values are set by computing their values from the specified milliseconds
-* and are available using the <code>get</code> methods of  the created {@link Duration}.
+* and are available using the {@code get} methods of  the created {@link Duration}.
-* The values conform to and are defined by:</p>
+* The values conform to and are defined by:
 * <ul>
 *   <li>ISO 8601:2000(E) Section 5.5.3.2 Alternative format</li>
 *   <li><a href="http://www.w3.org/TR/xmlschema-2/#isoformats">
 *     W3C XML Schema 1.0 Part 2, Appendix D, ISO 8601 Date and Time Formats</a>
 *   </li>
 * {@link java.util.Calendar#YEAR} = 1970,
 * {@link java.util.Calendar#MONTH} = {@link java.util.Calendar#JANUARY},
 * {@link java.util.Calendar#DATE} = 1, etc.
 * This is important as there are variations in the Gregorian Calendar,
 * e.g. leap years have different days in the month = {@link java.util.Calendar#FEBRUARY}
-* so the result of {@link Duration#getMonths()} can be influenced.</p>
+* so the result of {@link Duration#getMonths()} can be influenced.
 *
-* <p>Any remaining milliseconds after determining the year and month are discarded.</p>
+* <p>Any remaining milliseconds after determining the year and month are discarded.
 *
-* @param durationInMilliseconds Milliseconds of <code>Duration</code> to create.
+* @param durationInMilliseconds Milliseconds of {@code Duration} to create.
 *
-* @return New <code>Duration</code> created using the specified <code>durationInMilliseconds</code>.
+* @return New {@code Duration} created using the specified {@code durationInMilliseconds}.
 */
 public Duration newDurationYearMonth(
 final long durationInMilliseconds) {
 // create a Duration that only has sign, year & month
 return newDurationYearMonth(isPositive, years, months);
 }
 /**
-* <p>Create a <code>Duration</code> of type <code>xdt:yearMonthDuration</code> using the specified
+* Create a {@code Duration} of type {@code xdt:yearMonthDuration} using the specified
-* <code>year</code> and <code>month</code> as defined in
+* {@code year} and {@code month} as defined in
 * <a href="http://www.w3.org/TR/xpath-datamodel#yearMonthDuration">
-*   XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration</a>.</p>
+*   XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration</a>.
 *
 * <p>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.</p>
+* if implementation capacities are exceeded.
 *
-* <p>A <code>null</code> value indicates that field is not set.</p>
+* <p>A {@code null} value indicates that field is not set.
 *
-* @param isPositive Set to <code>false</code> to create a negative duration. When the length
+* @param isPositive Set to {@code false} to create a negative duration. When the length
 *   of the duration is zero, this parameter will be ignored.
-* @param year Year of <code>Duration</code>.
+* @param year Year of {@code Duration}.
-* @param month Month of <code>Duration</code>.
+* @param month Month of {@code Duration}.
 *
-* @return New <code>Duration</code> created using the specified <code>year</code> and <code>month</code>.
+* @return New {@code Duration} created using the specified {@code year} and {@code month}.
 *
 * @throws IllegalArgumentException If the values are not a valid representation of a
-* <code>Duration</code>: if all of the fields (year, month) are null or
+* {@code Duration}: if all of the fields (year, month) are null or
 * if any of the fields is negative.
 * @throws UnsupportedOperationException If implementation cannot support requested values.
 */
 public Duration newDurationYearMonth(
 final boolean isPositive,
 null  // seconds
 );
 }
 /**
-* <p>Create a <code>Duration</code> of type <code>xdt:yearMonthDuration</code> using the specified
+* Create a {@code Duration} of type {@code xdt:yearMonthDuration} using the specified
-* <code>year</code> and <code>month</code> as defined in
+* {@code year} and {@code month} as defined in
 * <a href="http://www.w3.org/TR/xpath-datamodel#yearMonthDuration">
-*   XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration</a>.</p>
+*   XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration</a>.
 *
-* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.</p>
+* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.
 *
-* @param isPositive Set to <code>false</code> to create a negative duration. When the length
+* @param isPositive Set to {@code false} to create a negative duration. When the length
 *   of the duration is zero, this parameter will be ignored.
-* @param year Year of <code>Duration</code>.
+* @param year Year of {@code Duration}.
-* @param month Month of <code>Duration</code>.
+* @param month Month of {@code Duration}.
 *
-* @return New <code>Duration</code> created using the specified <code>year</code> and <code>month</code>.
+* @return New {@code Duration} created using the specified {@code year} and {@code month}.
 *
 * @throws IllegalArgumentException If the values are not a valid representation of a
-* <code>Duration</code>: if any of the fields (year, month) is negative.
+* {@code Duration}: if any of the fields (year, month) is negative.
 */
 public Duration newDurationYearMonth(
 final boolean isPositive,
 final int year,
 final int month) {
 BigInteger.valueOf((long) year),
 BigInteger.valueOf((long) month));
 }
 /**
-* <p>Create a new instance of an <code>XMLGregorianCalendar</code>.</p>
+* Create a new instance of an {@code XMLGregorianCalendar}.
 *
-* <p>All date/time datatype fields set to {@link DatatypeConstants#FIELD_UNDEFINED} or null.</p>
+* <p>All date/time datatype fields set to {@link DatatypeConstants#FIELD_UNDEFINED} or null.
 *
-* @return New <code>XMLGregorianCalendar</code> with all date/time datatype fields set to
+* @return New {@code XMLGregorianCalendar} with all date/time datatype fields set to
 *   {@link DatatypeConstants#FIELD_UNDEFINED} or null.
 */
 public abstract XMLGregorianCalendar newXMLGregorianCalendar();
 /**
-* <p>Create a new XMLGregorianCalendar by parsing the String as a lexical representation.</p>
+* Create a new XMLGregorianCalendar by parsing the String as a lexical representation.
 *
 * <p>Parsing the lexical string representation is defined in
 * <a href="http://www.w3.org/TR/xmlschema-2/#dateTime-order">XML Schema 1.0 Part 2, Section 3.2.[7-14].1,
-* <em>Lexical Representation</em>.</a></p>
+* <em>Lexical Representation</em>.</a>
 *
-* <p>The string representation may not have any leading and trailing whitespaces.</p>
+* <p>The string representation may not have any leading and trailing whitespaces.
 *
 * <p>The parsing is done field by field so that
-* the following holds for any lexically correct String x:</p>
+* the following holds for any lexically correct String x:
 * <pre>
 * newXMLGregorianCalendar(x).toXMLFormat().equals(x)
 * </pre>
 * <p>Except for the noted lexical/canonical representation mismatches
 * listed in <a href="http://www.w3.org/2001/05/xmlschema-errata#e2-45">
-* XML Schema 1.0 errata, Section 3.2.7.2</a>.</p>
+* XML Schema 1.0 errata, Section 3.2.7.2</a>.
 *
 * @param lexicalRepresentation Lexical representation of one the eight XML Schema date/time datatypes.
 *
-* @return <code>XMLGregorianCalendar</code> created from the <code>lexicalRepresentation</code>.
+* @return {@code XMLGregorianCalendar} created from the {@code lexicalRepresentation}.
 *
-* @throws IllegalArgumentException If the <code>lexicalRepresentation</code> is not a valid <code>XMLGregorianCalendar</code>.
+* @throws IllegalArgumentException If the {@code lexicalRepresentation} is not a valid {@code XMLGregorianCalendar}.
-* @throws NullPointerException If <code>lexicalRepresentation</code> is <code>null</code>.
+* @throws NullPointerException If {@code lexicalRepresentation} is {@code null}.
 */
 public abstract XMLGregorianCalendar newXMLGregorianCalendar(final String lexicalRepresentation);
 /**
-* <p>Create an <code>XMLGregorianCalendar</code> from a {@link GregorianCalendar}.</p>
+* Create an {@code XMLGregorianCalendar} from a {@link GregorianCalendar}.
 *
 * <table border="2" rules="all" cellpadding="2">
 *   <thead>
 *     <tr>
 *       <th align="center" colspan="2">
 *          Field by Field Conversion from
 *          {@link GregorianCalendar} to an {@link XMLGregorianCalendar}
 *       </th>
 *     </tr>
 *     <tr>
-*        <th><code>java.util.GregorianCalendar</code> field</th>
+*        <th>{@code java.util.GregorianCalendar} field</th>
-*        <th><code>javax.xml.datatype.XMLGregorianCalendar</code> field</th>
+*        <th>{@code javax.xml.datatype.XMLGregorianCalendar} field</th>
 *     </tr>
 *   </thead>
 *   <tbody>
 *     <tr>
-*       <td><code>ERA == GregorianCalendar.BC ? -YEAR : YEAR</code></td>
+*       <td>{@code ERA == GregorianCalendar.BC ? -YEAR : YEAR}</td>
 *       <td>{@link XMLGregorianCalendar#setYear(int year)}</td>
 *     </tr>
 *     <tr>
-*       <td><code>MONTH + 1</code></td>
+*       <td>{@code MONTH + 1}</td>
 *       <td>{@link XMLGregorianCalendar#setMonth(int month)}</td>
 *     </tr>
 *     <tr>
-*       <td><code>DAY_OF_MONTH</code></td>
+*       <td>{@code DAY_OF_MONTH}</td>
 *       <td>{@link XMLGregorianCalendar#setDay(int day)}</td>
 *     </tr>
 *     <tr>
-*       <td><code>HOUR_OF_DAY, MINUTE, SECOND, MILLISECOND</code></td>
+*       <td>{@code HOUR_OF_DAY, MINUTE, SECOND, MILLISECOND}</td>
 *       <td>{@link XMLGregorianCalendar#setTime(int hour, int minute, int second, BigDecimal fractional)}</td>
 *     </tr>
 *     <tr>
 *       <td>
-*         <code>(ZONE_OFFSET + DST_OFFSET) / (60*1000)</code><br/>
+*         {@code (ZONE_OFFSET + DST_OFFSET) / (60*1000)}<br>
 *         <em>(in minutes)</em>
 *       </td>
 *       <td>{@link XMLGregorianCalendar#setTimezone(int offset)}<sup><em>*</em></sup>
 *       </td>
 *     </tr>
 *   </tbody>
 * </table>
 * <p><em>*</em>conversion loss of information. It is not possible to represent
-* a <code>java.util.GregorianCalendar</code> daylight savings timezone id in the
+* a {@code java.util.GregorianCalendar} daylight savings timezone id in the
-* XML Schema 1.0 date/time datatype representation.</p>
+* XML Schema 1.0 date/time datatype representation.
 *
-* <p>To compute the return value's <code>TimeZone</code> field,
+* <p>To compute the return value's {@code TimeZone} field,
 * <ul>
-* <li>when <code>this.getTimezone() != FIELD_UNDEFINED</code>,
+* <li>when {@code this.getTimezone() != FIELD_UNDEFINED},
-* create a <code>java.util.TimeZone</code> with a custom timezone id
+* create a {@code java.util.TimeZone} with a custom timezone id
-* using the <code>this.getTimezone()</code>.</li>
+* using the {@code this.getTimezone()}.</li>
-* <li>else use the <code>GregorianCalendar</code> default timezone value
+* <li>else use the {@code GregorianCalendar} default timezone value
 * for the host is defined as specified by
-* <code>java.util.TimeZone.getDefault()</code>.</li></p>
+* {@code java.util.TimeZone.getDefault()}.</li>
-*
+* </ul>
-* @param cal <code>java.util.GregorianCalendar</code> used to create <code>XMLGregorianCalendar</code>
+*
-*
+* @param cal {@code java.util.GregorianCalendar} used to create {@code XMLGregorianCalendar}
-* @return <code>XMLGregorianCalendar</code> created from <code>java.util.GregorianCalendar</code>
+*
-*
+* @return {@code XMLGregorianCalendar} created from {@code java.util.GregorianCalendar}
-* @throws NullPointerException If <code>cal</code> is <code>null</code>.
+*
+* @throws NullPointerException If {@code cal} is {@code null}.
 */
 public abstract XMLGregorianCalendar newXMLGregorianCalendar(final GregorianCalendar cal);
 /**
-* <p>Constructor allowing for complete value spaces allowed by
+* Constructor allowing for complete value spaces allowed by
 * W3C XML Schema 1.0 recommendation for xsd:dateTime and related
-* builtin datatypes. Note that <code>year</code> parameter supports
+* builtin datatypes. Note that {@code year} parameter supports
 * arbitrarily large numbers and fractionalSecond has infinite
-* precision.</p>
+* precision.
 *
-* <p>A <code>null</code> value indicates that field is not set.</p>
+* <p>A {@code null} value indicates that field is not set.
 *
-* @param year of <code>XMLGregorianCalendar</code> to be created.
+* @param year of {@code XMLGregorianCalendar} to be created.
-* @param month of <code>XMLGregorianCalendar</code> to be created.
+* @param month of {@code XMLGregorianCalendar} to be created.
-* @param day of <code>XMLGregorianCalendar</code> to be created.
+* @param day of {@code XMLGregorianCalendar} to be created.
-* @param hour of <code>XMLGregorianCalendar</code> to be created.
+* @param hour of {@code XMLGregorianCalendar} to be created.
-* @param minute of <code>XMLGregorianCalendar</code> to be created.
+* @param minute of {@code XMLGregorianCalendar} to be created.
-* @param second of <code>XMLGregorianCalendar</code> to be created.
+* @param second of {@code XMLGregorianCalendar} to be created.
-* @param fractionalSecond of <code>XMLGregorianCalendar</code> to be created.
+* @param fractionalSecond of {@code XMLGregorianCalendar} to be created.
-* @param timezone of <code>XMLGregorianCalendar</code> to be created.
+* @param timezone of {@code XMLGregorianCalendar} to be created.
 *
-* @return <code>XMLGregorianCalendar</code> created from specified values.
+* @return {@code XMLGregorianCalendar} created from specified values.
 *
 * @throws IllegalArgumentException If any individual parameter's value is outside the maximum value constraint for the field
 *   as determined by the Date/Time Data Mapping table in {@link XMLGregorianCalendar}
-*   or if the composite values constitute an invalid <code>XMLGregorianCalendar</code> instance
+*   or if the composite values constitute an invalid {@code XMLGregorianCalendar} instance
 *   as determined by {@link XMLGregorianCalendar#isValid()}.
 */
 public abstract XMLGregorianCalendar newXMLGregorianCalendar(
 final BigInteger year,
 final int month,
 final int second,
 final BigDecimal fractionalSecond,
 final int timezone);
 /**
-* <p>Constructor of value spaces that a
+* Constructor of value spaces that a
-* <code>java.util.GregorianCalendar</code> instance would need to convert to an
+* {@code java.util.GregorianCalendar} instance would need to convert to an
-* <code>XMLGregorianCalendar</code> instance.</p>
+* {@code XMLGregorianCalendar} instance.
 *
-* <p><code>XMLGregorianCalendar eon</code> and
+* <p>{@code XMLGregorianCalendar eon} and
-* <code>fractionalSecond</code> are set to <code>null</code></p>
+* {@code fractionalSecond} are set to {@code null}
 *
-* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.</p>
+* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.
 *
-* @param year of <code>XMLGregorianCalendar</code> to be created.
+* @param year of {@code XMLGregorianCalendar} to be created.
-* @param month of <code>XMLGregorianCalendar</code> to be created.
+* @param month of {@code XMLGregorianCalendar} to be created.
-* @param day of <code>XMLGregorianCalendar</code> to be created.
+* @param day of {@code XMLGregorianCalendar} to be created.
-* @param hour of <code>XMLGregorianCalendar</code> to be created.
+* @param hour of {@code XMLGregorianCalendar} to be created.
-* @param minute of <code>XMLGregorianCalendar</code> to be created.
+* @param minute of {@code XMLGregorianCalendar} to be created.
-* @param second of <code>XMLGregorianCalendar</code> to be created.
+* @param second of {@code XMLGregorianCalendar} to be created.
-* @param millisecond of <code>XMLGregorianCalendar</code> to be created.
+* @param millisecond of {@code XMLGregorianCalendar} to be created.
-* @param timezone of <code>XMLGregorianCalendar</code> to be created.
+* @param timezone of {@code XMLGregorianCalendar} to be created.
 *
-* @return <code>XMLGregorianCalendar</code> created from specified values.
+* @return {@code XMLGregorianCalendar} created from specified values.
 *
 * @throws IllegalArgumentException If any individual parameter's value is outside the maximum value constraint for the field
 *   as determined by the Date/Time Data Mapping table in {@link XMLGregorianCalendar}
-*   or if the composite values constitute an invalid <code>XMLGregorianCalendar</code> instance
+*   or if the composite values constitute an invalid {@code XMLGregorianCalendar} instance
 *   as determined by {@link XMLGregorianCalendar#isValid()}.
 */
 public XMLGregorianCalendar newXMLGregorianCalendar(
 final int year,
 final int month,
 timezone
 );
 }
 /**
-* <p>Create a Java representation of XML Schema builtin datatype <code>date</code> or <code>g*</code>.</p>
+* Create a Java representation of XML Schema builtin datatype {@code date} or {@code g*}.
 *
-* <p>For example, an instance of <code>gYear</code> can be created invoking this factory
+* <p>For example, an instance of {@code gYear} can be created invoking this factory
-* with <code>month</code> and <code>day</code> parameters set to
+* with {@code month} and {@code day} parameters set to
-* {@link DatatypeConstants#FIELD_UNDEFINED}.</p>
+* {@link DatatypeConstants#FIELD_UNDEFINED}.
 *
-* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.</p>
+* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.
 *
-* @param year of <code>XMLGregorianCalendar</code> to be created.
+* @param year of {@code XMLGregorianCalendar} to be created.
-* @param month of <code>XMLGregorianCalendar</code> to be created.
+* @param month of {@code XMLGregorianCalendar} to be created.
-* @param day of <code>XMLGregorianCalendar</code> to be created.
+* @param day of {@code XMLGregorianCalendar} to be created.
 * @param timezone offset in minutes. {@link DatatypeConstants#FIELD_UNDEFINED} indicates optional field is not set.
 *
-* @return <code>XMLGregorianCalendar</code> created from parameter values.
+* @return {@code XMLGregorianCalendar} created from parameter values.
 *
 * @see DatatypeConstants#FIELD_UNDEFINED
 *
 * @throws IllegalArgumentException If any individual parameter's value is outside the maximum value constraint for the field
 *   as determined by the Date/Time Data Mapping table in {@link XMLGregorianCalendar}
-*   or if the composite values constitute an invalid <code>XMLGregorianCalendar</code> instance
+*   or if the composite values constitute an invalid {@code XMLGregorianCalendar} instance
 *   as determined by {@link XMLGregorianCalendar#isValid()}.
 */
 public XMLGregorianCalendar newXMLGregorianCalendarDate(
 final int year,
 final int month,
 DatatypeConstants.FIELD_UNDEFINED, // millisecond
 timezone);
 }
 /**
-* <p>Create a Java instance of XML Schema builtin datatype <code>time</code>.</p>
+* Create a Java instance of XML Schema builtin datatype {@code time}.
 *
-* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.</p>
+* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.
 *
 * @param hours number of hours
 * @param minutes number of minutes
 * @param seconds number of seconds
 * @param timezone offset in minutes. {@link DatatypeConstants#FIELD_UNDEFINED} indicates optional field is not set.
 *
-* @return <code>XMLGregorianCalendar</code> created from parameter values.
+* @return {@code XMLGregorianCalendar} created from parameter values.
 *
 * @throws IllegalArgumentException If any individual parameter's value is outside the maximum value constraint for the field
 *   as determined by the Date/Time Data Mapping table in {@link XMLGregorianCalendar}
-*   or if the composite values constitute an invalid <code>XMLGregorianCalendar</code> instance
+*   or if the composite values constitute an invalid {@code XMLGregorianCalendar} instance
 *   as determined by {@link XMLGregorianCalendar#isValid()}.
 *
 * @see DatatypeConstants#FIELD_UNDEFINED
 */
 public XMLGregorianCalendar newXMLGregorianCalendarTime(
 DatatypeConstants.FIELD_UNDEFINED, //Millisecond
 timezone);
 }
 /**
-* <p>Create a Java instance of XML Schema builtin datatype time.</p>
+* Create a Java instance of XML Schema builtin datatype time.
 *
-* <p>A <code>null</code> value indicates that field is not set.</p>
+* <p>A {@code null} value indicates that field is not set.
-* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.</p>
+* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.
 *
 * @param hours number of hours
 * @param minutes number of minutes
 * @param seconds number of seconds
-* @param fractionalSecond value of <code>null</code> indicates that this optional field is not set.
+* @param fractionalSecond value of {@code null} indicates that this optional field is not set.
 * @param timezone offset in minutes. {@link DatatypeConstants#FIELD_UNDEFINED} indicates optional field is not set.
 *
-* @return <code>XMLGregorianCalendar</code> created from parameter values.
+* @return {@code XMLGregorianCalendar} created from parameter values.
 *
 * @see DatatypeConstants#FIELD_UNDEFINED
 *
 * @throws IllegalArgumentException If any individual parameter's value is outside the maximum value constraint for the field
 *   as determined by the Date/Time Data Mapping table in {@link XMLGregorianCalendar}
-*   or if the composite values constitute an invalid <code>XMLGregorianCalendar</code> instance
+*   or if the composite values constitute an invalid {@code XMLGregorianCalendar} instance
 *   as determined by {@link XMLGregorianCalendar#isValid()}.
 */
 public XMLGregorianCalendar newXMLGregorianCalendarTime(
 final int hours,
 final int minutes,
 fractionalSecond,
 timezone);
 }
 /**
-* <p>Create a Java instance of XML Schema builtin datatype time.</p>
+* Create a Java instance of XML Schema builtin datatype time.
 *
-* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.</p>
+* <p>A {@link DatatypeConstants#FIELD_UNDEFINED} value indicates that field is not set.
 *
 * @param hours number of hours
 * @param minutes number of minutes
 * @param seconds number of seconds
 * @param milliseconds number of milliseconds
 * @param timezone offset in minutes. {@link DatatypeConstants#FIELD_UNDEFINED} indicates optional field is not set.
 *
-* @return <code>XMLGregorianCalendar</code> created from parameter values.
+* @return {@code XMLGregorianCalendar} created from parameter values.
 *
 * @see DatatypeConstants#FIELD_UNDEFINED
 *
 * @throws IllegalArgumentException If any individual parameter's value is outside the maximum value constraint for the field
 *   as determined by the Date/Time Data Mapping table in {@link XMLGregorianCalendar}
-*   or if the composite values constitute an invalid <code>XMLGregorianCalendar</code> instance
+*   or if the composite values constitute an invalid {@code XMLGregorianCalendar} instance
 *   as determined by {@link XMLGregorianCalendar#isValid()}.
 */
 public XMLGregorianCalendar newXMLGregorianCalendarTime(
 final int hours,
 final int minutes,

changeset 29999	8493f5fc1052
parent 29419	534054ee6062
child 42390	4083bc2c3b5b