This is an automated email from the ASF dual-hosted git repository.
elharo pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/xerces-j.git
The following commit(s) were added to refs/heads/main by this push:
new cc2d00c03 [XERCESJ-1781] Javadoc fixes in org.apache.wml.* (#49)
cc2d00c03 is described below
commit cc2d00c0352364ae03a4cbd3cf81bb783e516c6f
Author: Samael <[email protected]>
AuthorDate: Fri Nov 21 23:50:09 2025 +0000
[XERCESJ-1781] Javadoc fixes in org.apache.wml.* (#49)
* [XERCESJ-1781] Javadoc fixes in org.apache.xml.*
[XERCESJ-1781] Javadoc fixes in org.apache.xml.*
[XERCESJ-1781] Javadoc fixes in org.apache.xml.*
* [XERCESJ-1781] Javadoc fixes in org.apache.xml.*
---
src/org/apache/wml/WMLAElement.java | 9 +++++++--
src/org/apache/wml/WMLAnchorElement.java | 4 +++-
src/org/apache/wml/WMLBElement.java | 4 +++-
src/org/apache/wml/WMLBigElement.java | 4 +++-
src/org/apache/wml/WMLBrElement.java | 4 +++-
src/org/apache/wml/WMLCardElement.java | 4 +++-
src/org/apache/wml/WMLDoElement.java | 2 ++
src/org/apache/wml/WMLElement.java | 4 ++++
src/org/apache/wml/WMLEmElement.java | 2 ++
src/org/apache/wml/WMLFieldsetElement.java | 2 ++
src/org/apache/wml/WMLIElement.java | 2 ++
src/org/apache/wml/WMLImgElement.java | 2 ++
src/org/apache/wml/WMLInputElement.java | 4 +++-
src/org/apache/wml/WMLOptgroupElement.java | 4 +++-
src/org/apache/wml/WMLOptionElement.java | 4 +++-
src/org/apache/wml/WMLPElement.java | 2 ++
src/org/apache/wml/WMLSelectElement.java | 4 +++-
src/org/apache/wml/WMLSmallElement.java | 2 ++
src/org/apache/wml/WMLStrongElement.java | 2 ++
src/org/apache/wml/WMLTableElement.java | 2 ++
src/org/apache/wml/WMLTdElement.java | 2 ++
src/org/apache/wml/WMLUElement.java | 2 ++
src/org/apache/wml/WMLWmlElement.java | 2 ++
23 files changed, 62 insertions(+), 11 deletions(-)
diff --git a/src/org/apache/wml/WMLAElement.java
b/src/org/apache/wml/WMLAElement.java
index eba5c8f2f..21e9cd347 100644
--- a/src/org/apache/wml/WMLAElement.java
+++ b/src/org/apache/wml/WMLAElement.java
@@ -39,8 +39,13 @@ public interface WMLAElement extends WMLElement {
/**
* 'xml:lang' specifics the natural or formal language in which
- * the document is written.
- * (Section 8.8, WAP WML Version 16-Jun-1999)
+ * the document is written.
+ * <p>
+ * Language identifiers are defined in <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a>
+ * </p>
+ * <p>(Section 8.8, WAP WML Version 16-Jun-1999)</p>
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLAnchorElement.java
b/src/org/apache/wml/WMLAnchorElement.java
index 80088cbaa..f8c3fc395 100644
--- a/src/org/apache/wml/WMLAnchorElement.java
+++ b/src/org/apache/wml/WMLAnchorElement.java
@@ -34,7 +34,9 @@ public interface WMLAnchorElement extends WMLElement {
/**
* 'xml:lang' specifics the natural or formal language in which
* the document is written.
- * (Section 8.8, WAP WML Version 16-Jun-1999)
+ * (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLBElement.java
b/src/org/apache/wml/WMLBElement.java
index 46c0cbe52..0503b8089 100644
--- a/src/org/apache/wml/WMLBElement.java
+++ b/src/org/apache/wml/WMLBElement.java
@@ -33,7 +33,9 @@ public interface WMLBElement extends WMLElement {
/**
* 'xml:lang' specifics the natural or formal language in which
* the document is written.
- * (Section 8.8, WAP WML Version 16-Jun-1999)
+ * (Section 8.8, WAP WML Version 16-Jun-1999).
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLBigElement.java
b/src/org/apache/wml/WMLBigElement.java
index 788c11d72..9ca2a9a05 100644
--- a/src/org/apache/wml/WMLBigElement.java
+++ b/src/org/apache/wml/WMLBigElement.java
@@ -33,7 +33,9 @@ public interface WMLBigElement extends WMLElement {
/**
* 'xml:lang' specifics the natural or formal language in which
* the document is written.
- * (Section 8.8, WAP WML Version 16-Jun-1999)
+ * (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLBrElement.java
b/src/org/apache/wml/WMLBrElement.java
index 8c9f83d07..133a9a886 100644
--- a/src/org/apache/wml/WMLBrElement.java
+++ b/src/org/apache/wml/WMLBrElement.java
@@ -32,7 +32,9 @@ public interface WMLBrElement extends WMLElement {
/**
* 'xml:lang' specifics the natural or formal language in which
* the document is written.
- * (Section 8.8, WAP WML Version 16-Jun-1999)
+ * (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLCardElement.java
b/src/org/apache/wml/WMLCardElement.java
index 7750eb882..3eb6a7ab2 100644
--- a/src/org/apache/wml/WMLCardElement.java
+++ b/src/org/apache/wml/WMLCardElement.java
@@ -81,7 +81,9 @@ public interface WMLCardElement extends WMLElement {
/**
* 'xml:lang' specifics the natural or formal language in which
* the document is written.
- * (Section 8.8, WAP WML Version 16-Jun-1999)
+ * (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLDoElement.java
b/src/org/apache/wml/WMLDoElement.java
index baf747434..4ac264c0d 100644
--- a/src/org/apache/wml/WMLDoElement.java
+++ b/src/org/apache/wml/WMLDoElement.java
@@ -44,6 +44,8 @@ public interface WMLDoElement extends WMLElement {
* The xml:lang that specifics the natural or formal language in
* which the document is written.
* (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLElement.java
b/src/org/apache/wml/WMLElement.java
index 5ba52cf26..d709f0b5d 100644
--- a/src/org/apache/wml/WMLElement.java
+++ b/src/org/apache/wml/WMLElement.java
@@ -36,6 +36,8 @@ public interface WMLElement extends Element {
/**
* The element's identifier which is unique in a single deck.
* (Section 8.9, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue set an identifier value for the element
*/
public void setId(String newValue);
public String getId();
@@ -44,6 +46,8 @@ public interface WMLElement extends Element {
* The 'class' attribute of a element that affiliates an elements
* with one or more elements.
* (Section 8.9, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue set a class name for the element
*/
public void setClassName(String newValue);
public String getClassName();
diff --git a/src/org/apache/wml/WMLEmElement.java
b/src/org/apache/wml/WMLEmElement.java
index 2fadfc925..5353a52ed 100644
--- a/src/org/apache/wml/WMLEmElement.java
+++ b/src/org/apache/wml/WMLEmElement.java
@@ -34,6 +34,8 @@ public interface WMLEmElement extends WMLElement {
* The xml:lang that specifics the natural or formal language in
* which the document is written.
* (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLFieldsetElement.java
b/src/org/apache/wml/WMLFieldsetElement.java
index 728f439e7..81aa40f5c 100644
--- a/src/org/apache/wml/WMLFieldsetElement.java
+++ b/src/org/apache/wml/WMLFieldsetElement.java
@@ -41,6 +41,8 @@ public interface WMLFieldsetElement extends WMLElement {
* The xml:lang that specifics the natural or formal language in
* which the document is written.
* (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLIElement.java
b/src/org/apache/wml/WMLIElement.java
index 09fe87279..7a866a259 100644
--- a/src/org/apache/wml/WMLIElement.java
+++ b/src/org/apache/wml/WMLIElement.java
@@ -34,6 +34,8 @@ public interface WMLIElement extends WMLElement {
* The xml:lang that specifics the natural or formal language in
* which the document is written.
* (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLImgElement.java
b/src/org/apache/wml/WMLImgElement.java
index fba6649a6..a11397db0 100644
--- a/src/org/apache/wml/WMLImgElement.java
+++ b/src/org/apache/wml/WMLImgElement.java
@@ -95,6 +95,8 @@ public interface WMLImgElement extends WMLElement {
* The xml:lang that specifics the natural or formal language in
* which the document is written.
* (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLInputElement.java
b/src/org/apache/wml/WMLInputElement.java
index cef13fd11..fab96521c 100644
--- a/src/org/apache/wml/WMLInputElement.java
+++ b/src/org/apache/wml/WMLInputElement.java
@@ -100,7 +100,9 @@ public interface WMLInputElement extends WMLElement {
/**
* 'xml:lang' specifics the natural or formal language in which
* the document is written.
- * (Section 8.8, WAP WML Version 16-Jun-1999)
+ * (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLOptgroupElement.java
b/src/org/apache/wml/WMLOptgroupElement.java
index 22c801a16..a431f029f 100644
--- a/src/org/apache/wml/WMLOptgroupElement.java
+++ b/src/org/apache/wml/WMLOptgroupElement.java
@@ -41,7 +41,9 @@ public interface WMLOptgroupElement extends WMLElement {
/**
* 'xml:lang' specifics the natural or formal language in which
* the document is written.
- * (Section 8.8, WAP WML Version 16-Jun-1999)
+ * (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLOptionElement.java
b/src/org/apache/wml/WMLOptionElement.java
index 2533331b0..f27000038 100644
--- a/src/org/apache/wml/WMLOptionElement.java
+++ b/src/org/apache/wml/WMLOptionElement.java
@@ -54,7 +54,9 @@ public interface WMLOptionElement extends WMLElement {
/**
* 'xml:lang' specifics the natural or formal language in which
* the document is written.
- * (Section 8.8, WAP WML Version 16-Jun-1999)
+ * (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLPElement.java
b/src/org/apache/wml/WMLPElement.java
index ee3a94927..1b71b0a47 100644
--- a/src/org/apache/wml/WMLPElement.java
+++ b/src/org/apache/wml/WMLPElement.java
@@ -51,6 +51,8 @@ public interface WMLPElement extends WMLElement {
* The xml:lang that specifics the natural or formal language in
* which the document is written.
* (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLSelectElement.java
b/src/org/apache/wml/WMLSelectElement.java
index bcd164a17..ea475af89 100644
--- a/src/org/apache/wml/WMLSelectElement.java
+++ b/src/org/apache/wml/WMLSelectElement.java
@@ -83,7 +83,9 @@ public interface WMLSelectElement extends WMLElement {
/**
* 'xml:lang' specifics the natural or formal language in which
* the document is written.
- * (Section 8.8, WAP WML Version 16-Jun-1999)
+ * (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLSmallElement.java
b/src/org/apache/wml/WMLSmallElement.java
index 74e5ccf79..8e8799951 100644
--- a/src/org/apache/wml/WMLSmallElement.java
+++ b/src/org/apache/wml/WMLSmallElement.java
@@ -34,6 +34,8 @@ public interface WMLSmallElement extends WMLElement {
* The xml:lang that specifics the natural or formal language in
* which the document is written.
* (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLStrongElement.java
b/src/org/apache/wml/WMLStrongElement.java
index f946d6c4c..ad3d8f5a9 100644
--- a/src/org/apache/wml/WMLStrongElement.java
+++ b/src/org/apache/wml/WMLStrongElement.java
@@ -34,6 +34,8 @@ public interface WMLStrongElement extends WMLElement {
* The xml:lang that specifics the natural or formal language in
* which the document is written.
* (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLTableElement.java
b/src/org/apache/wml/WMLTableElement.java
index 595013698..2b0c6a620 100644
--- a/src/org/apache/wml/WMLTableElement.java
+++ b/src/org/apache/wml/WMLTableElement.java
@@ -56,6 +56,8 @@ public interface WMLTableElement extends WMLElement {
* The xml:lang that specifics the natural or formal language in
* which the document is written.
* (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLTdElement.java
b/src/org/apache/wml/WMLTdElement.java
index dd64927e4..178e3d8f7 100644
--- a/src/org/apache/wml/WMLTdElement.java
+++ b/src/org/apache/wml/WMLTdElement.java
@@ -34,6 +34,8 @@ public interface WMLTdElement extends WMLElement {
* The xml:lang that specifics the natural or formal language in
* which the document is written.
* (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLUElement.java
b/src/org/apache/wml/WMLUElement.java
index 90ef07804..3fc4ebb78 100644
--- a/src/org/apache/wml/WMLUElement.java
+++ b/src/org/apache/wml/WMLUElement.java
@@ -34,6 +34,8 @@ public interface WMLUElement extends WMLElement {
* The xml:lang that specifics the natural or formal language in
* which the document is written.
* (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
diff --git a/src/org/apache/wml/WMLWmlElement.java
b/src/org/apache/wml/WMLWmlElement.java
index 9de3d144f..9bdce672e 100644
--- a/src/org/apache/wml/WMLWmlElement.java
+++ b/src/org/apache/wml/WMLWmlElement.java
@@ -34,6 +34,8 @@ public interface WMLWmlElement extends WMLElement {
* The xml:lang that specifics the natural or formal language in
* which the document is written.
* (Section 8.8, WAP WML Version 16-Jun-1999)
+ *
+ * @param newValue a language identifier as defined by <a
href="https://www.w3.org/TR/xml/#RFC1766";>IETF BCP 47</a> or an empty string
*/
public void setXmlLang(String newValue);
public String getXmlLang();
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
