From 36e5709ea3aa60c15a4f98909af2e25bb13e4bb8 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Fri, 14 Aug 2026 18:35:29 -0500 Subject: [PATCH 1/3] Document XML datatype APIs Refs #272 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../Javax.Xml.Datatype/DatatypeFactory.xml | 6 ++-- docs/xml/Javax.Xml.Datatype/Duration.xml | 4 +-- .../XMLGregorianCalendar.xml | 28 +++++++++---------- 3 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/xml/Javax.Xml.Datatype/DatatypeFactory.xml b/docs/xml/Javax.Xml.Datatype/DatatypeFactory.xml index bce1bd74b..8f3fd1762 100644 --- a/docs/xml/Javax.Xml.Datatype/DatatypeFactory.xml +++ b/docs/xml/Javax.Xml.Datatype/DatatypeFactory.xml @@ -144,7 +144,7 @@ Default implementation class name as defined in JSR 206: Java(TM) API for XML Processing (JAXP) 1. - To be added. + The default implementation class name. Default implementation class name as defined in JSR 206: Java(TM) API for XML Processing (JAXP) 1.3. Default value is org.apache.xerces.jaxp.datatype.DatatypeFactoryImpl. @@ -1063,8 +1063,8 @@ - To be added. - To be added. + The fully qualified name of the factory class that provides the javax.xml.datatype.DatatypeFactory implementation. + The ClassLoader used to load the factory class. If , the current thread's context class loader is used. Returns an instance of the named implementation of DatatypeFactory. New instance of a <code>DocumentBuilderFactory</code> diff --git a/docs/xml/Javax.Xml.Datatype/Duration.xml b/docs/xml/Javax.Xml.Datatype/Duration.xml index 4c5785a4a..354ce95e3 100644 --- a/docs/xml/Javax.Xml.Datatype/Duration.xml +++ b/docs/xml/Javax.Xml.Datatype/Duration.xml @@ -489,7 +489,7 @@ Returns a hash code consistent with the definition of the equals method. - To be added. + A hash code consistent with the definition of Equals. Returns a hash code consistent with the definition of the equals method. @@ -1241,7 +1241,7 @@ Returns the sign of this duration in -1,0, or 1. - To be added. + -1 if this duration is negative, 0 if it is zero, or 1 if it is positive. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Javax.Xml.Datatype/XMLGregorianCalendar.xml b/docs/xml/Javax.Xml.Datatype/XMLGregorianCalendar.xml index c4e94e170..11e7347a7 100644 --- a/docs/xml/Javax.Xml.Datatype/XMLGregorianCalendar.xml +++ b/docs/xml/Javax.Xml.Datatype/XMLGregorianCalendar.xml @@ -421,7 +421,7 @@ - To be added. + The day of month, from 1 to 31, or DatatypeConstants.FieldUndefined if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -455,7 +455,7 @@ - To be added. + The high-order component of the year, expressed as a multiple of 10^9, or if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -486,7 +486,7 @@ - To be added. + The sum of the eon and year when both are defined; the year when only it is defined; otherwise, . Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -521,7 +521,7 @@ - To be added. + The fractional seconds, or if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -608,7 +608,7 @@ Return hours or . - To be added. + The hour of day, from 0 to 23, or DatatypeConstants.FieldUndefined if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -640,7 +640,7 @@ Validate instance by getXMLSchemaType() constraints. - To be added. + if the data values are valid; otherwise, . Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -763,7 +763,7 @@ Returns if this field is not defined. - To be added. + The month, from 1 to 12, or DatatypeConstants.FieldUndefined if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -800,7 +800,7 @@ - To be added. + The second of minute, from 0 to 59, or DatatypeConstants.FieldUndefined if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -966,7 +966,7 @@ - To be added. + The timezone offset in minutes, or DatatypeConstants.FieldUndefined if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -1324,7 +1324,7 @@ Return timezone offset in minutes or if this optional field is not defined. - To be added. + The timezone offset in minutes, or DatatypeConstants.FieldUndefined if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -1358,7 +1358,7 @@ Convert this XMLGregorianCalendar to a GregorianCalendar. - To be added. + A instance. Convert this XMLGregorianCalendar to a GregorianCalendar. When this instance has an undefined field, this @@ -1600,8 +1600,8 @@ Javax.Xml.Namespace.QName - To be added. - To be added. + Returns the XML Schema date/time datatype name for this calendar. + The for this XML Schema date/time datatype. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -1637,7 +1637,7 @@ - To be added. + The low-order component of the year, or DatatypeConstants.FieldUndefined if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. From ee326a0c574cc0e7ea9e076b4137912e0cd32ff5 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Fri, 14 Aug 2026 18:46:28 -0500 Subject: [PATCH 2/3] Link undefined calendar fields Refs #272 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../Javax.Xml.Datatype/XMLGregorianCalendar.xml | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/xml/Javax.Xml.Datatype/XMLGregorianCalendar.xml b/docs/xml/Javax.Xml.Datatype/XMLGregorianCalendar.xml index 11e7347a7..86c254dac 100644 --- a/docs/xml/Javax.Xml.Datatype/XMLGregorianCalendar.xml +++ b/docs/xml/Javax.Xml.Datatype/XMLGregorianCalendar.xml @@ -421,7 +421,7 @@ - The day of month, from 1 to 31, or DatatypeConstants.FieldUndefined if undefined. + The day of month, from 1 to 31, or if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -608,7 +608,7 @@ Return hours or . - The hour of day, from 0 to 23, or DatatypeConstants.FieldUndefined if undefined. + The hour of day, from 0 to 23, or if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -763,7 +763,7 @@ Returns if this field is not defined. - The month, from 1 to 12, or DatatypeConstants.FieldUndefined if undefined. + The month, from 1 to 12, or if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -800,7 +800,7 @@ - The second of minute, from 0 to 59, or DatatypeConstants.FieldUndefined if undefined. + The second of minute, from 0 to 59, or if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -966,7 +966,7 @@ - The timezone offset in minutes, or DatatypeConstants.FieldUndefined if undefined. + The timezone offset in minutes, or if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -1324,7 +1324,7 @@ Return timezone offset in minutes or if this optional field is not defined. - The timezone offset in minutes, or DatatypeConstants.FieldUndefined if undefined. + The timezone offset in minutes, or if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -1637,7 +1637,7 @@ - The low-order component of the year, or DatatypeConstants.FieldUndefined if undefined. + The low-order component of the year, or if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. From 78551df05ad9529abe3db55184465a0e5c591805 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sat, 15 Aug 2026 09:33:02 -0500 Subject: [PATCH 3/3] Correct XML datatype contracts Refs #272 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/xml/Javax.Xml.Datatype/DatatypeFactory.xml | 2 +- docs/xml/Javax.Xml.Datatype/XMLGregorianCalendar.xml | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/xml/Javax.Xml.Datatype/DatatypeFactory.xml b/docs/xml/Javax.Xml.Datatype/DatatypeFactory.xml index 8f3fd1762..1093f1c4b 100644 --- a/docs/xml/Javax.Xml.Datatype/DatatypeFactory.xml +++ b/docs/xml/Javax.Xml.Datatype/DatatypeFactory.xml @@ -1066,7 +1066,7 @@ The fully qualified name of the factory class that provides the javax.xml.datatype.DatatypeFactory implementation. The ClassLoader used to load the factory class. If , the current thread's context class loader is used. Returns an instance of the named implementation of DatatypeFactory. - New instance of a <code>DocumentBuilderFactory</code> + A new instance of DatatypeFactory. Returns an instance of the named implementation of DatatypeFactory. Added in 1.6. diff --git a/docs/xml/Javax.Xml.Datatype/XMLGregorianCalendar.xml b/docs/xml/Javax.Xml.Datatype/XMLGregorianCalendar.xml index 86c254dac..792fd50e2 100644 --- a/docs/xml/Javax.Xml.Datatype/XMLGregorianCalendar.xml +++ b/docs/xml/Javax.Xml.Datatype/XMLGregorianCalendar.xml @@ -608,7 +608,7 @@ Return hours or . - The hour of day, from 0 to 23, or if undefined. + The hour of day, from 0 to 24, or if undefined. When the value is 24, the minute and second values must be zero. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -763,7 +763,7 @@ Returns if this field is not defined. - The month, from 1 to 12, or if undefined. + The minute of hour, from 0 to 59, or if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -800,7 +800,7 @@ - The second of minute, from 0 to 59, or if undefined. + The month, from 1 to 12, or if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -966,7 +966,7 @@ - The timezone offset in minutes, or if undefined. + The second of minute, from 0 to 59, or if undefined. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.