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 b29872bb6 [XERCES-1781] part 2 (split out from #28) (#32)
b29872bb6 is described below
commit b29872bb619e3d25bc06b6d3d0c4f48f11d45344
Author: Samael <[email protected]>
AuthorDate: Mon Oct 20 12:56:33 2025 +0100
[XERCES-1781] part 2 (split out from #28) (#32)
---
src/org/apache/html/dom/HTMLAnchorElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLAppletElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLAreaElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLBRElementImpl.java | 3 +-
src/org/apache/html/dom/HTMLBaseElementImpl.java | 5 +-
.../apache/html/dom/HTMLBaseFontElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLBodyElementImpl.java | 7 +--
src/org/apache/html/dom/HTMLButtonElementImpl.java | 3 +-
src/org/apache/html/dom/HTMLCollectionImpl.java | 63 +++++++++++-----------
src/org/apache/html/dom/HTMLDListElementImpl.java | 7 +--
.../apache/html/dom/HTMLDOMImplementationImpl.java | 8 +--
.../apache/html/dom/HTMLDirectoryElementImpl.java | 7 +--
src/org/apache/html/dom/HTMLDivElementImpl.java | 7 +--
src/org/apache/html/dom/HTMLDocumentImpl.java | 35 ++++++------
src/org/apache/html/dom/HTMLElementImpl.java | 18 ++++---
.../apache/html/dom/HTMLFieldSetElementImpl.java | 3 +-
src/org/apache/html/dom/HTMLFormElementImpl.java | 3 +-
src/org/apache/html/dom/HTMLFrameElementImpl.java | 3 +-
.../apache/html/dom/HTMLFrameSetElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLHRElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLHeadElementImpl.java | 5 +-
.../apache/html/dom/HTMLHeadingElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLHtmlElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLIFrameElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLImageElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLInputElementImpl.java | 5 +-
.../apache/html/dom/HTMLIsIndexElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLLIElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLLabelElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLLegendElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLLinkElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLMapElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLMenuElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLMetaElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLModElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLOListElementImpl.java | 7 +--
src/org/apache/html/dom/HTMLObjectElementImpl.java | 5 +-
.../apache/html/dom/HTMLOptGroupElementImpl.java | 7 +--
src/org/apache/html/dom/HTMLOptionElementImpl.java | 5 +-
.../apache/html/dom/HTMLParagraphElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLParamElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLPreElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLQuoteElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLScriptElementImpl.java | 7 +--
src/org/apache/html/dom/HTMLSelectElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLStyleElementImpl.java | 5 +-
.../html/dom/HTMLTableCaptionElementImpl.java | 7 +--
.../apache/html/dom/HTMLTableCellElementImpl.java | 5 +-
.../apache/html/dom/HTMLTableColElementImpl.java | 5 +-
src/org/apache/html/dom/HTMLTableElementImpl.java | 5 +-
.../apache/html/dom/HTMLTableRowElementImpl.java | 5 +-
.../html/dom/HTMLTableSectionElementImpl.java | 5 +-
.../apache/html/dom/HTMLTextAreaElementImpl.java | 7 +--
src/org/apache/html/dom/HTMLTitleElementImpl.java | 7 +--
src/org/apache/html/dom/HTMLUListElementImpl.java | 5 +-
src/org/apache/html/dom/NameNodeListImpl.java | 12 ++++-
src/org/apache/html/dom/ObjectFactory.java | 26 ++++-----
src/org/apache/xerces/dom/DeepNodeListImpl.java | 3 ++
58 files changed, 249 insertions(+), 181 deletions(-)
diff --git a/src/org/apache/html/dom/HTMLAnchorElementImpl.java
b/src/org/apache/html/dom/HTMLAnchorElementImpl.java
index 69a1c95ed..053d14a24 100644
--- a/src/org/apache/html/dom/HTMLAnchorElementImpl.java
+++ b/src/org/apache/html/dom/HTMLAnchorElementImpl.java
@@ -195,10 +195,11 @@ public class HTMLAnchorElementImpl
}
- /**
+ /**
* Constructor requires owner document.
*
- * @param owner The owner HTML document
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLAnchorElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLAppletElementImpl.java
b/src/org/apache/html/dom/HTMLAppletElementImpl.java
index 855732a2d..7dbf81e40 100644
--- a/src/org/apache/html/dom/HTMLAppletElementImpl.java
+++ b/src/org/apache/html/dom/HTMLAppletElementImpl.java
@@ -166,8 +166,9 @@ public class HTMLAppletElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLAppletElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLAreaElementImpl.java
b/src/org/apache/html/dom/HTMLAreaElementImpl.java
index b4c6d20b4..e01220356 100644
--- a/src/org/apache/html/dom/HTMLAreaElementImpl.java
+++ b/src/org/apache/html/dom/HTMLAreaElementImpl.java
@@ -138,8 +138,9 @@ public class HTMLAreaElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLAreaElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLBRElementImpl.java
b/src/org/apache/html/dom/HTMLBRElementImpl.java
index e163ac989..e48db0cfb 100644
--- a/src/org/apache/html/dom/HTMLBRElementImpl.java
+++ b/src/org/apache/html/dom/HTMLBRElementImpl.java
@@ -47,7 +47,8 @@ public class HTMLBRElementImpl
/**
* Constructor requires owner document.
*
- * @param owner The owner HTML document
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLBRElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLBaseElementImpl.java
b/src/org/apache/html/dom/HTMLBaseElementImpl.java
index 40039fc70..89e3a50d1 100644
--- a/src/org/apache/html/dom/HTMLBaseElementImpl.java
+++ b/src/org/apache/html/dom/HTMLBaseElementImpl.java
@@ -57,8 +57,9 @@ public class HTMLBaseElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLBaseElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLBaseFontElementImpl.java
b/src/org/apache/html/dom/HTMLBaseFontElementImpl.java
index af9de292a..88458241b 100644
--- a/src/org/apache/html/dom/HTMLBaseFontElementImpl.java
+++ b/src/org/apache/html/dom/HTMLBaseFontElementImpl.java
@@ -70,8 +70,9 @@ public class HTMLBaseFontElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLBaseFontElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLBodyElementImpl.java
b/src/org/apache/html/dom/HTMLBodyElementImpl.java
index 32e41b299..c14dc66e5 100644
--- a/src/org/apache/html/dom/HTMLBodyElementImpl.java
+++ b/src/org/apache/html/dom/HTMLBodyElementImpl.java
@@ -104,10 +104,11 @@ public class HTMLBodyElementImpl
}
- /**
+ /**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLBodyElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLButtonElementImpl.java
b/src/org/apache/html/dom/HTMLButtonElementImpl.java
index fd2738ec4..168cb28b5 100644
--- a/src/org/apache/html/dom/HTMLButtonElementImpl.java
+++ b/src/org/apache/html/dom/HTMLButtonElementImpl.java
@@ -117,7 +117,8 @@ public class HTMLButtonElementImpl
/**
* Constructor requires owner document.
*
- * @param owner The owner HTML document
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLButtonElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLCollectionImpl.java
b/src/org/apache/html/dom/HTMLCollectionImpl.java
index b69bf00c6..9f6e5eb7a 100644
--- a/src/org/apache/html/dom/HTMLCollectionImpl.java
+++ b/src/org/apache/html/dom/HTMLCollectionImpl.java
@@ -47,12 +47,14 @@ import org.w3c.dom.html.HTMLTableSectionElement;
* three traversing functions. As a result, operations on large documents will
* result in traversal of the entire document tree and consume a considerable
* amount of time.
+ * </p>
* <p>
* Note that synchronization on the traversed document cannot be achieved.
* The document itself cannot be locked, and locking each traversed node is
- * likely to lead to a dead lock condition. Therefore, there is a chance of the
+ * likely to lead to a deadlock condition. Therefore, there is a chance of the
* document being changed as results are fetched; in all likelihood, the
results
- * might be out dated, but not erroneous.
+ * might be outdated, but not erroneous.
+ * </p>
*
* @xerces.internal
*
@@ -122,14 +124,14 @@ class HTMLCollectionImpl
/**
* Request collection of all areas in map: <AREA> element in
<MAP>
- * (non recursive).
+ * (non-recursive).
*/
static final short AREA = -1;
/**
* Request collection of all table bodies in table: <TBODY> element
in
- * table <TABLE> (non recursive).
+ * table <TABLE> (non-recursive).
*/
static final short TBODY = -2;
@@ -160,8 +162,8 @@ class HTMLCollectionImpl
* (<code>lookingFor</code>) from the specific document portion
* (<code>topLevel</code>).
*
- * @param topLevel The element underneath which the collection exists
- * @param lookingFor Code indicating what elements to look for
+ * @param topLevel the element underneath which the collection exists
+ * @param lookingFor code indicating what elements to look for
*/
HTMLCollectionImpl( HTMLElement topLevel, short lookingFor )
{
@@ -176,7 +178,7 @@ class HTMLCollectionImpl
* Returns the length of the collection. This method might traverse the
* entire document tree.
*
- * @return Length of the collection
+ * @return the length of the collection
*/
public final int getLength()
{
@@ -190,8 +192,8 @@ class HTMLCollectionImpl
* tree order - depth-first traversal order. This method might traverse
* the entire document tree.
*
- * @param index The index of the node to return
- * @return The specified node or null if no such node found
+ * @param index the index of the node to return
+ * @return the specified node or null if no such node found
*/
public final Node item( int index )
{
@@ -204,12 +206,12 @@ class HTMLCollectionImpl
/**
* Retrieves the named node from the collection. The name is matched case
- * sensitive against the <TT>id</TT> attribute of each element in the
+ * sensitive against the <code>id</code> attribute of each element in the
* collection, returning the first match. The tree is traversed in
* depth-first order. This method might traverse the entire document tree.
*
- * @param name The name of the node to return
- * @return The specified node or null if no such node found
+ * @param name the name of the node to return
+ * @return the specified node or null if no such node found
*/
public final Node namedItem( String name )
{
@@ -226,7 +228,7 @@ class HTMLCollectionImpl
* and the top level element is passed along.
*
* @param topLevel Top level element from which to scan
- * @return Number of elements
+ * @return the number of elements
*/
private int getLength( Element topLevel )
{
@@ -269,10 +271,11 @@ class HTMLCollectionImpl
* for any like element found. Since integers are only passed by value,
* this function makes use of a separate class ({@link CollectionIndex})
* to hold that index.
- *
- * @param topLevel Top level element from which to scan
- * @param index The index of the item to retreive
- * @return Number of elements
+ * </p>
+ *
+ * @param topLevel top level element from which to scan
+ * @param index the index of the item to retrieve
+ * @return the number of elements
* @see CollectionIndex
*/
private Node item( Element topLevel, CollectionIndex index )
@@ -315,11 +318,11 @@ class HTMLCollectionImpl
/**
* Recursive function returns an element of a particular type with the
- * specified name (<TT>id</TT> attribute).
+ * specified name (<code>id</code> attribute).
*
- * @param topLevel Top level element from which to scan
- * @param name The named element to look for
- * @return The first named element found
+ * @param topLevel the top level element from which to scan
+ * @param name the named element to look for
+ * @return the first named element found
*/
private Node namedItem( Element topLevel, String name )
{
@@ -361,7 +364,7 @@ class HTMLCollectionImpl
* the full document tree. When looking inside a specific element (e.g.
for a
* cell inside a row), recursing can lead to erroneous results.
*
- * @return True if methods should recurse to traverse entire tree
+ * @return true if methods should recurse to traverse the entire tree
*/
protected boolean recurse()
{
@@ -370,15 +373,15 @@ class HTMLCollectionImpl
/**
- * Determines if current element matches based on what we're looking for.
+ * Determines if the current element matches based on what we're looking
for.
* The element is passed along with an optional identifier name. If the
* element is the one we're looking for, return true. If the name is also
* specified, the name must match the <code>id</code> attribute
* (match <code>name</code> first for anchors).
*
- * @param elem The current element
- * @param name The identifier name or null
- * @return The element matches what we're looking for
+ * @param elem the current element
+ * @param name the identifier name or null
+ * @return the element matches what we're looking for
*/
protected boolean collectionMatch( Element elem, String name )
{
@@ -487,7 +490,7 @@ class CollectionIndex
/**
* Returns the current index.
*
- * @return Current index
+ * @return the current index
*/
int getIndex()
{
@@ -505,9 +508,9 @@ class CollectionIndex
/**
- * Returns true if index is zero (or negative).
+ * Returns true if the index is zero (or negative).
*
- * @return True if index is zero
+ * @return true if the index is zero or negative
*/
boolean isZero()
{
@@ -519,7 +522,7 @@ class CollectionIndex
* Constructs a new index with the specified initial value. The index will
* then be decremeneted until it reaches zero.
*
- * @param index The initial value
+ * @param index the initial value
*/
CollectionIndex( int index )
{
diff --git a/src/org/apache/html/dom/HTMLDListElementImpl.java
b/src/org/apache/html/dom/HTMLDListElementImpl.java
index 1174c8336..c0c8c9e4a 100644
--- a/src/org/apache/html/dom/HTMLDListElementImpl.java
+++ b/src/org/apache/html/dom/HTMLDListElementImpl.java
@@ -44,10 +44,11 @@ public class HTMLDListElementImpl
}
- /**
+ /**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLDListElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLDOMImplementationImpl.java
b/src/org/apache/html/dom/HTMLDOMImplementationImpl.java
index fb127a152..0b101d3de 100644
--- a/src/org/apache/html/dom/HTMLDOMImplementationImpl.java
+++ b/src/org/apache/html/dom/HTMLDOMImplementationImpl.java
@@ -59,10 +59,10 @@ public class HTMLDOMImplementationImpl
/**
- * Create a new HTML document of the specified <TT>TITLE</TT> text.
+ * Create a new HTML document of the specified <code>TITLE</code> text.
*
- * @param title The document title text
- * @return New HTML document
+ * @param title the document title text
+ * @return a new HTML document
*/
public final HTMLDocument createHTMLDocument( String title )
throws DOMException
@@ -82,7 +82,7 @@ public class HTMLDOMImplementationImpl
* used to perform operations that are not specific to a particular
* document instance, e.g. to create a new document.
*
- * @return Reference to a valid DOM implementation
+ * @return a singleton reference to a valid DOM implementation
*/
public static HTMLDOMImplementation getHTMLDOMImplementation()
{
diff --git a/src/org/apache/html/dom/HTMLDirectoryElementImpl.java
b/src/org/apache/html/dom/HTMLDirectoryElementImpl.java
index b556b892e..ddf403ceb 100644
--- a/src/org/apache/html/dom/HTMLDirectoryElementImpl.java
+++ b/src/org/apache/html/dom/HTMLDirectoryElementImpl.java
@@ -44,10 +44,11 @@ public class HTMLDirectoryElementImpl
}
- /**
+ /**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLDirectoryElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLDivElementImpl.java
b/src/org/apache/html/dom/HTMLDivElementImpl.java
index ad781c154..526cc4d63 100644
--- a/src/org/apache/html/dom/HTMLDivElementImpl.java
+++ b/src/org/apache/html/dom/HTMLDivElementImpl.java
@@ -44,10 +44,11 @@ public class HTMLDivElementImpl
}
- /**
+ /**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLDivElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLDocumentImpl.java
b/src/org/apache/html/dom/HTMLDocumentImpl.java
index 20f484d9d..61c6366b0 100644
--- a/src/org/apache/html/dom/HTMLDocumentImpl.java
+++ b/src/org/apache/html/dom/HTMLDocumentImpl.java
@@ -42,16 +42,18 @@ import org.w3c.dom.html.HTMLTitleElement;
/**
* Implements an HTML document. Provides access to the top level element in the
* document, its body and title.
- * <P>
+ * <p>
* Several methods create new nodes of all basic types (comment, text, element,
* etc.). These methods create new nodes but do not place them in the document
* tree. The nodes may be placed in the document tree using {@link
* org.w3c.dom.Node#appendChild} or {@link org.w3c.dom.Node#insertBefore}, or
* they may be placed in some other document tree.
- * <P>
+ * </p>
+ * <p>
* Note: <FRAMESET> documents are not supported at the moment, neither
* are direct document writing ({@link #open}, {@link #write}) and HTTP
attribute
* methods ({@link #getURL}, {@link #getCookie}).
+ * </p>
*
* @xerces.internal
*
@@ -132,6 +134,7 @@ public class HTMLDocumentImpl
/**
+ * Create a new HTML document implementation
*/
public HTMLDocumentImpl()
{
@@ -205,12 +208,13 @@ public class HTMLDocumentImpl
* <HTML> in the document. The <HTML> element is obtained by
* calling {@link #getDocumentElement}. If the element does not exist, one
* is created.
- * <P>
+ * <p>
* Called by {@link #getTitle}, {@link #setTitle}, {@link #getBody} and
* {@link #setBody} to assure the document has the <HEAD> element
* correctly placed.
+ * </p>
*
- * @return The <HEAD> element
+ * @return the <HEAD> element
*/
public synchronized HTMLElement getHead()
{
@@ -434,14 +438,12 @@ public class HTMLDocumentImpl
* Xerces-specific constructor. "localName" is passed in, so we don't need
* to create a new String for it.
*
- * @param namespaceURI The namespace URI of the element to
- * create.
- * @param qualifiedName The qualified name of the element type to
- * instantiate.
- * @param localpart The local name of the element to instantiate.
- * @return Element A new Element object with the following attributes:
+ * @param namespaceURI the namespace URI of the element to create
+ * @param qualifiedName the qualified name of the element type to
instantiate
+ * @param localpart the local name of the element to instantiate
+ * @return a new {@link Element} object with the following attributes:
* @throws DOMException INVALID_CHARACTER_ERR: Raised if the specified
- * name contains an invalid character.
+ * name contains an invalid character
*/
public Element createElementNS(String namespaceURI, String qualifiedName,
String localpart)
@@ -504,10 +506,9 @@ public class HTMLDocumentImpl
* Overrides {@link DocumentImpl#createAttribute} and returns
* and attribute whose name is lower case.
*
- * @param name The name of the attribute
- * @return An attribute whose name is all lower case
- * @throws DOMException(INVALID_NAME_ERR) if the attribute name
- * is not acceptable
+ * @param name the name of the attribute
+ * @return an attribute whose name is all lower case
+ * @throws DOMException INVALID_NAME_ERR if the attribute name is not
acceptable
*/
public Attr createAttribute( String name )
throws DOMException
@@ -660,8 +661,8 @@ public class HTMLDocumentImpl
* Recursive method retreives an element by its <code>id</code> attribute.
* Called by {@link #getElementById(String)}.
*
- * @param elementId The <code>id</code> value to look for
- * @return The node in which to look for
+ * @param elementId the <code>id</code> value to look for
+ * @return the node in which to look for
*/
private Element getElementById( String elementId, Node node )
{
diff --git a/src/org/apache/html/dom/HTMLElementImpl.java
b/src/org/apache/html/dom/HTMLElementImpl.java
index 91c638458..32177e66d 100644
--- a/src/org/apache/html/dom/HTMLElementImpl.java
+++ b/src/org/apache/html/dom/HTMLElementImpl.java
@@ -52,8 +52,8 @@ public class HTMLElementImpl
* by the constructor of specific element types but with a known tag name.
* Assures that the owner document is an HTML element.
*
- * @param owner The owner HTML document
- * @param tagName The element's tag name
+ * @param owner the HTML document in which this element appears
+ * @param tagName the element's tag name
*/
public HTMLElementImpl( HTMLDocumentImpl owner, String tagName ) {
super( owner, tagName.toUpperCase(Locale.ENGLISH) );
@@ -104,8 +104,8 @@ public class HTMLElementImpl
* value. Returns the integer value or zero if the attribute is not a
* valid numeric string.
*
- * @param value The value of the attribute
- * @return The integer value, or zero if not a valid numeric string
+ * @param value the value of the attribute
+ * @return the integer value, or zero if not a valid numeric string
*/
int getInteger( String value ) {
try {
@@ -189,8 +189,8 @@ public class HTMLElementImpl
* is returned. For example, the align values "LEFT" and "left" will both
* return as "Left".
*
- * @param value The value of the attribute
- * @return The capitalized value
+ * @param value the value of the attribute
+ * @return the capitalized value
*/
String capitalize( String value ) {
@@ -215,8 +215,8 @@ public class HTMLElementImpl
* is returned. For example, the align values "LEFT" and "left" will both
* return as "Left".
*
- * @param name The name of the attribute
- * @return The capitalized value
+ * @param name the name of the attribute
+ * @return the capitalized value
*/
String getCapitalized( String name ) {
String value;
@@ -244,6 +244,8 @@ public class HTMLElementImpl
* Convenience method returns the form in which this form element is
contained.
* This method is exposed for form elements through the DOM API, but other
* elements have no access to it through the API.
+ *
+ * @return the form in which this form element is contained
*/
public HTMLFormElement getForm() {
Node parent = getParentNode();
diff --git a/src/org/apache/html/dom/HTMLFieldSetElementImpl.java
b/src/org/apache/html/dom/HTMLFieldSetElementImpl.java
index b82e1c458..2faa15ca4 100644
--- a/src/org/apache/html/dom/HTMLFieldSetElementImpl.java
+++ b/src/org/apache/html/dom/HTMLFieldSetElementImpl.java
@@ -35,7 +35,8 @@ public class HTMLFieldSetElementImpl
/**
* Constructor requires owner document.
*
- * @param owner The owner HTML document
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLFieldSetElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLFormElementImpl.java
b/src/org/apache/html/dom/HTMLFormElementImpl.java
index b2973864d..e0a30efc0 100644
--- a/src/org/apache/html/dom/HTMLFormElementImpl.java
+++ b/src/org/apache/html/dom/HTMLFormElementImpl.java
@@ -153,7 +153,8 @@ public class HTMLFormElementImpl
/**
* Constructor requires owner document.
*
- * @param owner The owner HTML document
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLFormElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLFrameElementImpl.java
b/src/org/apache/html/dom/HTMLFrameElementImpl.java
index 374bec37c..581047014 100644
--- a/src/org/apache/html/dom/HTMLFrameElementImpl.java
+++ b/src/org/apache/html/dom/HTMLFrameElementImpl.java
@@ -138,7 +138,8 @@ public class HTMLFrameElementImpl
/**
* Constructor requires owner document.
*
- * @param owner The owner HTML document
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLFrameElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLFrameSetElementImpl.java
b/src/org/apache/html/dom/HTMLFrameSetElementImpl.java
index 167013027..2d8183187 100644
--- a/src/org/apache/html/dom/HTMLFrameSetElementImpl.java
+++ b/src/org/apache/html/dom/HTMLFrameSetElementImpl.java
@@ -58,8 +58,9 @@ public class HTMLFrameSetElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLFrameSetElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLHRElementImpl.java
b/src/org/apache/html/dom/HTMLHRElementImpl.java
index 6d29c10c1..ece57e22c 100644
--- a/src/org/apache/html/dom/HTMLHRElementImpl.java
+++ b/src/org/apache/html/dom/HTMLHRElementImpl.java
@@ -82,8 +82,9 @@ public class HTMLHRElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLHRElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLHeadElementImpl.java
b/src/org/apache/html/dom/HTMLHeadElementImpl.java
index 8bda2cdff..3338a63f2 100644
--- a/src/org/apache/html/dom/HTMLHeadElementImpl.java
+++ b/src/org/apache/html/dom/HTMLHeadElementImpl.java
@@ -46,8 +46,9 @@ public class HTMLHeadElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLHeadElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLHeadingElementImpl.java
b/src/org/apache/html/dom/HTMLHeadingElementImpl.java
index b977ab230..877dec5f3 100644
--- a/src/org/apache/html/dom/HTMLHeadingElementImpl.java
+++ b/src/org/apache/html/dom/HTMLHeadingElementImpl.java
@@ -46,8 +46,9 @@ public class HTMLHeadingElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLHeadingElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLHtmlElementImpl.java
b/src/org/apache/html/dom/HTMLHtmlElementImpl.java
index bc640e97f..3aed90f8a 100644
--- a/src/org/apache/html/dom/HTMLHtmlElementImpl.java
+++ b/src/org/apache/html/dom/HTMLHtmlElementImpl.java
@@ -46,8 +46,9 @@ public class HTMLHtmlElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLHtmlElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLIFrameElementImpl.java
b/src/org/apache/html/dom/HTMLIFrameElementImpl.java
index 79692d254..5b330e411 100644
--- a/src/org/apache/html/dom/HTMLIFrameElementImpl.java
+++ b/src/org/apache/html/dom/HTMLIFrameElementImpl.java
@@ -160,8 +160,9 @@ public class HTMLIFrameElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLIFrameElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLImageElementImpl.java
b/src/org/apache/html/dom/HTMLImageElementImpl.java
index 88624829d..11bcfb64e 100644
--- a/src/org/apache/html/dom/HTMLImageElementImpl.java
+++ b/src/org/apache/html/dom/HTMLImageElementImpl.java
@@ -190,8 +190,9 @@ public class HTMLImageElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLImageElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLInputElementImpl.java
b/src/org/apache/html/dom/HTMLInputElementImpl.java
index 1a1fcd203..c39a4d6a7 100644
--- a/src/org/apache/html/dom/HTMLInputElementImpl.java
+++ b/src/org/apache/html/dom/HTMLInputElementImpl.java
@@ -276,8 +276,9 @@ public class HTMLInputElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLInputElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLIsIndexElementImpl.java
b/src/org/apache/html/dom/HTMLIsIndexElementImpl.java
index 0cdd50ba4..628118782 100644
--- a/src/org/apache/html/dom/HTMLIsIndexElementImpl.java
+++ b/src/org/apache/html/dom/HTMLIsIndexElementImpl.java
@@ -46,8 +46,9 @@ public class HTMLIsIndexElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLIsIndexElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLLIElementImpl.java
b/src/org/apache/html/dom/HTMLLIElementImpl.java
index a523d5e7d..efa15c69a 100644
--- a/src/org/apache/html/dom/HTMLLIElementImpl.java
+++ b/src/org/apache/html/dom/HTMLLIElementImpl.java
@@ -58,8 +58,9 @@ public class HTMLLIElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLLIElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLLabelElementImpl.java
b/src/org/apache/html/dom/HTMLLabelElementImpl.java
index 6888607d3..b51ccbbd1 100644
--- a/src/org/apache/html/dom/HTMLLabelElementImpl.java
+++ b/src/org/apache/html/dom/HTMLLabelElementImpl.java
@@ -67,8 +67,9 @@ public class HTMLLabelElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLLabelElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLLegendElementImpl.java
b/src/org/apache/html/dom/HTMLLegendElementImpl.java
index 730df7300..40d5e9816 100644
--- a/src/org/apache/html/dom/HTMLLegendElementImpl.java
+++ b/src/org/apache/html/dom/HTMLLegendElementImpl.java
@@ -67,8 +67,9 @@ public class HTMLLegendElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLLegendElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLLinkElementImpl.java
b/src/org/apache/html/dom/HTMLLinkElementImpl.java
index e2f2449cf..35d375ce5 100644
--- a/src/org/apache/html/dom/HTMLLinkElementImpl.java
+++ b/src/org/apache/html/dom/HTMLLinkElementImpl.java
@@ -142,8 +142,9 @@ public class HTMLLinkElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLLinkElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLMapElementImpl.java
b/src/org/apache/html/dom/HTMLMapElementImpl.java
index a25cead14..81a83743d 100644
--- a/src/org/apache/html/dom/HTMLMapElementImpl.java
+++ b/src/org/apache/html/dom/HTMLMapElementImpl.java
@@ -66,8 +66,9 @@ public class HTMLMapElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLMapElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLMenuElementImpl.java
b/src/org/apache/html/dom/HTMLMenuElementImpl.java
index 50100640e..198e1416f 100644
--- a/src/org/apache/html/dom/HTMLMenuElementImpl.java
+++ b/src/org/apache/html/dom/HTMLMenuElementImpl.java
@@ -46,8 +46,9 @@ public class HTMLMenuElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLMenuElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLMetaElementImpl.java
b/src/org/apache/html/dom/HTMLMetaElementImpl.java
index 47c2e62ec..b9658c14a 100644
--- a/src/org/apache/html/dom/HTMLMetaElementImpl.java
+++ b/src/org/apache/html/dom/HTMLMetaElementImpl.java
@@ -83,8 +83,9 @@ public class HTMLMetaElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLMetaElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLModElementImpl.java
b/src/org/apache/html/dom/HTMLModElementImpl.java
index cf1211d48..4cb13cd71 100644
--- a/src/org/apache/html/dom/HTMLModElementImpl.java
+++ b/src/org/apache/html/dom/HTMLModElementImpl.java
@@ -58,8 +58,9 @@ public class HTMLModElementImpl
/**
* Constructor requires owner document and tag name.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLModElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLOListElementImpl.java
b/src/org/apache/html/dom/HTMLOListElementImpl.java
index 5941956c0..e0f900e29 100644
--- a/src/org/apache/html/dom/HTMLOListElementImpl.java
+++ b/src/org/apache/html/dom/HTMLOListElementImpl.java
@@ -68,10 +68,11 @@ public class HTMLOListElementImpl
}
- /**
+ /**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLOListElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLObjectElementImpl.java
b/src/org/apache/html/dom/HTMLObjectElementImpl.java
index 1d016d24e..d0d928487 100644
--- a/src/org/apache/html/dom/HTMLObjectElementImpl.java
+++ b/src/org/apache/html/dom/HTMLObjectElementImpl.java
@@ -249,8 +249,9 @@ public class HTMLObjectElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLObjectElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLOptGroupElementImpl.java
b/src/org/apache/html/dom/HTMLOptGroupElementImpl.java
index 0463c6714..5bf4366d8 100644
--- a/src/org/apache/html/dom/HTMLOptGroupElementImpl.java
+++ b/src/org/apache/html/dom/HTMLOptGroupElementImpl.java
@@ -56,10 +56,11 @@ public class HTMLOptGroupElementImpl
}
- /**
+ /**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLOptGroupElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLOptionElementImpl.java
b/src/org/apache/html/dom/HTMLOptionElementImpl.java
index 75ce3b280..83e928179 100644
--- a/src/org/apache/html/dom/HTMLOptionElementImpl.java
+++ b/src/org/apache/html/dom/HTMLOptionElementImpl.java
@@ -196,8 +196,9 @@ public class HTMLOptionElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLOptionElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLParagraphElementImpl.java
b/src/org/apache/html/dom/HTMLParagraphElementImpl.java
index c3e21f579..b8736c2bf 100644
--- a/src/org/apache/html/dom/HTMLParagraphElementImpl.java
+++ b/src/org/apache/html/dom/HTMLParagraphElementImpl.java
@@ -46,8 +46,9 @@ public class HTMLParagraphElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLParagraphElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLParamElementImpl.java
b/src/org/apache/html/dom/HTMLParamElementImpl.java
index 03cf1925e..190f0daf5 100644
--- a/src/org/apache/html/dom/HTMLParamElementImpl.java
+++ b/src/org/apache/html/dom/HTMLParamElementImpl.java
@@ -82,8 +82,9 @@ public class HTMLParamElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLParamElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLPreElementImpl.java
b/src/org/apache/html/dom/HTMLPreElementImpl.java
index 63f4f6e62..559c61630 100644
--- a/src/org/apache/html/dom/HTMLPreElementImpl.java
+++ b/src/org/apache/html/dom/HTMLPreElementImpl.java
@@ -46,8 +46,9 @@ public class HTMLPreElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLPreElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLQuoteElementImpl.java
b/src/org/apache/html/dom/HTMLQuoteElementImpl.java
index 3a50b5634..81a5fd0ea 100644
--- a/src/org/apache/html/dom/HTMLQuoteElementImpl.java
+++ b/src/org/apache/html/dom/HTMLQuoteElementImpl.java
@@ -46,8 +46,9 @@ public class HTMLQuoteElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLQuoteElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLScriptElementImpl.java
b/src/org/apache/html/dom/HTMLScriptElementImpl.java
index 75acfc93a..22b2db26b 100644
--- a/src/org/apache/html/dom/HTMLScriptElementImpl.java
+++ b/src/org/apache/html/dom/HTMLScriptElementImpl.java
@@ -142,10 +142,11 @@ public class HTMLScriptElementImpl
}
- /**
+ /**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLScriptElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLSelectElementImpl.java
b/src/org/apache/html/dom/HTMLSelectElementImpl.java
index 8095f0251..f3108c38e 100644
--- a/src/org/apache/html/dom/HTMLSelectElementImpl.java
+++ b/src/org/apache/html/dom/HTMLSelectElementImpl.java
@@ -217,8 +217,9 @@ public class HTMLSelectElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLSelectElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLStyleElementImpl.java
b/src/org/apache/html/dom/HTMLStyleElementImpl.java
index 3ce4b6910..ec0cb3e42 100644
--- a/src/org/apache/html/dom/HTMLStyleElementImpl.java
+++ b/src/org/apache/html/dom/HTMLStyleElementImpl.java
@@ -70,8 +70,9 @@ public class HTMLStyleElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLStyleElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLTableCaptionElementImpl.java
b/src/org/apache/html/dom/HTMLTableCaptionElementImpl.java
index f604f628e..4607100fb 100644
--- a/src/org/apache/html/dom/HTMLTableCaptionElementImpl.java
+++ b/src/org/apache/html/dom/HTMLTableCaptionElementImpl.java
@@ -44,10 +44,11 @@ public class HTMLTableCaptionElementImpl
}
- /**
+ /**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLTableCaptionElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLTableCellElementImpl.java
b/src/org/apache/html/dom/HTMLTableCellElementImpl.java
index cd4df94e3..a7ffcdea8 100644
--- a/src/org/apache/html/dom/HTMLTableCellElementImpl.java
+++ b/src/org/apache/html/dom/HTMLTableCellElementImpl.java
@@ -265,8 +265,9 @@ public class HTMLTableCellElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLTableCellElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLTableColElementImpl.java
b/src/org/apache/html/dom/HTMLTableColElementImpl.java
index ce7d1d926..34d060ce6 100644
--- a/src/org/apache/html/dom/HTMLTableColElementImpl.java
+++ b/src/org/apache/html/dom/HTMLTableColElementImpl.java
@@ -114,8 +114,9 @@ public class HTMLTableColElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLTableColElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLTableElementImpl.java
b/src/org/apache/html/dom/HTMLTableElementImpl.java
index b3cc95eb3..15c1f7440 100644
--- a/src/org/apache/html/dom/HTMLTableElementImpl.java
+++ b/src/org/apache/html/dom/HTMLTableElementImpl.java
@@ -390,8 +390,9 @@ public class HTMLTableElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLTableElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLTableRowElementImpl.java
b/src/org/apache/html/dom/HTMLTableRowElementImpl.java
index b021c1f40..7af26c6b0 100644
--- a/src/org/apache/html/dom/HTMLTableRowElementImpl.java
+++ b/src/org/apache/html/dom/HTMLTableRowElementImpl.java
@@ -260,8 +260,9 @@ public class HTMLTableRowElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLTableRowElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLTableSectionElementImpl.java
b/src/org/apache/html/dom/HTMLTableSectionElementImpl.java
index 030ab0851..3b7d61a69 100644
--- a/src/org/apache/html/dom/HTMLTableSectionElementImpl.java
+++ b/src/org/apache/html/dom/HTMLTableSectionElementImpl.java
@@ -174,8 +174,9 @@ public class HTMLTableSectionElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLTableSectionElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLTextAreaElementImpl.java
b/src/org/apache/html/dom/HTMLTextAreaElementImpl.java
index 2837a2ee1..66fe6eb50 100644
--- a/src/org/apache/html/dom/HTMLTextAreaElementImpl.java
+++ b/src/org/apache/html/dom/HTMLTextAreaElementImpl.java
@@ -176,10 +176,11 @@ public class HTMLTextAreaElementImpl
}
- /**
+ /**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLTextAreaElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLTitleElementImpl.java
b/src/org/apache/html/dom/HTMLTitleElementImpl.java
index 0e7bb3af7..8e859ee14 100644
--- a/src/org/apache/html/dom/HTMLTitleElementImpl.java
+++ b/src/org/apache/html/dom/HTMLTitleElementImpl.java
@@ -71,10 +71,11 @@ public class HTMLTitleElementImpl
}
- /**
+ /**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLTitleElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/HTMLUListElementImpl.java
b/src/org/apache/html/dom/HTMLUListElementImpl.java
index ebb84d839..171fe8cf1 100644
--- a/src/org/apache/html/dom/HTMLUListElementImpl.java
+++ b/src/org/apache/html/dom/HTMLUListElementImpl.java
@@ -58,8 +58,9 @@ public class HTMLUListElementImpl
/**
* Constructor requires owner document.
- *
- * @param owner The owner HTML document
+ *
+ * @param owner the HTML document in which this element appears
+ * @param name the tag name of the element
*/
public HTMLUListElementImpl( HTMLDocumentImpl owner, String name )
{
diff --git a/src/org/apache/html/dom/NameNodeListImpl.java
b/src/org/apache/html/dom/NameNodeListImpl.java
index 225c07d62..a19e6481a 100644
--- a/src/org/apache/html/dom/NameNodeListImpl.java
+++ b/src/org/apache/html/dom/NameNodeListImpl.java
@@ -25,7 +25,7 @@ import org.w3c.dom.NodeList;
/**
* This class implements the DOM's NodeList behavior for
- * HTMLDocuemnt.getElementsByName().
+ * HTMLDocument.getElementsByName().
*
* @xerces.internal
*
@@ -38,7 +38,12 @@ public class NameNodeListImpl
implements NodeList {
- /** Constructor. */
+ /**
+ * Constructor.
+ *
+ * @param rootNode the root node
+ * @param tagName the tag name
+ */
public NameNodeListImpl(NodeImpl rootNode, String tagName) {
super( rootNode, tagName );
}
@@ -48,6 +53,9 @@ public class NameNodeListImpl
* Iterative tree-walker. When you have a Parent link, there's often no
* need to resort to recursion. NOTE THAT only Element nodes are matched
* since we're specifically supporting getElementsByTagName().
+ *
+ * @param current the current node
+ * @return the next matching node after the current one, or
<code>null</code>
*/
protected Node nextMatchingElementAfter(Node current) {
diff --git a/src/org/apache/html/dom/ObjectFactory.java
b/src/org/apache/html/dom/ObjectFactory.java
index 7a04cbea9..2dfa50587 100644
--- a/src/org/apache/html/dom/ObjectFactory.java
+++ b/src/org/apache/html/dom/ObjectFactory.java
@@ -35,7 +35,7 @@ import java.util.Properties;
* later, and to compile on JDK 1.2 and onward.
* The code also runs both as part of an unbundled jar file and
* when bundled as part of the JDK.
- * <p>
+ * </p>
*
* @xerces.internal
*
@@ -87,12 +87,12 @@ final class ObjectFactory {
*
* @return Class object of factory, never null
*
- * @param factoryId Name of the factory to find, same as
+ * @param factoryId name of the factory to find, same as
* a property name
- * @param fallbackClassName Implementation class name, if nothing else
- * is found. Use null to mean no fallback.
+ * @param fallbackClassName implementation class name, if nothing else
+ * is found. Use null to mean no fallback.
*
- * @exception ObjectFactory.ConfigurationError
+ * @throws ObjectFactory.ConfigurationError if cannot create an instance
*/
static Object createObject(String factoryId, String fallbackClassName)
throws ConfigurationError {
@@ -111,15 +111,15 @@ final class ObjectFactory {
*
* @return Class object of factory, never null
*
- * @param factoryId Name of the factory to find, same as
+ * @param factoryId the name of the factory to find, same as
* a property name
- * @param propertiesFilename The filename in the $java.home/lib directory
- * of the properties file. If none specified,
+ * @param propertiesFilename the filename in the $java.home/lib directory
+ * of the properties file. If none specified,
* ${java.home}/lib/xerces.properties will be
used.
- * @param fallbackClassName Implementation class name, if nothing else
- * is found. Use null to mean no fallback.
+ * @param fallbackClassName an implementation class name, if nothing else
+ * is found. Use null to mean no fallback.
*
- * @exception ObjectFactory.ConfigurationError
+ * @throws ObjectFactory.ConfigurationError if cannot create an instance
*/
static Object createObject(String factoryId,
String propertiesFilename,
@@ -409,9 +409,9 @@ final class ObjectFactory {
}
/*
- * Try to find provider using Jar Service Provider Mechanism
+ * Try to find the provider for a given factory id using Jar Service
Provider Mechanism
*
- * @return instance of provider class if found or null
+ * @return an instance of provider class if found or null
*/
private static Object findJarServiceProvider(String factoryId)
throws ConfigurationError
diff --git a/src/org/apache/xerces/dom/DeepNodeListImpl.java
b/src/org/apache/xerces/dom/DeepNodeListImpl.java
index f3b65d740..fb1592edb 100644
--- a/src/org/apache/xerces/dom/DeepNodeListImpl.java
+++ b/src/org/apache/xerces/dom/DeepNodeListImpl.java
@@ -164,6 +164,9 @@ public class DeepNodeListImpl
* Iterative tree-walker. When you have a Parent link, there's often no
* need to resort to recursion. NOTE THAT only Element nodes are matched
* since we're specifically supporting getElementsByTagName().
+ *
+ * @param current the current node
+ * @return @return the next matching node after the current one, or
<code>null</code>
*/
protected Node nextMatchingElementAfter(Node current) {
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
