From cc080d6d253028a88cc3e8f881c3fd57ef108bf6 Mon Sep 17 00:00:00 2001 From: singingbush Date: Mon, 24 Nov 2025 21:51:59 +0000 Subject: [PATCH 1/2] [XERCESJ-1781] fine tuning Javadoc linting --- build.xml | 84 ++++++++++++------- .../xerces/impl/xpath/regex/REUtil.java | 2 +- .../xerces/impl/xs/models/XSCMValidator.java | 20 ++--- .../xerces/xs/datatypes/XSDateTime.java | 3 +- 4 files changed, 65 insertions(+), 44 deletions(-) diff --git a/build.xml b/build.xml index a9fb5c6189..7e98411991 100644 --- a/build.xml +++ b/build.xml @@ -28,7 +28,7 @@ Authors: ==================================================================== --> - + @@ -92,8 +92,8 @@ Authors: - - + + @@ -179,10 +179,10 @@ Authors: - + - + @@ -198,11 +198,11 @@ Authors: - - - + - + @@ -494,29 +494,29 @@ Authors:
INTERNAL:
Usage of this class is not supported. It may be altered or removed at any time.
]]> - +
EXPERIMENTAL:
This class should not be considered stable. It is likely to be altered or replaced in the future.
]]> - + - - + + - + - + - + + failonerror='no' + failonwarning='no' + > + + + failonerror='yes' + failonwarning='yes' + > + + + failonerror='yes' + failonwarning='yes' + > + + + failonerror='no' + failonwarning='no' + > + + + failonerror='yes' + failonwarning='yes' + > + + @@ -1075,7 +1095,7 @@ Authors: - + @@ -1203,7 +1223,7 @@ Authors: token="return ((XSComplexTypeDecl) type).isDOMDerivedFrom(" value="return false;"/> - + @@ -1221,7 +1241,7 @@ Authors: token="((org.apache.xerces.impl.xs.opti.NodeImpl)node).setReadOnly(false, false);" value="return;"/> - + @@ -1247,7 +1267,7 @@ Authors: token="(XSGrammarPoolContainer) grammar, fSchemaValidationManager);" value=""/> - + - + - + @@ -1572,10 +1592,10 @@ Authors: - + - + - + Usage: org.apache.xerces.utils.regex.REUtil <regex> <string> + *

Usage: org.apache.xerces.utils.regex.REUtil <regex> <string>

*/ public static void main(String[] argv) { String pattern = null; diff --git a/src/org/apache/xerces/impl/xs/models/XSCMValidator.java b/src/org/apache/xerces/impl/xs/models/XSCMValidator.java index 9597aca338..a2fe4fe7ce 100644 --- a/src/org/apache/xerces/impl/xs/models/XSCMValidator.java +++ b/src/org/apache/xerces/impl/xs/models/XSCMValidator.java @@ -54,8 +54,9 @@ public interface XSCMValidator { /** * The method corresponds to one transaction in the content model. * - * @param elementName - * @param state Current state + * @param elementName the element's qualified name + * @param state current state of the content model + * @param subGroupHandler the substitution group handler * @return element decl or wildcard decl that * corresponds to the element from the Schema grammar */ @@ -94,14 +95,13 @@ public interface XSCMValidator { * or null if no occurrence counting was being performed at the * current state.

* - *

If an array is returned it will have a length == 4 and will contain: - *

    - *
  • a[0] :: min occurs
    • - *
  • a[1] :: max occurs
    • - *
  • a[2] :: current value of the counter
    • - *
  • a[3] :: identifier for the repeating term
    • - *
- *

+ *

If an array is returned it will have a length == 4 and will contain:

+ *
    + *
  • a[0] :: min occurs
    • + *
  • a[1] :: max occurs
    • + *
  • a[2] :: current value of the counter
    • + *
  • a[3] :: identifier for the repeating term
    • + *
* * @param state the current state * @return an array containing information about the current repeating term diff --git a/src/org/apache/xerces/xs/datatypes/XSDateTime.java b/src/org/apache/xerces/xs/datatypes/XSDateTime.java index 147fbf1cea..c1e35f6e53 100644 --- a/src/org/apache/xerces/xs/datatypes/XSDateTime.java +++ b/src/org/apache/xerces/xs/datatypes/XSDateTime.java @@ -24,8 +24,9 @@ * table shows the methods defined for various XML Schema 1.0 built-in types. 'X' * marks whether a particular method is defined for a particular type. Accessing undefined * methods may return unexpected values. - * + * * + * * * * From a58ab26664f16335661fd9b57f074bdbdb30edc1 Mon Sep 17 00:00:00 2001 From: singingbush Date: Tue, 25 Nov 2025 07:51:24 +0000 Subject: [PATCH 2/2] [XERCESJ-1781] fine tuning Javadoc linting --- build.xml | 4 ++-- src/org/apache/xerces/xs/datatypes/package.html | 2 ++ 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/build.xml b/build.xml index 7e98411991..c4e80073a4 100644 --- a/build.xml +++ b/build.xml @@ -92,8 +92,8 @@ Authors: - - + + diff --git a/src/org/apache/xerces/xs/datatypes/package.html b/src/org/apache/xerces/xs/datatypes/package.html index c866494cba..5fcf2e4cf7 100644 --- a/src/org/apache/xerces/xs/datatypes/package.html +++ b/src/org/apache/xerces/xs/datatypes/package.html @@ -27,6 +27,7 @@

Mappings between XML Schema 1.0 date-time related types and their supported accessors
XML Schema Datatype getYears()
+ @@ -225,6 +226,7 @@


Mappings between XML Schema Data Type and applicable interfaces
XML Schema Data Type
+
Mappings between XML Schema Data Type and applicable method in XSDateTime*
XML Schema Data Type