You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commons-cvs@xml.apache.org by jk...@apache.org on 2002/01/04 21:20:53 UTC

cvs commit: xml-commons/java/external/src/org/w3c/dom/traversal DocumentTraversal.java NodeFilter.java

jkesselm    02/01/04 12:20:52

  Modified:    java/external/src/org/w3c/dom Attr.java CDATASection.java
                        CharacterData.java DOMException.java
                        DOMImplementation.java Document.java
                        DocumentType.java Element.java Entity.java
                        NamedNodeMap.java Node.java NodeList.java
                        ProcessingInstruction.java
               java/external/src/org/w3c/dom/css CSSRuleList.java
                        CSSValueList.java
               java/external/src/org/w3c/dom/events DocumentEvent.java
                        Event.java EventTarget.java MouseEvent.java
                        MutationEvent.java UIEvent.java
               java/external/src/org/w3c/dom/ranges Range.java
               java/external/src/org/w3c/dom/stylesheets MediaList.java
                        StyleSheetList.java
               java/external/src/org/w3c/dom/traversal
                        DocumentTraversal.java NodeFilter.java
  Added:       java/external/src/org/w3c/dom/html HTMLAnchorElement.java
                        HTMLAppletElement.java HTMLAreaElement.java
                        HTMLBRElement.java HTMLBaseElement.java
                        HTMLBaseFontElement.java HTMLBodyElement.java
                        HTMLButtonElement.java HTMLCollection.java
                        HTMLDListElement.java HTMLDirectoryElement.java
                        HTMLDivElement.java HTMLDocument.java
                        HTMLElement.java HTMLFieldSetElement.java
                        HTMLFontElement.java HTMLFormElement.java
                        HTMLFrameElement.java HTMLFrameSetElement.java
                        HTMLHRElement.java HTMLHeadElement.java
                        HTMLHeadingElement.java HTMLHtmlElement.java
                        HTMLIFrameElement.java HTMLImageElement.java
                        HTMLInputElement.java HTMLIsIndexElement.java
                        HTMLLIElement.java HTMLLabelElement.java
                        HTMLLegendElement.java HTMLLinkElement.java
                        HTMLMapElement.java HTMLMenuElement.java
                        HTMLMetaElement.java HTMLModElement.java
                        HTMLOListElement.java HTMLObjectElement.java
                        HTMLOptGroupElement.java HTMLOptionElement.java
                        HTMLParagraphElement.java HTMLParamElement.java
                        HTMLPreElement.java HTMLQuoteElement.java
                        HTMLScriptElement.java HTMLSelectElement.java
                        HTMLStyleElement.java HTMLTableCaptionElement.java
                        HTMLTableCellElement.java HTMLTableColElement.java
                        HTMLTableElement.java HTMLTableRowElement.java
                        HTMLTableSectionElement.java
                        HTMLTextAreaElement.java HTMLTitleElement.java
                        HTMLUListElement.java
  Log:
  Updating the W3C DOM documentation.
  
  1) Added HTML Level 1. Xerces apparently wants this,
  and there's certainly no reason not to have it in xml-commons.
  
  2) Fixed the generated @param comments. The DOM WG's stylesheet
  for producing Javadoc from their abstract XML markup had a glitch,
  and did not reliably produce a space between the parameter name
  and its description. I've submitted that as an erratum, to make sure
  they fix it. Meanwhile, I've gone through and fixed them all manually.
  (Not everything could be fixed by simply replacing "The" with " The";
  some descriptions start with other words.)
  
  I'm an ex-member of the DOM WG, and still on the IG, so feel free to
  blame me for the fact that this wasn't caught before the DOM shipped
  ... and for making the change. The fact that these files are no
  longer byte-for-byte identical with those supplied by the W3C will
  annoy some folks, but I think it's fairly safe to assume that the DOM WG
  will accept the erratum.
  
  And we definitely want to fix it here rather than having each Apache
  project patch their own copy.
  
  Revision  Changes    Path
  1.3       +9 -22     xml-commons/java/external/src/org/w3c/dom/Attr.java
  
  Index: Attr.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/Attr.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- Attr.java	1 Aug 2001 23:24:39 -0000	1.2
  +++ Attr.java	4 Jan 2002 20:20:49 -0000	1.3
  @@ -13,7 +13,7 @@
   package org.w3c.dom;
   
   /**
  - * The <code>Attr</code> interface represents an attribute in an 
  + *  The <code>Attr</code> interface represents an attribute in an 
    * <code>Element</code> object. Typically the allowable values for the 
    * attribute are defined in a document type definition.
    * <p><code>Attr</code> objects inherit the <code>Node</code> interface, but 
  @@ -33,7 +33,7 @@
    * DOM need to be aware that <code>Attr</code> nodes have some things in 
    * common with other objects inheriting the <code>Node</code> interface, but 
    * they also are quite distinct.
  - * <p>The attribute's effective value is determined as follows: if this 
  + * <p> The attribute's effective value is determined as follows: if this 
    * attribute has been explicitly assigned any value, that value is the 
    * attribute's effective value; otherwise, if there is a declaration for 
    * this attribute, and that declaration includes a default value, then that 
  @@ -41,19 +41,19 @@
    * attribute does not exist on this element in the structure model until it 
    * has been explicitly added. Note that the <code>nodeValue</code> attribute 
    * on the <code>Attr</code> instance can also be used to retrieve the string 
  - * version of the attribute's value(s).
  + * version of the attribute's value(s). 
    * <p>In XML, where the value of an attribute can contain entity references, 
    * the child nodes of the <code>Attr</code> node may be either 
    * <code>Text</code> or <code>EntityReference</code> nodes (when these are 
    * in use; see the description of <code>EntityReference</code> for 
    * discussion). Because the DOM Core is not aware of attribute types, it 
    * treats all attribute values as simple strings, even if the DTD or schema 
  - * declares them as having tokenized types.
  + * declares them as having tokenized types. 
    * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113'>Document Object Model (DOM) Level 2 Core Specification</a>.
    */
   public interface Attr extends Node {
       /**
  -     * Returns the name of this attribute.
  +     * Returns the name of this attribute. 
        */
       public String getName();
   
  @@ -69,14 +69,14 @@
        * implementation will then make a new attribute available with 
        * <code>specified</code> set to <code>false</code> and the default 
        * value (if one exists).
  -     * <br>In summary: If the attribute has an assigned value in the document 
  +     * <br>In summary:  If the attribute has an assigned value in the document 
        * then <code>specified</code> is <code>true</code>, and the value is 
  -     * the assigned value.If the attribute has no assigned value in the 
  +     * the assigned value.  If the attribute has no assigned value in the 
        * document and has a default value in the DTD, then 
        * <code>specified</code> is <code>false</code>, and the value is the 
  -     * default value in the DTD.If the attribute has no assigned value in 
  +     * default value in the DTD. If the attribute has no assigned value in 
        * the document and has a value of #IMPLIED in the DTD, then the 
  -     * attribute does not appear in the structure model of the document.If 
  +     * attribute does not appear in the structure model of the document. If 
        * the <code>ownerElement</code> attribute is <code>null</code> (i.e. 
        * because it was just created or was set to <code>null</code> by the 
        * various removal and cloning operations) <code>specified</code> is 
  @@ -98,19 +98,6 @@
        *   NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
        */
       public String getValue();
  -    /**
  -     * On retrieval, the value of the attribute is returned as a string. 
  -     * Character and general entity references are replaced with their 
  -     * values. See also the method <code>getAttribute</code> on the 
  -     * <code>Element</code> interface.
  -     * <br>On setting, this creates a <code>Text</code> node with the unparsed 
  -     * contents of the string. I.e. any characters that an XML processor 
  -     * would recognize as markup are instead treated as literal text. See 
  -     * also the method <code>setAttribute</code> on the <code>Element</code> 
  -     * interface.
  -     * @exception DOMException
  -     *   NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
  -     */
       public void setValue(String value)
                               throws DOMException;
   
  
  
  
  1.3       +2 -2      xml-commons/java/external/src/org/w3c/dom/CDATASection.java
  
  Index: CDATASection.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/CDATASection.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- CDATASection.java	1 Aug 2001 23:24:39 -0000	1.2
  +++ CDATASection.java	4 Jan 2002 20:20:49 -0000	1.3
  @@ -24,8 +24,8 @@
    * contain characters that need to be escaped outside of CDATA sections and 
    * that, depending on the character encoding ("charset") chosen for 
    * serialization, it may be impossible to write out some characters as part 
  - * of a CDATA section.
  - * <p>The <code>CDATASection</code> interface inherits from the 
  + * of a CDATA section. 
  + * <p> The <code>CDATASection</code> interface inherits from the 
    * <code>CharacterData</code> interface through the <code>Text</code> 
    * interface. Adjacent <code>CDATASection</code> nodes are not merged by use 
    * of the <code>normalize</code> method of the <code>Node</code> interface.
  
  
  
  1.3       +0 -15     xml-commons/java/external/src/org/w3c/dom/CharacterData.java
  
  Index: CharacterData.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/CharacterData.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- CharacterData.java	1 Aug 2001 23:24:39 -0000	1.2
  +++ CharacterData.java	4 Jan 2002 20:20:49 -0000	1.3
  @@ -44,21 +44,6 @@
        */
       public String getData()
                               throws DOMException;
  -    /**
  -     * The character data of the node that implements this interface. The DOM 
  -     * implementation may not put arbitrary limits on the amount of data 
  -     * that may be stored in a <code>CharacterData</code> node. However, 
  -     * implementation limits may mean that the entirety of a node's data may 
  -     * not fit into a single <code>DOMString</code>. In such cases, the user 
  -     * may call <code>substringData</code> to retrieve the data in 
  -     * appropriately sized pieces.
  -     * @exception DOMException
  -     *   NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
  -     * @exception DOMException
  -     *   DOMSTRING_SIZE_ERR: Raised when it would return more characters than 
  -     *   fit in a <code>DOMString</code> variable on the implementation 
  -     *   platform.
  -     */
       public void setData(String data)
                               throws DOMException;
   
  
  
  
  1.3       +2 -2      xml-commons/java/external/src/org/w3c/dom/DOMException.java
  
  Index: DOMException.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/DOMException.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- DOMException.java	1 Aug 2001 23:24:39 -0000	1.2
  +++ DOMException.java	4 Jan 2002 20:20:49 -0000	1.3
  @@ -18,10 +18,10 @@
    * because data is lost, or because the implementation has become unstable). 
    * In general, DOM methods return specific error values in ordinary 
    * processing situations, such as out-of-bound errors when using 
  - * <code>NodeList</code>.
  + * <code>NodeList</code>. 
    * <p>Implementations should raise other exceptions under other circumstances. 
    * For example, implementations should raise an implementation-dependent 
  - * exception if a <code>null</code> argument is passed.
  + * exception if a <code>null</code> argument is passed. 
    * <p>Some languages and object systems do not support the concept of 
    * exceptions. For such systems, error conditions may be indicated using 
    * native error reporting mechanisms. For some bindings, for example, 
  
  
  
  1.3       +12 -22    xml-commons/java/external/src/org/w3c/dom/DOMImplementation.java
  
  Index: DOMImplementation.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/DOMImplementation.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- DOMImplementation.java	1 Aug 2001 23:24:39 -0000	1.2
  +++ DOMImplementation.java	4 Jan 2002 20:20:49 -0000	1.3
  @@ -26,7 +26,11 @@
        *   specifications and listed in the  section. The name must be an XML 
        *   name. To avoid possible conflicts, as a convention, names referring 
        *   to features defined outside the DOM specification should be made 
  -     *   unique.
  +     *   unique by reversing the name of the Internet domain name of the 
  +     *   person (or the organization that the person belongs to) who defines 
  +     *   the feature, component by component, and using this as a prefix. 
  +     *   For instance, the W3C SVG Working Group defines the feature 
  +     *   "org.w3c.dom.svg".
        * @param version This is the version number of the feature to test. In 
        *   Level 2, the string can be either "2.0" or "1.0". If the version is 
        *   not specified, supporting any version of the feature causes the 
  @@ -43,8 +47,9 @@
        * default attribute additions do not occur. It is expected that a 
        * future version of the DOM will provide a way for populating a 
        * <code>DocumentType</code>.
  +     * <br>HTML-only DOM implementations do not need to implement this method.
        * @param qualifiedName The qualified name of the document type to be 
  -     *   created.
  +     *   created. 
        * @param publicId The external subset public identifier.
        * @param systemId The external subset system identifier.
        * @return A new <code>DocumentType</code> node with 
  @@ -54,12 +59,6 @@
        *   contains an illegal character.
        *   <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is 
        *   malformed.
  -     *   <br>NOT_SUPPORTED_ERR: May be raised by DOM implementations which do 
  -     *   not support the <code>"XML"</code> feature, if they choose not to 
  -     *   support this method. Other features introduced in the future, by 
  -     *   the DOM WG or in extensions defined by other groups, may also 
  -     *   demand support for this method; please consult the definition of 
  -     *   the feature to see if it requires this method. 
        * @since DOM Level 2
        */
       public DocumentType createDocumentType(String qualifiedName, 
  @@ -68,10 +67,10 @@
                                              throws DOMException;
   
       /**
  -     * Creates a DOM Document object of the specified type with its document 
  -     * element.
  -     * @param namespaceURI The namespace URI of the document element to 
  -     *   create.
  +     * Creates an XML <code>Document</code> object of the specified type with 
  +     * its document element. HTML-only DOM implementations do not need to 
  +     * implement this method.
  +     * @param namespaceURI The namespace URI of the document element to create.
        * @param qualifiedName The qualified name of the document element to be 
        *   created.
        * @param doctype The type of document to be created or <code>null</code>.
  @@ -87,19 +86,10 @@
        *   <code>namespaceURI</code> is <code>null</code>, or if the 
        *   <code>qualifiedName</code> has a prefix that is "xml" and the 
        *   <code>namespaceURI</code> is different from "
  -     *   http://www.w3.org/XML/1998/namespace" , or if the DOM 
  -     *   implementation does not support the <code>"XML"</code> feature but 
  -     *   a non-null namespace URI was provided, since namespaces were 
  -     *   defined by XML.
  +     *   http://www.w3.org/XML/1998/namespace" .
        *   <br>WRONG_DOCUMENT_ERR: Raised if <code>doctype</code> has already 
        *   been used with a different document or was created from a different 
        *   implementation.
  -     *   <br>NOT_SUPPORTED_ERR: May be raised by DOM implementations which do 
  -     *   not support the "XML" feature, if they choose not to support this 
  -     *   method. Other features introduced in the future, by the DOM WG or 
  -     *   in extensions defined by other groups, may also demand support for 
  -     *   this method; please consult the definition of the feature to see if 
  -     *   it requires this method. 
        * @since DOM Level 2
        */
       public Document createDocument(String namespaceURI, 
  
  
  
  1.3       +29 -92    xml-commons/java/external/src/org/w3c/dom/Document.java
  
  Index: Document.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/Document.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- Document.java	1 Aug 2001 23:24:39 -0000	1.2
  +++ Document.java	4 Jan 2002 20:20:49 -0000	1.3
  @@ -62,7 +62,7 @@
        * @param tagName The name of the element type to instantiate. For XML, 
        *   this is case-sensitive. For HTML, the <code>tagName</code> 
        *   parameter may be provided in any case, but it must be mapped to the 
  -     *   canonical uppercase form by the DOM implementation.
  +     *   canonical uppercase form by the DOM implementation. 
        * @return A new <code>Element</code> object with the 
        *   <code>nodeName</code> attribute set to <code>tagName</code>, and 
        *   <code>localName</code>, <code>prefix</code>, and 
  @@ -75,7 +75,7 @@
                                    throws DOMException;
   
       /**
  -     * Creates an empty <code>DocumentFragment</code> object.
  +     * Creates an empty <code>DocumentFragment</code> object. 
        * @return A new <code>DocumentFragment</code>.
        */
       public DocumentFragment createDocumentFragment();
  @@ -148,7 +148,7 @@
        * node is also unbound; (its <code>namespaceURI</code> is 
        * <code>null</code>). The DOM Level 2 does not support any mechanism to 
        * resolve namespace prefixes.
  -     * @param name The name of the entity to reference.
  +     * @param name The name of the entity to reference. 
        * @return The new <code>EntityReference</code> object.
        * @exception DOMException
        *   INVALID_CHARACTER_ERR: Raised if the specified name contains an 
  @@ -161,7 +161,7 @@
       /**
        * Returns a <code>NodeList</code> of all the <code>Elements</code> with a 
        * given tag name in the order in which they are encountered in a 
  -     * preorder traversal of the <code>Document</code> tree.
  +     * preorder traversal of the <code>Document</code> tree. 
        * @param tagname The name of the tag to match on. The special value "*" 
        *   matches all tags.
        * @return A new <code>NodeList</code> object containing all the matched 
  @@ -255,7 +255,7 @@
        * types of nodes inheriting from <code>CharacterData</code> copy their 
        * <code>data</code> and <code>length</code> attributes from those of 
        * the source node.</dd>
  -     * </dl> 
  +     *  
        * @param importedNode The node to import.
        * @param deep If <code>true</code>, recursively import the subtree under 
        *   the specified node; if <code>false</code>, import only the node 
  @@ -272,57 +272,28 @@
                              throws DOMException;
   
       /**
  -     * Creates an element of the given qualified name and namespace URI.
  +     * Creates an element of the given qualified name and namespace URI. 
  +     * HTML-only DOM implementations do not need to implement this method.
        * @param namespaceURI The namespace URI of the element to create.
        * @param qualifiedName The qualified name of the element type to 
        *   instantiate.
        * @return A new <code>Element</code> object with the following 
  -     *   attributes:
  -     * <table border='1'>
  -     * <tr>
  -     * <th>Attribute</th>
  -     * <th>Value</th>
  -     * </tr>
  -     * <tr>
  -     * <td valign='top' rowspan='1' colspan='1'><code>Node.nodeName</code></td>
  -     * <td valign='top' rowspan='1' colspan='1'>
  -     *   <code>qualifiedName</code></td>
  -     * </tr>
  -     * <tr>
  -     * <td valign='top' rowspan='1' colspan='1'><code>Node.namespaceURI</code></td>
  -     * <td valign='top' rowspan='1' colspan='1'>
  -     *   <code>namespaceURI</code></td>
  -     * </tr>
  -     * <tr>
  -     * <td valign='top' rowspan='1' colspan='1'><code>Node.prefix</code></td>
  -     * <td valign='top' rowspan='1' colspan='1'>prefix, extracted 
  +     *   attributes:AttributeValue<code>Node.nodeName</code>
  +     *   <code>qualifiedName</code><code>Node.namespaceURI</code>
  +     *   <code>namespaceURI</code><code>Node.prefix</code>prefix, extracted 
        *   from <code>qualifiedName</code>, or <code>null</code> if there is 
  -     *   no prefix</td>
  -     * </tr>
  -     * <tr>
  -     * <td valign='top' rowspan='1' colspan='1'><code>Node.localName</code></td>
  -     * <td valign='top' rowspan='1' colspan='1'>local name, extracted from 
  -     *   <code>qualifiedName</code></td>
  -     * </tr>
  -     * <tr>
  -     * <td valign='top' rowspan='1' colspan='1'><code>Element.tagName</code></td>
  -     * <td valign='top' rowspan='1' colspan='1'>
  -     *   <code>qualifiedName</code></td>
  -     * </tr>
  -     * </table>
  +     *   no prefix<code>Node.localName</code>local name, extracted from 
  +     *   <code>qualifiedName</code><code>Element.tagName</code>
  +     *   <code>qualifiedName</code>
        * @exception DOMException
        *   INVALID_CHARACTER_ERR: Raised if the specified qualified name 
  -     *   contains an illegal character, per the XML 1.0 specification .
  +     *   contains an illegal character.
        *   <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is 
  -     *   malformed per the Namespaces in XML specification, if the 
  -     *   <code>qualifiedName</code> has a prefix and the 
  +     *   malformed, if the <code>qualifiedName</code> has a prefix and the 
        *   <code>namespaceURI</code> is <code>null</code>, or if the 
        *   <code>qualifiedName</code> has a prefix that is "xml" and the 
        *   <code>namespaceURI</code> is different from "
        *   http://www.w3.org/XML/1998/namespace" .
  -     *   <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not 
  -     *   support the <code>"XML"</code> feature, since namespaces were 
  -     *   defined by XML.
        * @since DOM Level 2
        */
       public Element createElementNS(String namespaceURI, 
  @@ -330,65 +301,31 @@
                                      throws DOMException;
   
       /**
  -     * Creates an attribute of the given qualified name and namespace URI.
  +     * Creates an attribute of the given qualified name and namespace URI. 
  +     * HTML-only DOM implementations do not need to implement this method.
        * @param namespaceURI The namespace URI of the attribute to create.
  -     * @param qualifiedName The qualified name of the attribute to 
  -     *   instantiate.
  +     * @param qualifiedName The qualified name of the attribute to instantiate.
        * @return A new <code>Attr</code> object with the following attributes:
  -     * <table border='1'>
  -     * <tr>
  -     * <th>
  -     *   Attribute</th>
  -     * <th>Value</th>
  -     * </tr>
  -     * <tr>
  -     * <td valign='top' rowspan='1' colspan='1'><code>Node.nodeName</code></td>
  -     * <td valign='top' rowspan='1' colspan='1'>qualifiedName</td>
  -     * </tr>
  -     * <tr>
  -     * <td valign='top' rowspan='1' colspan='1'>
  -     *   <code>Node.namespaceURI</code></td>
  -     * <td valign='top' rowspan='1' colspan='1'><code>namespaceURI</code></td>
  -     * </tr>
  -     * <tr>
  -     * <td valign='top' rowspan='1' colspan='1'>
  -     *   <code>Node.prefix</code></td>
  -     * <td valign='top' rowspan='1' colspan='1'>prefix, extracted from 
  +     *   AttributeValue<code>Node.nodeName</code>qualifiedName
  +     *   <code>Node.namespaceURI</code><code>namespaceURI</code>
  +     *   <code>Node.prefix</code>prefix, extracted from 
        *   <code>qualifiedName</code>, or <code>null</code> if there is no 
  -     *   prefix</td>
  -     * </tr>
  -     * <tr>
  -     * <td valign='top' rowspan='1' colspan='1'><code>Node.localName</code></td>
  -     * <td valign='top' rowspan='1' colspan='1'>local name, extracted from 
  -     *   <code>qualifiedName</code></td>
  -     * </tr>
  -     * <tr>
  -     * <td valign='top' rowspan='1' colspan='1'><code>Attr.name</code></td>
  -     * <td valign='top' rowspan='1' colspan='1'>
  -     *   <code>qualifiedName</code></td>
  -     * </tr>
  -     * <tr>
  -     * <td valign='top' rowspan='1' colspan='1'><code>Node.nodeValue</code></td>
  -     * <td valign='top' rowspan='1' colspan='1'>the empty 
  -     *   string</td>
  -     * </tr>
  -     * </table>
  +     *   prefix<code>Node.localName</code>local name, extracted from 
  +     *   <code>qualifiedName</code><code>Attr.name</code>
  +     *   <code>qualifiedName</code><code>Node.nodeValue</code>the empty 
  +     *   string
        * @exception DOMException
        *   INVALID_CHARACTER_ERR: Raised if the specified qualified name 
  -     *   contains an illegal character, per the XML 1.0 specification .
  +     *   contains an illegal character.
        *   <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is 
  -     *   malformed per the Namespaces in XML specification, if the 
  -     *   <code>qualifiedName</code> has a prefix and the 
  +     *   malformed, if the <code>qualifiedName</code> has a prefix and the 
        *   <code>namespaceURI</code> is <code>null</code>, if the 
        *   <code>qualifiedName</code> has a prefix that is "xml" and the 
        *   <code>namespaceURI</code> is different from "
        *   http://www.w3.org/XML/1998/namespace", or if the 
  -     *   <code>qualifiedName</code>, or its prefix, is "xmlns" and the 
  +     *   <code>qualifiedName</code> is "xmlns" and the 
        *   <code>namespaceURI</code> is different from "
        *   http://www.w3.org/2000/xmlns/".
  -     *   <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not 
  -     *   support the <code>"XML"</code> feature, since namespaces were 
  -     *   defined by XML.
        * @since DOM Level 2
        */
       public Attr createAttributeNS(String namespaceURI, 
  @@ -418,7 +355,7 @@
        * information that says which attributes are of type ID. Attributes 
        * with the name "ID" are not of type ID unless so defined. 
        * Implementations that do not know whether attributes are of type ID or 
  -     * not are expected to return <code>null</code>. 
  +     * not are expected to return <code>null</code>.
        * @param elementId The unique <code>id</code> value for an element.
        * @return The matching element.
        * @since DOM Level 2
  
  
  
  1.3       +4 -5      xml-commons/java/external/src/org/w3c/dom/DocumentType.java
  
  Index: DocumentType.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/DocumentType.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- DocumentType.java	1 Aug 2001 23:24:39 -0000	1.2
  +++ DocumentType.java	4 Jan 2002 20:20:49 -0000	1.3
  @@ -68,11 +68,10 @@
       public String getSystemId();
   
       /**
  -     * The internal subset as a string, or <code>null</code> if there is none. 
  -     * This is does not contain the delimiting square brackets.The actual 
  -     * content returned depends on how much information is available to the 
  -     * implementation. This may vary depending on various parameters, 
  -     * including the XML processor used to build the document.
  +     * The internal subset as a string. The actual content returned depends on 
  +     * how much information is available to the implementation. This may 
  +     * vary depending on various parameters, including the XML processor 
  +     * used to build the document.
        * @since DOM Level 2
        */
       public String getInternalSubset();
  
  
  
  1.3       +14 -34    xml-commons/java/external/src/org/w3c/dom/Element.java
  
  Index: Element.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/Element.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- Element.java	1 Aug 2001 23:24:39 -0000	1.2
  +++ Element.java	4 Jan 2002 20:20:49 -0000	1.3
  @@ -39,7 +39,7 @@
        * case-preserving in XML, as are all of the operations of the DOM. The 
        * HTML DOM returns the <code>tagName</code> of an HTML element in the 
        * canonical uppercase form, regardless of the case in the source HTML 
  -     * document.
  +     * document. 
        */
       public String getTagName();
   
  @@ -151,11 +151,8 @@
       public NodeList getElementsByTagName(String name);
   
       /**
  -     * Retrieves an attribute value by local name and namespace URI.
  -     * <br>Documents which do not support the "XML" feature will permit only 
  -     * the DOM Level 1 calls for creating/setting elements and attributes. 
  -     * Hence, if you specify a non-null namespace URI, these DOMs will never 
  -     * find a matching node.
  +     * Retrieves an attribute value by local name and namespace URI. HTML-only 
  +     * DOM implementations do not need to implement this method.
        * @param namespaceURI The namespace URI of the attribute to retrieve.
        * @param localName The local name of the attribute to retrieve.
        * @return The <code>Attr</code> value as a string, or the empty string 
  @@ -180,6 +177,7 @@
        * and use <code>setAttributeNodeNS</code> or 
        * <code>setAttributeNode</code> to assign it as the value of an 
        * attribute.
  +     * <br>HTML-only DOM implementations do not need to implement this method.
        * @param namespaceURI The namespace URI of the attribute to create or 
        *   alter.
        * @param qualifiedName The qualified name of the attribute to create or 
  @@ -187,21 +185,17 @@
        * @param value The value to set in string form.
        * @exception DOMException
        *   INVALID_CHARACTER_ERR: Raised if the specified qualified name 
  -     *   contains an illegal character, per the XML 1.0 specification .
  +     *   contains an illegal character.
        *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
        *   <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is 
  -     *   malformed per the Namespaces in XML specification, if the 
  -     *   <code>qualifiedName</code> has a prefix and the 
  +     *   malformed, if the <code>qualifiedName</code> has a prefix and the 
        *   <code>namespaceURI</code> is <code>null</code>, if the 
        *   <code>qualifiedName</code> has a prefix that is "xml" and the 
        *   <code>namespaceURI</code> is different from "
        *   http://www.w3.org/XML/1998/namespace", or if the 
  -     *   <code>qualifiedName</code>, or its prefix, is "xmlns" and the 
  +     *   <code>qualifiedName</code> is "xmlns" and the 
        *   <code>namespaceURI</code> is different from "
        *   http://www.w3.org/2000/xmlns/".
  -     *   <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not 
  -     *   support the <code>"XML"</code> feature, since namespaces were 
  -     *   defined by XML.
        * @since DOM Level 2
        */
       public void setAttributeNS(String namespaceURI, 
  @@ -214,10 +208,7 @@
        * attribute has a default value it is immediately replaced. The 
        * replacing attribute has the same namespace URI and local name, as 
        * well as the original prefix.
  -     * <br>Documents which do not support the "XML" feature will permit only 
  -     * the DOM Level 1 calls for creating/setting elements and attributes. 
  -     * Hence, if you specify a non-null namespace URI, these DOMs will never 
  -     * find a matching node.
  +     * <br>HTML-only DOM implementations do not need to implement this method.
        * @param namespaceURI The namespace URI of the attribute to remove.
        * @param localName The local name of the attribute to remove.
        * @exception DOMException
  @@ -229,11 +220,8 @@
                                     throws DOMException;
   
       /**
  -     * Retrieves an <code>Attr</code> node by local name and namespace URI.
  -     * <br>Documents which do not support the "XML" feature will permit only 
  -     * the DOM Level 1 calls for creating/setting elements and attributes. 
  -     * Hence, if you specify a non-null namespace URI, these DOMs will never 
  -     * find a matching node.
  +     * Retrieves an <code>Attr</code> node by local name and namespace URI. 
  +     * HTML-only DOM implementations do not need to implement this method.
        * @param namespaceURI The namespace URI of the attribute to retrieve.
        * @param localName The local name of the attribute to retrieve.
        * @return The <code>Attr</code> node with the specified attribute local 
  @@ -248,6 +236,7 @@
        * Adds a new attribute. If an attribute with that local name and that 
        * namespace URI is already present in the element, it is replaced by 
        * the new one.
  +     * <br>HTML-only DOM implementations do not need to implement this method.
        * @param newAttr The <code>Attr</code> node to add to the attribute list.
        * @return If the <code>newAttr</code> attribute replaces an existing 
        *   attribute with the same local name and namespace URI, the replaced 
  @@ -261,9 +250,6 @@
        *   attribute of another <code>Element</code> object. The DOM user must 
        *   explicitly clone <code>Attr</code> nodes to re-use them in other 
        *   elements.
  -     *   <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not 
  -     *   support the <code>"XML"</code> feature, since namespaces were 
  -     *   defined by XML.
        * @since DOM Level 2
        */
       public Attr setAttributeNodeNS(Attr newAttr)
  @@ -274,10 +260,7 @@
        * <code>Elements</code> with a given local name and namespace URI in 
        * the order in which they are encountered in a preorder traversal of 
        * this <code>Element</code> tree.
  -     * <br>Documents which do not support the "XML" feature will permit only 
  -     * the DOM Level 1 calls for creating/setting elements and attributes. 
  -     * Hence, if you specify a non-null namespace URI, these DOMs will never 
  -     * find a matching node.
  +     * <br>HTML-only DOM implementations do not need to implement this method.
        * @param namespaceURI The namespace URI of the elements to match on. The 
        *   special value "*" matches all namespaces.
        * @param localName The local name of the elements to match on. The 
  @@ -304,11 +287,8 @@
       /**
        * Returns <code>true</code> when an attribute with a given local name and 
        * namespace URI is specified on this element or has a default value, 
  -     * <code>false</code> otherwise.
  -     * <br>Documents which do not support the "XML" feature will permit only 
  -     * the DOM Level 1 calls for creating/setting elements and attributes. 
  -     * Hence, if you specify a non-null namespace URI, these DOMs will never 
  -     * find a matching node.
  +     * <code>false</code> otherwise. HTML-only DOM implementations do not 
  +     * need to implement this method.
        * @param namespaceURI The namespace URI of the attribute to look for.
        * @param localName The local name of the attribute to look for.
        * @return <code>true</code> if an attribute with the given local name 
  
  
  
  1.3       +1 -1      xml-commons/java/external/src/org/w3c/dom/Entity.java
  
  Index: Entity.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/Entity.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- Entity.java	1 Aug 2001 23:24:39 -0000	1.2
  +++ Entity.java	4 Jan 2002 20:20:49 -0000	1.3
  @@ -61,7 +61,7 @@
   
       /**
        * For unparsed entities, the name of the notation for the entity. For 
  -     * parsed entities, this is <code>null</code>.
  +     * parsed entities, this is <code>null</code>. 
        */
       public String getNotationName();
   
  
  
  
  1.3       +5 -23     xml-commons/java/external/src/org/w3c/dom/NamedNodeMap.java
  
  Index: NamedNodeMap.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/NamedNodeMap.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- NamedNodeMap.java	1 Aug 2001 23:24:39 -0000	1.2
  +++ NamedNodeMap.java	4 Jan 2002 20:20:49 -0000	1.3
  @@ -56,11 +56,6 @@
        *   <code>Attr</code> that is already an attribute of another 
        *   <code>Element</code> object. The DOM user must explicitly clone 
        *   <code>Attr</code> nodes to re-use them in other elements.
  -     *   <br>HIERARCHY_REQUEST_ERR: Raised if an attempt is made to add a node 
  -     *   doesn't belong in this NamedNodeMap. Examples would include trying 
  -     *   to insert something other than an Attr node into an Element's map 
  -     *   of attributes, or a non-Entity node into the DocumentType's map of 
  -     *   Entities.
        */
       public Node setNamedItem(Node arg)
                                throws DOMException;
  @@ -94,16 +89,13 @@
   
       /**
        * The number of nodes in this map. The range of valid child node indices 
  -     * is <code>0</code> to <code>length-1</code> inclusive.
  +     * is <code>0</code> to <code>length-1</code> inclusive. 
        */
       public int getLength();
   
       /**
  -     * Retrieves a node specified by local name and namespace URI.
  -     * <br>Documents which do not support the "XML" feature will permit only 
  -     * the DOM Level 1 calls for creating/setting elements and attributes. 
  -     * Hence, if you specify a non-null namespace URI, these DOMs will never 
  -     * find a matching node.
  +     * Retrieves a node specified by local name and namespace URI. HTML-only 
  +     * DOM implementations do not need to implement this method.
        * @param namespaceURI The namespace URI of the node to retrieve.
        * @param localName The local name of the node to retrieve.
        * @return A <code>Node</code> (of any type) with the specified local 
  @@ -119,6 +111,7 @@
        * <code>localName</code>. If a node with that namespace URI and that 
        * local name is already present in this map, it is replaced by the new 
        * one.
  +     * <br>HTML-only DOM implementations do not need to implement this method.
        * @param arg A node to store in this map. The node will later be 
        *   accessible using the value of its <code>namespaceURI</code> and 
        *   <code>localName</code> attributes.
  @@ -133,14 +126,6 @@
        *   <code>Attr</code> that is already an attribute of another 
        *   <code>Element</code> object. The DOM user must explicitly clone 
        *   <code>Attr</code> nodes to re-use them in other elements.
  -     *   <br>HIERARCHY_REQUEST_ERR: Raised if an attempt is made to add a node 
  -     *   doesn't belong in this NamedNodeMap. Examples would include trying 
  -     *   to insert something other than an Attr node into an Element's map 
  -     *   of attributes, or a non-Entity node into the DocumentType's map of 
  -     *   Entities.
  -     *   <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not 
  -     *   support the <code>"XML"</code> feature, since namespaces were 
  -     *   defined by XML.
        * @since DOM Level 2
        */
       public Node setNamedItemNS(Node arg)
  @@ -153,10 +138,7 @@
        * attribute of the <code>Node</code> interface. If so, an attribute 
        * immediately appears containing the default value as well as the 
        * corresponding namespace URI, local name, and prefix when applicable.
  -     * <br>Documents which do not support the "XML" feature will permit only 
  -     * the DOM Level 1 calls for creating/setting elements and attributes. 
  -     * Hence, if you specify a non-null namespace URI, these DOMs will never 
  -     * find a matching node.
  +     * <br>HTML-only DOM implementations do not need to implement this method.
        * @param namespaceURI The namespace URI of the node to remove.
        * @param localName The local name of the node to remove.
        * @return The node removed from this map if a node with such a local 
  
  
  
  1.3       +20 -156   xml-commons/java/external/src/org/w3c/dom/Node.java
  
  Index: Node.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/Node.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- Node.java	1 Aug 2001 23:24:39 -0000	1.2
  +++ Node.java	4 Jan 2002 20:20:49 -0000	1.3
  @@ -29,97 +29,6 @@
    * ), this returns <code>null</code>. Note that the specialized interfaces 
    * may contain additional and more convenient mechanisms to get and set the 
    * relevant information.
  - * <p>The values of <code>nodeName</code>, 
  - * <code>nodeValue</code>, and <code>attributes</code> vary according to the 
  - * node type as follows: 
  - * <table border='1'>
  - * <tr>
  - * <th>Interface</th>
  - * <th>nodeName</th>
  - * <th>nodeValue</th>
  - * <th>attributes</th>
  - * </tr>
  - * <tr>
  - * <td valign='top' rowspan='1' colspan='1'>Attr</td>
  - * <td valign='top' rowspan='1' colspan='1'>name of 
  - * attribute</td>
  - * <td valign='top' rowspan='1' colspan='1'>value of attribute</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * </tr>
  - * <tr>
  - * <td valign='top' rowspan='1' colspan='1'>CDATASection</td>
  - * <td valign='top' rowspan='1' colspan='1'><code>"#cdata-section"</code></td>
  - * <td valign='top' rowspan='1' colspan='1'>
  - * content of the CDATA Section</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * </tr>
  - * <tr>
  - * <td valign='top' rowspan='1' colspan='1'>Comment</td>
  - * <td valign='top' rowspan='1' colspan='1'><code>"#comment"</code></td>
  - * <td valign='top' rowspan='1' colspan='1'>content of 
  - * the comment</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * </tr>
  - * <tr>
  - * <td valign='top' rowspan='1' colspan='1'>Document</td>
  - * <td valign='top' rowspan='1' colspan='1'><code>"#document"</code></td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * </tr>
  - * <tr>
  - * <td valign='top' rowspan='1' colspan='1'>DocumentFragment</td>
  - * <td valign='top' rowspan='1' colspan='1'>
  - * <code>"#document-fragment"</code></td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * </tr>
  - * <tr>
  - * <td valign='top' rowspan='1' colspan='1'>DocumentType</td>
  - * <td valign='top' rowspan='1' colspan='1'>document type name</td>
  - * <td valign='top' rowspan='1' colspan='1'>
  - * null</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * </tr>
  - * <tr>
  - * <td valign='top' rowspan='1' colspan='1'>Element</td>
  - * <td valign='top' rowspan='1' colspan='1'>tag name</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * <td valign='top' rowspan='1' colspan='1'>NamedNodeMap</td>
  - * </tr>
  - * <tr>
  - * <td valign='top' rowspan='1' colspan='1'>Entity</td>
  - * <td valign='top' rowspan='1' colspan='1'>entity name</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * </tr>
  - * <tr>
  - * <td valign='top' rowspan='1' colspan='1'>
  - * EntityReference</td>
  - * <td valign='top' rowspan='1' colspan='1'>name of entity referenced</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * </tr>
  - * <tr>
  - * <td valign='top' rowspan='1' colspan='1'>Notation</td>
  - * <td valign='top' rowspan='1' colspan='1'>notation name</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * <td valign='top' rowspan='1' colspan='1'>
  - * null</td>
  - * </tr>
  - * <tr>
  - * <td valign='top' rowspan='1' colspan='1'>ProcessingInstruction</td>
  - * <td valign='top' rowspan='1' colspan='1'>target</td>
  - * <td valign='top' rowspan='1' colspan='1'>entire content excluding the target</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * </tr>
  - * <tr>
  - * <td valign='top' rowspan='1' colspan='1'>Text</td>
  - * <td valign='top' rowspan='1' colspan='1'>
  - * <code>"#text"</code></td>
  - * <td valign='top' rowspan='1' colspan='1'>content of the text node</td>
  - * <td valign='top' rowspan='1' colspan='1'>null</td>
  - * </tr>
  - * </table> 
    * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113'>Document Object Model (DOM) Level 2 Core Specification</a>.
    */
   public interface Node {
  @@ -174,7 +83,7 @@
       public static final short NOTATION_NODE             = 12;
   
       /**
  -     * The name of this node, depending on its type; see the table above.
  +     * The name of this node, depending on its type; see the table above. 
        */
       public String getNodeName();
   
  @@ -190,16 +99,6 @@
        */
       public String getNodeValue()
                                    throws DOMException;
  -    /**
  -     * The value of this node, depending on its type; see the table above. 
  -     * When it is defined to be <code>null</code>, setting it has no effect.
  -     * @exception DOMException
  -     *   NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
  -     * @exception DOMException
  -     *   DOMSTRING_SIZE_ERR: Raised when it would return more characters than 
  -     *   fit in a <code>DOMString</code> variable on the implementation 
  -     *   platform.
  -     */
       public void setNodeValue(String nodeValue)
                                    throws DOMException;
   
  @@ -251,7 +150,7 @@
   
       /**
        * A <code>NamedNodeMap</code> containing the attributes of this node (if 
  -     * it is an <code>Element</code>) or <code>null</code> otherwise.
  +     * it is an <code>Element</code>) or <code>null</code> otherwise. 
        */
       public NamedNodeMap getAttributes();
   
  @@ -274,14 +173,13 @@
        * <code>refChild</code>. If the <code>newChild</code> is already in the 
        * tree, it is first removed.
        * @param newChild The node to insert.
  -     * @param refChild The reference node, i.e., the node before which the 
  -     *   new node must be inserted.
  +     * @param refChild The reference node, i.e., the node before which the new 
  +     *   node must be inserted.
        * @return The node being inserted.
        * @exception DOMException
        *   HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not 
        *   allow children of the type of the <code>newChild</code> node, or if 
  -     *   the node to insert is one of this node's ancestors or this node 
  -     *   itself.
  +     *   the node to insert is one of this node's ancestors.
        *   <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created 
        *   from a different document than the one that created this node.
        *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or 
  @@ -307,8 +205,7 @@
        * @exception DOMException
        *   HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not 
        *   allow children of the type of the <code>newChild</code> node, or if 
  -     *   the node to put in is one of this node's ancestors or this node 
  -     *   itself.
  +     *   the node to put in is one of this node's ancestors.
        *   <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created 
        *   from a different document than the one that created this node.
        *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node or the parent of 
  @@ -337,26 +234,24 @@
        * Adds the node <code>newChild</code> to the end of the list of children 
        * of this node. If the <code>newChild</code> is already in the tree, it 
        * is first removed.
  -     * @param newChild The node to add.If it is a 
  -     *   <code>DocumentFragment</code> object, the entire contents of the 
  -     *   document fragment are moved into the child list of this node
  +     * @param newChild The node to add.If it is a <code>DocumentFragment</code>
  +     *    object, the entire contents of the document fragment are moved 
  +     *   into the child list of this node
        * @return The node added.
        * @exception DOMException
        *   HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not 
        *   allow children of the type of the <code>newChild</code> node, or if 
  -     *   the node to append is one of this node's ancestors or this node 
  -     *   itself.
  +     *   the node to append is one of this node's ancestors.
        *   <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created 
        *   from a different document than the one that created this node.
  -     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or 
  -     *   if the previous parent of the node being inserted is readonly.
  +     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
        */
       public Node appendChild(Node newChild)
                               throws DOMException;
   
       /**
        * Returns whether this node has any children.
  -     * @return <code>true</code> if this node has any children, 
  +     * @return  <code>true</code> if this node has any children, 
        *   <code>false</code> otherwise.
        */
       public boolean hasChildNodes();
  @@ -382,7 +277,7 @@
        * <code>Notation</code> nodes is implementation dependent.
        * @param deep If <code>true</code>, recursively clone the subtree under 
        *   the specified node; if <code>false</code>, clone only the node 
  -     *   itself (and its attributes, if it is an <code>Element</code>).
  +     *   itself (and its attributes, if it is an <code>Element</code>). 
        * @return The duplicate node.
        */
       public Node cloneNode(boolean deep);
  @@ -457,51 +352,20 @@
        * <code>Document</code> interface, this is always <code>null</code>.
        * @exception DOMException
        *   INVALID_CHARACTER_ERR: Raised if the specified prefix contains an 
  -     *   illegal character, per the XML 1.0 specification .
  +     *   illegal character.
        *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
        *   <br>NAMESPACE_ERR: Raised if the specified <code>prefix</code> is 
  -     *   malformed per the Namespaces in XML specification, if the 
  -     *   <code>namespaceURI</code> of this node is <code>null</code>, if the 
  -     *   specified prefix is "xml" and the <code>namespaceURI</code> of this 
  -     *   node is different from "http://www.w3.org/XML/1998/namespace", if 
  -     *   this node is an attribute and the specified prefix is "xmlns" and 
  -     *   the <code>namespaceURI</code> of this node is different from "
  +     *   malformed, if the <code>namespaceURI</code> of this node is 
  +     *   <code>null</code>, if the specified prefix is "xml" and the 
  +     *   <code>namespaceURI</code> of this node is different from "
  +     *   http://www.w3.org/XML/1998/namespace", if this node is an attribute 
  +     *   and the specified prefix is "xmlns" and the 
  +     *   <code>namespaceURI</code> of this node is different from "
        *   http://www.w3.org/2000/xmlns/", or if this node is an attribute and 
        *   the <code>qualifiedName</code> of this node is "xmlns" .
        * @since DOM Level 2
        */
       public String getPrefix();
  -    /**
  -     * The namespace prefix of this node, or <code>null</code> if it is 
  -     * unspecified.
  -     * <br>Note that setting this attribute, when permitted, changes the 
  -     * <code>nodeName</code> attribute, which holds the qualified name, as 
  -     * well as the <code>tagName</code> and <code>name</code> attributes of 
  -     * the <code>Element</code> and <code>Attr</code> interfaces, when 
  -     * applicable.
  -     * <br>Note also that changing the prefix of an attribute that is known to 
  -     * have a default value, does not make a new attribute with the default 
  -     * value and the original prefix appear, since the 
  -     * <code>namespaceURI</code> and <code>localName</code> do not change.
  -     * <br>For nodes of any type other than <code>ELEMENT_NODE</code> and 
  -     * <code>ATTRIBUTE_NODE</code> and nodes created with a DOM Level 1 
  -     * method, such as <code>createElement</code> from the 
  -     * <code>Document</code> interface, this is always <code>null</code>.
  -     * @exception DOMException
  -     *   INVALID_CHARACTER_ERR: Raised if the specified prefix contains an 
  -     *   illegal character, per the XML 1.0 specification .
  -     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
  -     *   <br>NAMESPACE_ERR: Raised if the specified <code>prefix</code> is 
  -     *   malformed per the Namespaces in XML specification, if the 
  -     *   <code>namespaceURI</code> of this node is <code>null</code>, if the 
  -     *   specified prefix is "xml" and the <code>namespaceURI</code> of this 
  -     *   node is different from "http://www.w3.org/XML/1998/namespace", if 
  -     *   this node is an attribute and the specified prefix is "xmlns" and 
  -     *   the <code>namespaceURI</code> of this node is different from "
  -     *   http://www.w3.org/2000/xmlns/", or if this node is an attribute and 
  -     *   the <code>qualifiedName</code> of this node is "xmlns" .
  -     * @since DOM Level 2
  -     */
       public void setPrefix(String prefix)
                                  throws DOMException;
   
  
  
  
  1.3       +1 -1      xml-commons/java/external/src/org/w3c/dom/NodeList.java
  
  Index: NodeList.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/NodeList.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- NodeList.java	1 Aug 2001 23:24:39 -0000	1.2
  +++ NodeList.java	4 Jan 2002 20:20:49 -0000	1.3
  @@ -34,7 +34,7 @@
   
       /**
        * The number of nodes in the list. The range of valid child node indices 
  -     * is 0 to <code>length-1</code> inclusive.
  +     * is 0 to <code>length-1</code> inclusive. 
        */
       public int getLength();
   
  
  
  
  1.3       +0 -7      xml-commons/java/external/src/org/w3c/dom/ProcessingInstruction.java
  
  Index: ProcessingInstruction.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/ProcessingInstruction.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- ProcessingInstruction.java	1 Aug 2001 23:24:39 -0000	1.2
  +++ ProcessingInstruction.java	4 Jan 2002 20:20:49 -0000	1.3
  @@ -34,13 +34,6 @@
        *   NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
        */
       public String getData();
  -    /**
  -     * The content of this processing instruction. This is from the first non 
  -     * white space character after the target to the character immediately 
  -     * preceding the <code>?&gt;</code>.
  -     * @exception DOMException
  -     *   NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
  -     */
       public void setData(String data)
                             throws DOMException;
   
  
  
  
  1.2       +1 -1      xml-commons/java/external/src/org/w3c/dom/css/CSSRuleList.java
  
  Index: CSSRuleList.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/css/CSSRuleList.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- CSSRuleList.java	1 Jun 2001 11:13:12 -0000	1.1
  +++ CSSRuleList.java	4 Jan 2002 20:20:50 -0000	1.2
  @@ -33,7 +33,7 @@
        * collection represents the order of the rules in the CSS style sheet. 
        * If index is greater than or equal to the number of rules in the list, 
        * this returns <code>null</code>. 
  -     * @param indexIndex into the collection
  +     * @param index Index into the collection
        * @return The style rule at the <code>index</code> position in the 
        *   <code>CSSRuleList</code>, or <code>null</code> if that is not a 
        *   valid index. 
  
  
  
  1.2       +1 -1      xml-commons/java/external/src/org/w3c/dom/css/CSSValueList.java
  
  Index: CSSValueList.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/css/CSSValueList.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- CSSValueList.java	1 Jun 2001 11:13:14 -0000	1.1
  +++ CSSValueList.java	4 Jan 2002 20:20:50 -0000	1.2
  @@ -36,7 +36,7 @@
        * this collection represents the order of the values in the CSS style 
        * property. If index is greater than or equal to the number of values 
        * in the list, this returns <code>null</code>.
  -     * @param indexIndex into the collection.
  +     * @param index Index into the collection.
        * @return The <code>CSSValue</code> at the <code>index</code> position 
        *   in the <code>CSSValueList</code>, or <code>null</code> if that is 
        *   not a valid index.
  
  
  
  1.2       +1 -1      xml-commons/java/external/src/org/w3c/dom/events/DocumentEvent.java
  
  Index: DocumentEvent.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/events/DocumentEvent.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- DocumentEvent.java	1 Jun 2001 11:13:19 -0000	1.1
  +++ DocumentEvent.java	4 Jan 2002 20:20:50 -0000	1.2
  @@ -26,7 +26,7 @@
   public interface DocumentEvent {
       /**
        * 
  -     * @param eventTypeThe <code>eventType</code> parameter specifies the 
  +     * @param eventType The <code>eventType</code> parameter specifies the 
        *   type of <code>Event</code> interface to be created. If the 
        *   <code>Event</code> interface specified is supported by the 
        *   implementation this method will return a new <code>Event</code> of 
  
  
  
  1.2       +3 -3      xml-commons/java/external/src/org/w3c/dom/events/Event.java
  
  Index: Event.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/events/Event.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- Event.java	1 Jun 2001 11:13:19 -0000	1.1
  +++ Event.java	4 Jan 2002 20:20:50 -0000	1.2
  @@ -122,7 +122,7 @@
        * <code>Event</code> interface only the values specified in the 
        * <code>initEvent</code> method are modified, all other attributes are 
        * left unchanged.
  -     * @param eventTypeArgSpecifies the event type. This type may be any 
  +     * @param eventTypeArg Specifies the event type. This type may be any 
        *   event type currently defined in this specification or a new event 
        *   type.. The string must be an XML name. Any new event type must not 
        *   begin with any upper, lower, or mixed case version of the string 
  @@ -130,8 +130,8 @@
        *   also strongly recommended that third parties adding their own 
        *   events use their own prefix to avoid confusion and lessen the 
        *   probability of conflicts with other new events.
  -     * @param canBubbleArgSpecifies whether or not the event can bubble.
  -     * @param cancelableArgSpecifies whether or not the event's default 
  +     * @param canBubbleArg Specifies whether or not the event can bubble.
  +     * @param cancelableArg Specifies whether or not the event's default 
        *   action can be prevented.
        */
       public void initEvent(String eventTypeArg, 
  
  
  
  1.2       +7 -7      xml-commons/java/external/src/org/w3c/dom/events/EventTarget.java
  
  Index: EventTarget.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/events/EventTarget.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- EventTarget.java	1 Jun 2001 11:13:19 -0000	1.1
  +++ EventTarget.java	4 Jan 2002 20:20:50 -0000	1.2
  @@ -36,11 +36,11 @@
        * <code>EventListener</code> to be called twice and since they are 
        * discarded they do not need to be removed with the 
        * <code>removeEventListener</code> method. 
  -     * @param typeThe event type for which the user is registering
  -     * @param listenerThe <code>listener</code> parameter takes an interface 
  +     * @param type The event type for which the user is registering
  +     * @param listener The <code>listener</code> parameter takes an interface 
        *   implemented by the user which contains the methods to be called 
        *   when the event occurs.
  -     * @param useCaptureIf true, <code>useCapture</code> indicates that the 
  +     * @param useCapture If true, <code>useCapture</code> indicates that the 
        *   user wishes to initiate capture. After initiating capture, all 
        *   events of the specified type will be dispatched to the registered 
        *   <code>EventListener</code> before being dispatched to any 
  @@ -61,11 +61,11 @@
        * <br>Calling <code>removeEventListener</code> with arguments which do 
        * not identify any currently registered <code>EventListener</code> on 
        * the <code>EventTarget</code> has no effect.
  -     * @param typeSpecifies the event type of the <code>EventListener</code> 
  +     * @param type Specifies the event type of the <code>EventListener</code> 
        *   being removed. 
  -     * @param listenerThe <code>EventListener</code> parameter indicates the 
  +     * @param listener The <code>EventListener</code> parameter indicates the 
        *   <code>EventListener </code> to be removed. 
  -     * @param useCaptureSpecifies whether the <code>EventListener</code> 
  +     * @param useCapture Specifies whether the <code>EventListener</code> 
        *   being removed was registered as a capturing listener or not. If a 
        *   listener was registered twice, one with capture and one without, 
        *   each must be removed separately. Removal of a capturing listener 
  @@ -83,7 +83,7 @@
        * implementation. The target of the event is the 
        * <code> EventTarget</code> on which <code>dispatchEvent</code> is 
        * called. 
  -     * @param evtSpecifies the event type, behavior, and contextual 
  +     * @param evt Specifies the event type, behavior, and contextual 
        *   information to be used in processing the event.
        * @return The return value of <code>dispatchEvent</code> indicates 
        *   whether any of the listeners which handled the event called 
  
  
  
  1.2       +15 -15    xml-commons/java/external/src/org/w3c/dom/events/MouseEvent.java
  
  Index: MouseEvent.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/events/MouseEvent.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- MouseEvent.java	1 Jun 2001 11:13:19 -0000	1.1
  +++ MouseEvent.java	4 Jan 2002 20:20:50 -0000	1.2
  @@ -110,27 +110,27 @@
        * <code>dispatchEvent</code> method, though it may be called multiple 
        * times during that phase if necessary. If called multiple times, the 
        * final invocation takes precedence.
  -     * @param typeArgSpecifies the event type.
  -     * @param canBubbleArgSpecifies whether or not the event can bubble.
  -     * @param cancelableArgSpecifies whether or not the event's default 
  +     * @param typeArg Specifies the event type.
  +     * @param canBubbleArg Specifies whether or not the event can bubble.
  +     * @param cancelableArg Specifies whether or not the event's default 
        *   action can be prevented.
  -     * @param viewArgSpecifies the <code>Event</code>'s 
  +     * @param viewArg Specifies the <code>Event</code>'s 
        *   <code>AbstractView</code>.
  -     * @param detailArgSpecifies the <code>Event</code>'s mouse click count.
  -     * @param screenXArgSpecifies the <code>Event</code>'s screen x coordinate
  -     * @param screenYArgSpecifies the <code>Event</code>'s screen y coordinate
  -     * @param clientXArgSpecifies the <code>Event</code>'s client x coordinate
  -     * @param clientYArgSpecifies the <code>Event</code>'s client y coordinate
  -     * @param ctrlKeyArgSpecifies whether or not control key was depressed 
  +     * @param detailArg Specifies the <code>Event</code>'s mouse click count.
  +     * @param screenXArg Specifies the <code>Event</code>'s screen x coordinate
  +     * @param screenYArg Specifies the <code>Event</code>'s screen y coordinate
  +     * @param clientXArg Specifies the <code>Event</code>'s client x coordinate
  +     * @param clientYArg Specifies the <code>Event</code>'s client y coordinate
  +     * @param ctrlKeyArg Specifies whether or not control key was depressed 
        *   during the <code>Event</code>.
  -     * @param altKeyArgSpecifies whether or not alt key was depressed during 
  +     * @param altKeyArg Specifies whether or not alt key was depressed during 
        *   the <code>Event</code>.
  -     * @param shiftKeyArgSpecifies whether or not shift key was depressed 
  +     * @param shiftKeyArg Specifies whether or not shift key was depressed 
        *   during the <code>Event</code>.
  -     * @param metaKeyArgSpecifies whether or not meta key was depressed 
  +     * @param metaKeyArg Specifies whether or not meta key was depressed 
        *   during the <code>Event</code>.
  -     * @param buttonArgSpecifies the <code>Event</code>'s mouse button.
  -     * @param relatedTargetArgSpecifies the <code>Event</code>'s related 
  +     * @param buttonArg Specifies the <code>Event</code>'s mouse button.
  +     * @param relatedTargetArg Specifies the <code>Event</code>'s related 
        *   <code>EventTarget</code>.
        */
       public void initMouseEvent(String typeArg, 
  
  
  
  1.2       +8 -8      xml-commons/java/external/src/org/w3c/dom/events/MutationEvent.java
  
  Index: MutationEvent.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/events/MutationEvent.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- MutationEvent.java	1 Jun 2001 11:13:19 -0000	1.1
  +++ MutationEvent.java	4 Jan 2002 20:20:50 -0000	1.2
  @@ -82,18 +82,18 @@
        * <code>dispatchEvent</code> method, though it may be called multiple 
        * times during that phase if necessary. If called multiple times, the 
        * final invocation takes precedence.
  -     * @param typeArgSpecifies the event type.
  -     * @param canBubbleArgSpecifies whether or not the event can bubble.
  -     * @param cancelableArgSpecifies whether or not the event's default 
  +     * @param typeArg Specifies the event type.
  +     * @param canBubbleArg Specifies whether or not the event can bubble.
  +     * @param cancelableArg Specifies whether or not the event's default 
        *   action can be prevented.
  -     * @param relatedNodeArgSpecifies the <code>Event</code>'s related Node.
  -     * @param prevValueArgSpecifies the <code>Event</code>'s 
  +     * @param relatedNodeArg Specifies the <code>Event</code>'s related Node.
  +     * @param prevValueArg Specifies the <code>Event</code>'s 
        *   <code>prevValue</code> attribute. This value may be null.
  -     * @param newValueArgSpecifies the <code>Event</code>'s 
  +     * @param newValueArg Specifies the <code>Event</code>'s 
        *   <code>newValue</code> attribute. This value may be null.
  -     * @param attrNameArgSpecifies the <code>Event</code>'s 
  +     * @param attrNameArg Specifies the <code>Event</code>'s 
        *   <code>attrName</code> attribute. This value may be null.
  -     * @param attrChangeArgSpecifies the <code>Event</code>'s 
  +     * @param attrChangeArg Specifies the <code>Event</code>'s 
        *   <code>attrChange</code> attribute
        */
       public void initMutationEvent(String typeArg, 
  
  
  
  1.2       +5 -5      xml-commons/java/external/src/org/w3c/dom/events/UIEvent.java
  
  Index: UIEvent.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/events/UIEvent.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- UIEvent.java	1 Jun 2001 11:13:19 -0000	1.1
  +++ UIEvent.java	4 Jan 2002 20:20:50 -0000	1.2
  @@ -41,13 +41,13 @@
        * <code>dispatchEvent</code> method, though it may be called multiple 
        * times during that phase if necessary. If called multiple times, the 
        * final invocation takes precedence.
  -     * @param typeArgSpecifies the event type.
  -     * @param canBubbleArgSpecifies whether or not the event can bubble.
  -     * @param cancelableArgSpecifies whether or not the event's default 
  +     * @param typeArg Specifies the event type.
  +     * @param canBubbleArg Specifies whether or not the event can bubble.
  +     * @param cancelableArg Specifies whether or not the event's default 
        *   action can be prevented.
  -     * @param viewArgSpecifies the <code>Event</code>'s 
  +     * @param viewArg Specifies the <code>Event</code>'s 
        *   <code>AbstractView</code>.
  -     * @param detailArgSpecifies the <code>Event</code>'s detail.
  +     * @param detailArg Specifies the <code>Event</code>'s detail.
        */
       public void initUIEvent(String typeArg, 
                               boolean canBubbleArg, 
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLAnchorElement.java
  
  Index: HTMLAnchorElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * The anchor element. See the A element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLAnchorElement extends HTMLElement {
      /**
       * A single character access key to give access to the form control. See 
       * the accesskey attribute definition in HTML 4.0.
       */
      public String getAccessKey();
      public void setAccessKey(String accessKey);
  
      /**
       * The character encoding of the linked resource. See the charset 
       * attribute definition in HTML 4.0.
       */
      public String getCharset();
      public void setCharset(String charset);
  
      /**
       * Comma-separated list of lengths, defining an active region geometry. 
       * See also <code>shape</code> for the shape of the region. See the 
       * coords attribute definition in HTML 4.0.
       */
      public String getCoords();
      public void setCoords(String coords);
  
      /**
       * The URI of the linked resource. See the href attribute definition in 
       * HTML 4.0.
       */
      public String getHref();
      public void setHref(String href);
  
      /**
       * Language code of the linked resource. See the hreflang attribute 
       * definition in HTML 4.0.
       */
      public String getHreflang();
      public void setHreflang(String hreflang);
  
      /**
       * Anchor name. See the name attribute definition in HTML 4.0.
       */
      public String getName();
      public void setName(String name);
  
      /**
       * Forward link type. See the rel attribute definition in HTML 4.0.
       */
      public String getRel();
      public void setRel(String rel);
  
      /**
       * Reverse link type. See the rev attribute definition in HTML 4.0.
       */
      public String getRev();
      public void setRev(String rev);
  
      /**
       * The shape of the active area. The coordinates are given by 
       * <code>coords</code>. See the shape attribute definition in HTML 4.0.
       */
      public String getShape();
      public void setShape(String shape);
  
      /**
       * Index that represents the element's position in the tabbing order. See 
       * the tabindex attribute definition in HTML 4.0.
       */
      public int getTabIndex();
      public void setTabIndex(int tabIndex);
  
      /**
       * Frame to render the resource in. See the target attribute definition in 
       * HTML 4.0.
       */
      public String getTarget();
      public void setTarget(String target);
  
      /**
       * Advisory content type. See the type attribute definition in HTML 4.0.
       */
      public String getType();
      public void setType(String type);
  
      /**
       * Removes keyboard focus from this element.
       */
      public void blur();
  
      /**
       * Gives keyboard focus to this element.
       */
      public void focus();
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLAppletElement.java
  
  Index: HTMLAppletElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * An embedded Java applet. See the APPLET element definition in HTML 4.0. 
   * This element is deprecated in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLAppletElement extends HTMLElement {
      /**
       * Aligns this object (vertically or horizontally) with respect to its 
       * surrounding text. See the align attribute definition in HTML 4.0. 
       * This attribute is deprecated in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
      /**
       * Alternate text for user agents not rendering the normal content of this 
       * element. See the alt attribute definition in HTML 4.0. This attribute 
       * is deprecated in HTML 4.0.
       */
      public String getAlt();
      public void setAlt(String alt);
  
      /**
       * Comma-separated archive list. See the archive attribute definition in 
       * HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getArchive();
      public void setArchive(String archive);
  
      /**
       * Applet class file. See the code attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getCode();
      public void setCode(String code);
  
      /**
       * Optional base URI for applet. See the codebase attribute definition in 
       * HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getCodeBase();
      public void setCodeBase(String codeBase);
  
      /**
       * Override height. See the height attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getHeight();
      public void setHeight(String height);
  
      /**
       * Horizontal space to the left and right of this image, applet, or 
       * object. See the hspace attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getHspace();
      public void setHspace(String hspace);
  
      /**
       * The name of the applet. See the name attribute definition in HTML 4.0. 
       * This attribute is deprecated in HTML 4.0.
       */
      public String getName();
      public void setName(String name);
  
      /**
       * Serialized applet file. See the object attribute definition in HTML 
       * 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getObject();
      public void setObject(String object);
  
      /**
       * Vertical space above and below this image, applet, or object. See the 
       * vspace attribute definition in HTML 4.0. This attribute is deprecated 
       * in HTML 4.0.
       */
      public String getVspace();
      public void setVspace(String vspace);
  
      /**
       * Override width. See the width attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getWidth();
      public void setWidth(String width);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLAreaElement.java
  
  Index: HTMLAreaElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Client-side image map area definition. See the AREA element definition in 
   * HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLAreaElement extends HTMLElement {
      /**
       * A single character access key to give access to the form control. See 
       * the accesskey attribute definition in HTML 4.0.
       */
      public String getAccessKey();
      public void setAccessKey(String accessKey);
  
      /**
       * Alternate text for user agents not rendering the normal content of this 
       * element. See the alt attribute definition in HTML 4.0.
       */
      public String getAlt();
      public void setAlt(String alt);
  
      /**
       * Comma-separated list of lengths, defining an active region geometry. 
       * See also <code>shape</code> for the shape of the region. See the 
       * coords attribute definition in HTML 4.0.
       */
      public String getCoords();
      public void setCoords(String coords);
  
      /**
       * The URI of the linked resource. See the href attribute definition in 
       * HTML 4.0.
       */
      public String getHref();
      public void setHref(String href);
  
      /**
       * Specifies that this area is inactive, i.e., has no associated action. 
       * See the nohref attribute definition in HTML 4.0.
       */
      public boolean getNoHref();
      public void setNoHref(boolean noHref);
  
      /**
       * The shape of the active area. The coordinates are given by 
       * <code>coords</code>. See the shape attribute definition in HTML 4.0.
       */
      public String getShape();
      public void setShape(String shape);
  
      /**
       * Index that represents the element's position in the tabbing order. See 
       * the tabindex attribute definition in HTML 4.0.
       */
      public int getTabIndex();
      public void setTabIndex(int tabIndex);
  
      /**
       * Frame to render the resource in. See the target attribute definition in 
       * HTML 4.0.
       */
      public String getTarget();
      public void setTarget(String target);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLBRElement.java
  
  Index: HTMLBRElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Force a line break. See the BR element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLBRElement extends HTMLElement {
      /**
       * Control flow of text around floats. See the clear attribute definition 
       * in HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getClear();
      public void setClear(String clear);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLBaseElement.java
  
  Index: HTMLBaseElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Document base URI. See the BASE element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLBaseElement extends HTMLElement {
      /**
       * The base URI. See the href attribute definition in HTML 4.0.
       */
      public String getHref();
      public void setHref(String href);
  
      /**
       * The default target frame. See the target attribute definition in HTML 
       * 4.0.
       */
      public String getTarget();
      public void setTarget(String target);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLBaseFontElement.java
  
  Index: HTMLBaseFontElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Base font. See the BASEFONT element definition in HTML 4.0. This element is 
   * deprecated in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLBaseFontElement extends HTMLElement {
      /**
       * Font color. See the color attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getColor();
      public void setColor(String color);
  
      /**
       * Font face identifier. See the face attribute definition in HTML 4.0. 
       * This attribute is deprecated in HTML 4.0.
       */
      public String getFace();
      public void setFace(String face);
  
      /**
       * Font size. See the size attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getSize();
      public void setSize(String size);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLBodyElement.java
  
  Index: HTMLBodyElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * The HTML document body. This element is always present in the DOM API, even 
   * if the tags are not present in the source document. See the BODY element 
   * definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLBodyElement extends HTMLElement {
      /**
       * Color of active links (after mouse-button down, but before mouse-button 
       * up). See the alink attribute definition in HTML 4.0. This attribute 
       * is deprecated in HTML 4.0.
       */
      public String getALink();
      public void setALink(String aLink);
  
      /**
       * URI of the background texture tile image. See the background attribute 
       * definition in HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getBackground();
      public void setBackground(String background);
  
      /**
       * Document background color. See the bgcolor attribute definition in HTML 
       * 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getBgColor();
      public void setBgColor(String bgColor);
  
      /**
       * Color of links that are not active and unvisited. See the link 
       * attribute definition in HTML 4.0. This attribute is deprecated in 
       * HTML 4.0.
       */
      public String getLink();
      public void setLink(String link);
  
      /**
       * Document text color. See the text attribute definition in HTML 4.0. 
       * This attribute is deprecated in HTML 4.0.
       */
      public String getText();
      public void setText(String text);
  
      /**
       * Color of links that have been visited by the user. See the vlink 
       * attribute definition in HTML 4.0. This attribute is deprecated in 
       * HTML 4.0.
       */
      public String getVLink();
      public void setVLink(String vLink);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLButtonElement.java
  
  Index: HTMLButtonElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Push button. See the BUTTON element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLButtonElement extends HTMLElement {
      /**
       * Returns the <code>FORM</code> element containing this control. Returns 
       * <code>null</code> if this control is not within the context of a 
       * form. 
       */
      public HTMLFormElement getForm();
  
      /**
       * A single character access key to give access to the form control. See 
       * the accesskey attribute definition in HTML 4.0.
       */
      public String getAccessKey();
      public void setAccessKey(String accessKey);
  
      /**
       * The control is unavailable in this context. See the disabled attribute 
       * definition in HTML 4.0.
       */
      public boolean getDisabled();
      public void setDisabled(boolean disabled);
  
      /**
       * Form control or object name when submitted with a form. See the name 
       * attribute definition in HTML 4.0.
       */
      public String getName();
      public void setName(String name);
  
      /**
       * Index that represents the element's position in the tabbing order. See 
       * the tabindex attribute definition in HTML 4.0.
       */
      public int getTabIndex();
      public void setTabIndex(int tabIndex);
  
      /**
       * The type of button. See the type attribute definition in HTML 4.0.
       */
      public String getType();
  
      /**
       * The current form control value. See the value attribute definition in 
       * HTML 4.0.
       */
      public String getValue();
      public void setValue(String value);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLCollection.java
  
  Index: HTMLCollection.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  import org.w3c.dom.Node;
  
  /**
   * An <code>HTMLCollection</code> is a list of nodes. An individual node may 
   * be accessed by either ordinal index or the node's <code>name</code> or 
   * <code>id</code> attributes. Note: Collections in the HTML DOM are assumed 
   * to be live meaning that they are automatically updated when the 
   * underlying document is changed. 
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLCollection {
      /**
       * This attribute specifies the length or size of the list. 
       */
      public int getLength();
  
      /**
       * This method retrieves a node specified by ordinal index. Nodes are 
       * numbered in tree order (depth-first traversal order).
       * @param index The index of the node to be fetched. The index origin is 0.
       * @return The <code>Node</code> at the corresponding position upon 
       *   success. A value of <code>null</code> is returned if the index is 
       *   out of range. 
       */
      public Node item(int index);
  
      /**
       * This method retrieves a <code>Node</code> using a name. It first 
       * searches for a <code>Node</code> with a matching <code>id</code> 
       * attribute. If it doesn't find one, it then searches for a 
       * <code>Node</code> with a matching <code>name</code> attribute, but 
       * only on those elements that are allowed a name attribute. 
       * @param name The name of the <code>Node</code> to be fetched.
       * @return The <code>Node</code> with a <code>name</code> or 
       *   <code>id</code> attribute whose value corresponds to the specified 
       *   string. Upon failure (e.g., no node with this name exists), returns 
       *   <code>null</code>.
       */
      public Node namedItem(String name);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLDListElement.java
  
  Index: HTMLDListElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Definition list. See the DL element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLDListElement extends HTMLElement {
      /**
       * Reduce spacing between list items. See the compact attribute definition 
       * in HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public boolean getCompact();
      public void setCompact(boolean compact);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLDirectoryElement.java
  
  Index: HTMLDirectoryElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Directory list. See the DIR element definition in HTML 4.0. This element is 
   * deprecated in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLDirectoryElement extends HTMLElement {
      /**
       * Reduce spacing between list items. See the compact attribute definition 
       * in HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public boolean getCompact();
      public void setCompact(boolean compact);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLDivElement.java
  
  Index: HTMLDivElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Generic block container. See the DIV element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLDivElement extends HTMLElement {
      /**
       * Horizontal text alignment. See the align attribute definition in HTML 
       * 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLDocument.java
  
  Index: HTMLDocument.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  import org.w3c.dom.Document;
  import org.w3c.dom.NodeList;
  import org.w3c.dom.Element;
  
  /**
   * An <code>HTMLDocument</code> is the root of the HTML hierarchy and holds 
   * the entire content. Besides providing access to the hierarchy, it also 
   * provides some convenience methods for accessing certain sets of 
   * information from the document.
   * <p>The following properties have been deprecated in favor of the 
   * corresponding ones for the <code>BODY</code> element:alinkColorbackground
   * bgColorfgColorlinkColorvlinkColor
   * <p> 
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLDocument extends Document {
      /**
       * The title of a document as specified by the <code>TITLE</code> element 
       * in the head of the document. 
       */
      public String getTitle();
      public void setTitle(String title);
  
      /**
       * Returns the URI of the page that linked to this page. The value is an 
       * empty string if the user navigated to the page directly (not through 
       * a link, but, for example, via a bookmark). 
       */
      public String getReferrer();
  
      /**
       * The domain name of the server that served the document, or null if the 
       * server cannot be identified by a domain name. 
       */
      public String getDomain();
  
      /**
       * The complete URI of the document. 
       */
      public String getURL();
  
      /**
       * The element that contains the content for the document. In documents 
       * with <code>BODY</code> contents, returns the <code>BODY</code> 
       * element. In frameset documents, this returns the outermost 
       * <code>FRAMESET</code> element. 
       */
      public HTMLElement getBody();
      public void setBody(HTMLElement body);
  
      /**
       * A collection of all the <code>IMG</code> elements in a document. The 
       * behavior is limited to <code>IMG</code> elements for backwards 
       * compatibility. 
       */
      public HTMLCollection getImages();
  
      /**
       * A collection of all the <code>OBJECT</code> elements that include 
       * applets and <code>APPLET</code> (deprecated) elements in a document. 
       */
      public HTMLCollection getApplets();
  
      /**
       * A collection of all <code>AREA</code> elements and anchor (
       * <code>A</code>) elements in a document with a value for the 
       * <code>href</code> attribute. 
       */
      public HTMLCollection getLinks();
  
      /**
       * A collection of all the forms of a document. 
       */
      public HTMLCollection getForms();
  
      /**
       * A collection of all the anchor (<code>A</code>) elements in a document 
       * with a value for the <code>name</code> attribute.Note. For reasons of 
       * backwards compatibility, the returned set of anchors only contains 
       * those anchors created with the <code>name</code> attribute, not those 
       * created with the <code>id</code> attribute. 
       */
      public HTMLCollection getAnchors();
  
      /**
       * The cookies associated with this document. If there are none, the value 
       * is an empty string. Otherwise, the value is a string: a 
       * semicolon-delimited list of "name=value" pairs for all the cookies 
       * associated with the page. For example, 
       * <code>name=value;expires=date</code>. 
       */
      public String getCookie();
      public void setCookie(String cookie);
  
      /**
       * Note. This method and the ones following allow a user to add to or 
       * replace the structure model of a document using strings of unparsed 
       * HTML. At the time of writing alternate methods for providing similar 
       * functionality for both HTML and XML documents were being considered. 
       * The following methods may be deprecated at some point in the future 
       * in favor of a more general-purpose mechanism.
       * <br>Open a document stream for writing. If a document exists in the 
       * target, this method clears it.
       */
      public void open();
  
      /**
       * Closes a document stream opened by <code>open()</code> and forces 
       * rendering.
       */
      public void close();
  
      /**
       * Write a string of text to a document stream opened by 
       * <code>open()</code>. The text is parsed into the document's structure 
       * model.
       * @param text The string to be parsed into some structure in the document 
       *   structure model.
       */
      public void write(String text);
  
      /**
       * Write a string of text followed by a newline character to a document 
       * stream opened by <code>open()</code>. The text is parsed into the 
       * document's structure model.
       * @param text The string to be parsed into some structure in the document 
       *   structure model.
       */
      public void writeln(String text);
  
      /**
       * Returns the Element whose <code>id</code> is given by elementId. If no 
       * such element exists, returns <code>null</code>. Behavior is not 
       * defined if more than one element has this <code>id</code>. 
       * @param elementId The unique <code>id</code> value for an element.
       * @return The matching element.
       */
      public Element getElementById(String elementId);
  
      /**
       * Returns the (possibly empty) collection of elements whose 
       * <code>name</code> value is given by <code>elementName</code>.
       * @param elementName The <code>name</code> attribute value for an element.
       * @return The matching elements.
       */
      public NodeList getElementsByName(String elementName);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLElement.java
  
  Index: HTMLElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  import org.w3c.dom.Element;
  
  /**
   * All HTML element interfaces derive from this class. Elements that only 
   * expose the HTML core attributes are represented by the base 
   * <code>HTMLElement</code> interface. These elements are as follows:HEAD
   * special: SUB, SUP, SPAN, BDOfont: TT, I, B, U, S, STRIKE, BIG, SMALL
   * phrase: EM, STRONG, DFN, CODE, SAMP, KBD, VAR, CITE, ACRONYM, ABBRlist: 
   * DD, DTNOFRAMES, NOSCRIPTADDRESS, CENTER
   * <p>Note. The <code>style</code> attribute for this interface is reserved 
   * for future usage. 
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLElement extends Element {
      /**
       * The element's identifier. See the id attribute definition in HTML 4.0.
       */
      public String getId();
      public void setId(String id);
  
      /**
       * The element's advisory title. See the title attribute definition in 
       * HTML 4.0.
       */
      public String getTitle();
      public void setTitle(String title);
  
      /**
       * Language code defined in RFC 1766. See the lang attribute definition in 
       * HTML 4.0.
       */
      public String getLang();
      public void setLang(String lang);
  
      /**
       * Specifies the base direction of directionally neutral text and the 
       * directionality of tables. See the dir attribute definition in HTML 
       * 4.0.
       */
      public String getDir();
      public void setDir(String dir);
  
      /**
       * The class attribute of the element. This attribute has been renamed due 
       * to conflicts with the "class" keyword exposed by many languages. See 
       * the class attribute definition in HTML 4.0.
       */
      public String getClassName();
      public void setClassName(String className);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLFieldSetElement.java
  
  Index: HTMLFieldSetElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Organizes form controls into logical groups. See the FIELDSET element 
   * definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLFieldSetElement extends HTMLElement {
      /**
       * Returns the <code>FORM</code> element containing this control. Returns 
       * <code>null</code> if this control is not within the context of a 
       * form. 
       */
      public HTMLFormElement getForm();
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLFontElement.java
  
  Index: HTMLFontElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Local change to font. See the FONT element definition in HTML 4.0. This 
   * element is deprecated in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLFontElement extends HTMLElement {
      /**
       * Font color. See the color attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getColor();
      public void setColor(String color);
  
      /**
       * Font face identifier. See the face attribute definition in HTML 4.0. 
       * This attribute is deprecated in HTML 4.0.
       */
      public String getFace();
      public void setFace(String face);
  
      /**
       * Font size. See the size attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getSize();
      public void setSize(String size);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLFormElement.java
  
  Index: HTMLFormElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * The <code>FORM</code> element encompasses behavior similar to a collection 
   * and an element. It provides direct access to the contained input elements 
   * as well as the attributes of the form element. See the FORM element 
   * definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLFormElement extends HTMLElement {
      /**
       * Returns a collection of all control elements in the form. 
       */
      public HTMLCollection getElements();
  
      /**
       * The number of form controls in the form.
       */
      public int getLength();
  
      /**
       * Names the form. 
       */
      public String getName();
      public void setName(String name);
  
      /**
       * List of character sets supported by the server. See the accept-charset 
       * attribute definition in HTML 4.0.
       */
      public String getAcceptCharset();
      public void setAcceptCharset(String acceptCharset);
  
      /**
       * Server-side form handler. See the action attribute definition in HTML 
       * 4.0.
       */
      public String getAction();
      public void setAction(String action);
  
      /**
       * The content type of the submitted form, generally 
       * "application/x-www-form-urlencoded". See the enctype attribute 
       * definition in HTML 4.0.
       */
      public String getEnctype();
      public void setEnctype(String enctype);
  
      /**
       * HTTP method used to submit form. See the method attribute definition in 
       * HTML 4.0.
       */
      public String getMethod();
      public void setMethod(String method);
  
      /**
       * Frame to render the resource in. See the target attribute definition in 
       * HTML 4.0.
       */
      public String getTarget();
      public void setTarget(String target);
  
      /**
       * Submits the form. It performs the same action as a submit button.
       */
      public void submit();
  
      /**
       * Restores a form element's default values. It performs the same action 
       * as a reset button.
       */
      public void reset();
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLFrameElement.java
  
  Index: HTMLFrameElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Create a frame. See the FRAME element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLFrameElement extends HTMLElement {
      /**
       * Request frame borders. See the frameborder attribute definition in HTML 
       * 4.0.
       */
      public String getFrameBorder();
      public void setFrameBorder(String frameBorder);
  
      /**
       * URI designating a long description of this image or frame. See the 
       * longdesc attribute definition in HTML 4.0.
       */
      public String getLongDesc();
      public void setLongDesc(String longDesc);
  
      /**
       * Frame margin height, in pixels. See the marginheight attribute 
       * definition in HTML 4.0.
       */
      public String getMarginHeight();
      public void setMarginHeight(String marginHeight);
  
      /**
       * Frame margin width, in pixels. See the marginwidth attribute definition 
       * in HTML 4.0.
       */
      public String getMarginWidth();
      public void setMarginWidth(String marginWidth);
  
      /**
       * The frame name (object of the <code>target</code> attribute). See the 
       * name attribute definition in HTML 4.0.
       */
      public String getName();
      public void setName(String name);
  
      /**
       * When true, forbid user from resizing frame. See the noresize attribute 
       * definition in HTML 4.0.
       */
      public boolean getNoResize();
      public void setNoResize(boolean noResize);
  
      /**
       * Specify whether or not the frame should have scrollbars. See the 
       * scrolling attribute definition in HTML 4.0.
       */
      public String getScrolling();
      public void setScrolling(String scrolling);
  
      /**
       * A URI designating the initial frame contents. See the src attribute 
       * definition in HTML 4.0.
       */
      public String getSrc();
      public void setSrc(String src);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLFrameSetElement.java
  
  Index: HTMLFrameSetElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Create a grid of frames. See the FRAMESET element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLFrameSetElement extends HTMLElement {
      /**
       * The number of columns of frames in the frameset. See the cols attribute 
       * definition in HTML 4.0.
       */
      public String getCols();
      public void setCols(String cols);
  
      /**
       * The number of rows of frames in the frameset. See the rows attribute 
       * definition in HTML 4.0.
       */
      public String getRows();
      public void setRows(String rows);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLHRElement.java
  
  Index: HTMLHRElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Create a horizontal rule. See the HR element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLHRElement extends HTMLElement {
      /**
       * Align the rule on the page. See the align attribute definition in HTML 
       * 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
      /**
       * Indicates to the user agent that there should be no shading in the 
       * rendering of this element. See the noshade attribute definition in 
       * HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public boolean getNoShade();
      public void setNoShade(boolean noShade);
  
      /**
       * The height of the rule. See the size attribute definition in HTML 4.0. 
       * This attribute is deprecated in HTML 4.0.
       */
      public String getSize();
      public void setSize(String size);
  
      /**
       * The width of the rule. See the width attribute definition in HTML 4.0. 
       * This attribute is deprecated in HTML 4.0.
       */
      public String getWidth();
      public void setWidth(String width);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLHeadElement.java
  
  Index: HTMLHeadElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Document head information. See the HEAD element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLHeadElement extends HTMLElement {
      /**
       * URI designating a metadata profile. See the profile attribute definition
       *  in HTML 4.0.
       */
      public String getProfile();
      public void setProfile(String profile);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLHeadingElement.java
  
  Index: HTMLHeadingElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * For the <code>H1</code> to <code>H6</code> elements. See the H1 element 
   * definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLHeadingElement extends HTMLElement {
      /**
       * Horizontal text alignment. See the align attribute definition in HTML 
       * 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLHtmlElement.java
  
  Index: HTMLHtmlElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Root of an HTML document. See the HTML element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLHtmlElement extends HTMLElement {
      /**
       * Version information about the document's DTD. See the version attribute 
       * definition in HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getVersion();
      public void setVersion(String version);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLIFrameElement.java
  
  Index: HTMLIFrameElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Inline subwindows. See the IFRAME element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLIFrameElement extends HTMLElement {
      /**
       * Aligns this object (vertically or horizontally) with respect to its 
       * surrounding text. See the align attribute definition in HTML 4.0. 
       * This attribute is deprecated in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
      /**
       * Request frame borders. See the frameborder attribute definition in HTML 
       * 4.0.
       */
      public String getFrameBorder();
      public void setFrameBorder(String frameBorder);
  
      /**
       * Frame height. See the height attribute definition in HTML 4.0.
       */
      public String getHeight();
      public void setHeight(String height);
  
      /**
       * URI designating a long description of this image or frame. See the 
       * longdesc attribute definition in HTML 4.0.
       */
      public String getLongDesc();
      public void setLongDesc(String longDesc);
  
      /**
       * Frame margin height, in pixels. See the marginheight attribute 
       * definition in HTML 4.0.
       */
      public String getMarginHeight();
      public void setMarginHeight(String marginHeight);
  
      /**
       * Frame margin width, in pixels. See the marginwidth attribute definition 
       * in HTML 4.0.
       */
      public String getMarginWidth();
      public void setMarginWidth(String marginWidth);
  
      /**
       * The frame name (object of the <code>target</code> attribute). See the 
       * name attribute definition in HTML 4.0.
       */
      public String getName();
      public void setName(String name);
  
      /**
       * Specify whether or not the frame should have scrollbars. See the 
       * scrolling attribute definition in HTML 4.0.
       */
      public String getScrolling();
      public void setScrolling(String scrolling);
  
      /**
       * A URI designating the initial frame contents. See the src attribute 
       * definition in HTML 4.0.
       */
      public String getSrc();
      public void setSrc(String src);
  
      /**
       * Frame width. See the width attribute definition in HTML 4.0.
       */
      public String getWidth();
      public void setWidth(String width);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLImageElement.java
  
  Index: HTMLImageElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Embedded image. See the IMG element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLImageElement extends HTMLElement {
      /**
       * URI designating the source of this image, for low-resolution output. 
       */
      public String getLowSrc();
      public void setLowSrc(String lowSrc);
  
      /**
       * The name of the element (for backwards compatibility). 
       */
      public String getName();
      public void setName(String name);
  
      /**
       * Aligns this object (vertically or horizontally) with respect to its 
       * surrounding text. See the align attribute definition in HTML 4.0. 
       * This attribute is deprecated in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
      /**
       * Alternate text for user agents not rendering the normal content of this 
       * element. See the alt attribute definition in HTML 4.0.
       */
      public String getAlt();
      public void setAlt(String alt);
  
      /**
       * Width of border around image. See the border attribute definition in 
       * HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getBorder();
      public void setBorder(String border);
  
      /**
       * Override height. See the height attribute definition in HTML 4.0.
       */
      public String getHeight();
      public void setHeight(String height);
  
      /**
       * Horizontal space to the left and right of this image. See the hspace 
       * attribute definition in HTML 4.0. This attribute is deprecated in 
       * HTML 4.0.
       */
      public String getHspace();
      public void setHspace(String hspace);
  
      /**
       * Use server-side image map. See the ismap attribute definition in HTML 
       * 4.0.
       */
      public boolean getIsMap();
      public void setIsMap(boolean isMap);
  
      /**
       * URI designating a long description of this image or frame. See the 
       * longdesc attribute definition in HTML 4.0.
       */
      public String getLongDesc();
      public void setLongDesc(String longDesc);
  
      /**
       * URI designating the source of this image. See the src attribute 
       * definition in HTML 4.0.
       */
      public String getSrc();
      public void setSrc(String src);
  
      /**
       * Use client-side image map. See the usemap attribute definition in HTML 
       * 4.0.
       */
      public String getUseMap();
      public void setUseMap(String useMap);
  
      /**
       * Vertical space above and below this image. See the vspace attribute 
       * definition in HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getVspace();
      public void setVspace(String vspace);
  
      /**
       * Override width. See the width attribute definition in HTML 4.0.
       */
      public String getWidth();
      public void setWidth(String width);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLInputElement.java
  
  Index: HTMLInputElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Form control. Note. Depending upon the environment in which the page is 
   * being viewed, the value property may be read-only for the file upload 
   * input type. For the "password" input type, the actual value returned may 
   * be masked to prevent unauthorized use. See the INPUT element definition 
   * in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLInputElement extends HTMLElement {
      /**
       * When the <code>type</code> attribute of the element has the value 
       * "Text", "File" or "Password", this represents the HTML value 
       * attribute of the element. The value of this attribute does not change 
       * if the contents of the corresponding form control, in an interactive 
       * user agent, changes. Changing this attribute, however, resets the 
       * contents of the form control. See the value attribute definition in 
       * HTML 4.0.
       */
      public String getDefaultValue();
      public void setDefaultValue(String defaultValue);
  
      /**
       * When <code>type</code> has the value "Radio" or "Checkbox", this 
       * represents the HTML checked attribute of the element. The value of 
       * this attribute does not change if the state of the corresponding form 
       * control, in an interactive user agent, changes. Changes to this 
       * attribute, however, resets the state of the form control. See the 
       * checked attribute definition in HTML 4.0.
       */
      public boolean getDefaultChecked();
      public void setDefaultChecked(boolean defaultChecked);
  
      /**
       * Returns the <code>FORM</code> element containing this control. Returns 
       * <code>null</code> if this control is not within the context of a 
       * form. 
       */
      public HTMLFormElement getForm();
  
      /**
       * A comma-separated list of content types that a server processing this 
       * form will handle correctly. See the accept attribute definition in 
       * HTML 4.0.
       */
      public String getAccept();
      public void setAccept(String accept);
  
      /**
       * A single character access key to give access to the form control. See 
       * the accesskey attribute definition in HTML 4.0.
       */
      public String getAccessKey();
      public void setAccessKey(String accessKey);
  
      /**
       * Aligns this object (vertically or horizontally) with respect to its 
       * surrounding text. See the align attribute definition in HTML 4.0. 
       * This attribute is deprecated in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
      /**
       * Alternate text for user agents not rendering the normal content of this 
       * element. See the alt attribute definition in HTML 4.0.
       */
      public String getAlt();
      public void setAlt(String alt);
  
      /**
       * When the <code>type</code> attribute of the element has the value 
       * "Radio" or "Checkbox", this represents the current state of the form 
       * control, in an interactive user agent. Changes to this attribute 
       * change the state of the form control, but do not change the value of 
       * the HTML value attribute of the element.
       */
      public boolean getChecked();
      public void setChecked(boolean checked);
  
      /**
       * The control is unavailable in this context. See the disabled attribute 
       * definition in HTML 4.0.
       */
      public boolean getDisabled();
      public void setDisabled(boolean disabled);
  
      /**
       * Maximum number of characters for text fields, when <code>type</code> 
       * has the value "Text" or "Password". See the maxlength attribute 
       * definition in HTML 4.0.
       */
      public int getMaxLength();
      public void setMaxLength(int maxLength);
  
      /**
       * Form control or object name when submitted with a form. See the name 
       * attribute definition in HTML 4.0.
       */
      public String getName();
      public void setName(String name);
  
      /**
       * This control is read-only. Relevant only when <code>type</code> has the 
       * value "Text" or "Password". See the readonly attribute definition in 
       * HTML 4.0.
       */
      public boolean getReadOnly();
      public void setReadOnly(boolean readOnly);
  
      /**
       * Size information. The precise meaning is specific to each type of 
       * field. See the size attribute definition in HTML 4.0.
       */
      public String getSize();
      public void setSize(String size);
  
      /**
       * When the <code>type</code> attribute has the value "Image", this 
       * attribute specifies the location of the image to be used to decorate 
       * the graphical submit button. See the src attribute definition in HTML 
       * 4.0.
       */
      public String getSrc();
      public void setSrc(String src);
  
      /**
       * Index that represents the element's position in the tabbing order. See 
       * the tabindex attribute definition in HTML 4.0.
       */
      public int getTabIndex();
      public void setTabIndex(int tabIndex);
  
      /**
       * The type of control created. See the type attribute definition in HTML 
       * 4.0.
       */
      public String getType();
  
      /**
       * Use client-side image map. See the usemap attribute definition in HTML 
       * 4.0.
       */
      public String getUseMap();
      public void setUseMap(String useMap);
  
      /**
       * When the <code>type</code> attribute of the element has the value 
       * "Text", "File" or "Password", this represents the current contents of 
       * the corresponding form control, in an interactive user agent. 
       * Changing this attribute changes the contents of the form control, but 
       * does not change the value of the HTML value attribute of the element. 
       * When the <code>type</code> attribute of the element has the value 
       * "Button", "Hidden", "Submit", "Reset", "Image", "Checkbox" or 
       * "Radio", this represents the HTML value attribute of the element. See 
       * the value attribute definition in HTML 4.0.
       */
      public String getValue();
      public void setValue(String value);
  
      /**
       * Removes keyboard focus from this element.
       */
      public void blur();
  
      /**
       * Gives keyboard focus to this element.
       */
      public void focus();
  
      /**
       * Select the contents of the text area. For <code>INPUT</code> elements 
       * whose <code>type</code> attribute has one of the following values: 
       * "Text", "File", or "Password".
       */
      public void select();
  
      /**
       * Simulate a mouse-click. For <code>INPUT</code> elements whose 
       * <code>type</code> attribute has one of the following values: 
       * "Button", "Checkbox", "Radio", "Reset", or "Submit".
       */
      public void click();
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLIsIndexElement.java
  
  Index: HTMLIsIndexElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * This element is used for single-line text input. See the ISINDEX element 
   * definition in HTML 4.0. This element is deprecated in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLIsIndexElement extends HTMLElement {
      /**
       * Returns the <code>FORM</code> element containing this control. Returns 
       * <code>null</code> if this control is not within the context of a 
       * form. 
       */
      public HTMLFormElement getForm();
  
      /**
       * The prompt message. See the prompt attribute definition in HTML 4.0. 
       * This attribute is deprecated in HTML 4.0.
       */
      public String getPrompt();
      public void setPrompt(String prompt);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLLIElement.java
  
  Index: HTMLLIElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * List item. See the LI element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLLIElement extends HTMLElement {
      /**
       * List item bullet style. See the type attribute definition in HTML 4.0. 
       * This attribute is deprecated in HTML 4.0.
       */
      public String getType();
      public void setType(String type);
  
      /**
       * Reset sequence number when used in <code>OL</code>. See the value 
       * attribute definition in HTML 4.0. This attribute is deprecated in 
       * HTML 4.0.
       */
      public int getValue();
      public void setValue(int value);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLLabelElement.java
  
  Index: HTMLLabelElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Form field label text. See the LABEL element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLLabelElement extends HTMLElement {
      /**
       * Returns the <code>FORM</code> element containing this control. Returns 
       * <code>null</code> if this control is not within the context of a 
       * form. 
       */
      public HTMLFormElement getForm();
  
      /**
       * A single character access key to give access to the form control. See 
       * the accesskey attribute definition in HTML 4.0.
       */
      public String getAccessKey();
      public void setAccessKey(String accessKey);
  
      /**
       * This attribute links this label with another form control by 
       * <code>id</code> attribute. See the for attribute definition in HTML 
       * 4.0.
       */
      public String getHtmlFor();
      public void setHtmlFor(String htmlFor);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLLegendElement.java
  
  Index: HTMLLegendElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Provides a caption for a <code>FIELDSET</code> grouping. See the LEGEND 
   * element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLLegendElement extends HTMLElement {
      /**
       * Returns the <code>FORM</code> element containing this control. Returns 
       * <code>null</code> if this control is not within the context of a 
       * form. 
       */
      public HTMLFormElement getForm();
  
      /**
       * A single character access key to give access to the form control. See 
       * the accesskey attribute definition in HTML 4.0.
       */
      public String getAccessKey();
      public void setAccessKey(String accessKey);
  
      /**
       * Text alignment relative to <code>FIELDSET</code>. See the align 
       * attribute definition in HTML 4.0. This attribute is deprecated in 
       * HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLLinkElement.java
  
  Index: HTMLLinkElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * The <code>LINK</code> element specifies a link to an external resource, and 
   * defines this document's relationship to that resource (or vice versa). 
   * See the LINK element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLLinkElement extends HTMLElement {
      /**
       * Enables/disables the link. This is currently only used for style sheet 
       * links, and may be used to activate or deactivate style sheets. 
       */
      public boolean getDisabled();
      public void setDisabled(boolean disabled);
  
      /**
       * The character encoding of the resource being linked to. See the charset 
       * attribute definition in HTML 4.0.
       */
      public String getCharset();
      public void setCharset(String charset);
  
      /**
       * The URI of the linked resource. See the href attribute definition in 
       * HTML 4.0.
       */
      public String getHref();
      public void setHref(String href);
  
      /**
       * Language code of the linked resource. See the hreflang attribute 
       * definition in HTML 4.0.
       */
      public String getHreflang();
      public void setHreflang(String hreflang);
  
      /**
       * Designed for use with one or more target media. See the media attribute 
       * definition in HTML 4.0.
       */
      public String getMedia();
      public void setMedia(String media);
  
      /**
       * Forward link type. See the rel attribute definition in HTML 4.0.
       */
      public String getRel();
      public void setRel(String rel);
  
      /**
       * Reverse link type. See the rev attribute definition in HTML 4.0.
       */
      public String getRev();
      public void setRev(String rev);
  
      /**
       * Frame to render the resource in. See the target attribute definition in 
       * HTML 4.0.
       */
      public String getTarget();
      public void setTarget(String target);
  
      /**
       * Advisory content type. See the type attribute definition in HTML 4.0.
       */
      public String getType();
      public void setType(String type);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLMapElement.java
  
  Index: HTMLMapElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Client-side image map. See the MAP element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLMapElement extends HTMLElement {
      /**
       * The list of areas defined for the image map. 
       */
      public HTMLCollection getAreas();
  
      /**
       * Names the map (for use with <code>usemap</code>). See the name 
       * attribute definition in HTML 4.0.
       */
      public String getName();
      public void setName(String name);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLMenuElement.java
  
  Index: HTMLMenuElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Menu list. See the MENU element definition in HTML 4.0. This element is 
   * deprecated in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLMenuElement extends HTMLElement {
      /**
       * Reduce spacing between list items. See the compact attribute definition 
       * in HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public boolean getCompact();
      public void setCompact(boolean compact);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLMetaElement.java
  
  Index: HTMLMetaElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * This contains generic meta-information about the document. See the META 
   * element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLMetaElement extends HTMLElement {
      /**
       * Associated information. See the content attribute definition in HTML 
       * 4.0.
       */
      public String getContent();
      public void setContent(String content);
  
      /**
       * HTTP response header name. See the http-equiv attribute definition in 
       * HTML 4.0.
       */
      public String getHttpEquiv();
      public void setHttpEquiv(String httpEquiv);
  
      /**
       * Meta information name. See the name attribute definition in HTML 4.0.
       */
      public String getName();
      public void setName(String name);
  
      /**
       * Select form of content. See the scheme attribute definition in HTML 4.0.
       */
      public String getScheme();
      public void setScheme(String scheme);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLModElement.java
  
  Index: HTMLModElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Notice of modification to part of a document. See the INS and DEL element 
   * definitions in HTML 4.0. 
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLModElement extends HTMLElement {
      /**
       * A URI designating a document that describes the reason for the change. 
       * See the cite attribute definition in HTML 4.0.
       */
      public String getCite();
      public void setCite(String cite);
  
      /**
       * The date and time of the change. See the datetime attribute definition 
       * in HTML 4.0.
       */
      public String getDateTime();
      public void setDateTime(String dateTime);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLOListElement.java
  
  Index: HTMLOListElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Ordered list. See the OL element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLOListElement extends HTMLElement {
      /**
       * Reduce spacing between list items. See the compact attribute definition 
       * in HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public boolean getCompact();
      public void setCompact(boolean compact);
  
      /**
       * Starting sequence number. See the start attribute definition in HTML 
       * 4.0. This attribute is deprecated in HTML 4.0.
       */
      public int getStart();
      public void setStart(int start);
  
      /**
       * Numbering style. See the type attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getType();
      public void setType(String type);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLObjectElement.java
  
  Index: HTMLObjectElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Generic embedded object. Note. In principle, all properties on the object 
   * element are read-write but in some environments some properties may be 
   * read-only once the underlying object is instantiated. See the OBJECT 
   * element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLObjectElement extends HTMLElement {
      /**
       * Returns the <code>FORM</code> element containing this control. Returns 
       * <code>null</code> if this control is not within the context of a 
       * form. 
       */
      public HTMLFormElement getForm();
  
      /**
       * Applet class file. See the <code>code</code> attribute for 
       * HTMLAppletElement. 
       */
      public String getCode();
      public void setCode(String code);
  
      /**
       * Aligns this object (vertically or horizontally) with respect to its 
       * surrounding text. See the align attribute definition in HTML 4.0. 
       * This attribute is deprecated in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
      /**
       * Space-separated list of archives. See the archive attribute definition 
       * in HTML 4.0.
       */
      public String getArchive();
      public void setArchive(String archive);
  
      /**
       * Width of border around the object. See the border attribute definition 
       * in HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getBorder();
      public void setBorder(String border);
  
      /**
       * Base URI for <code>classid</code>, <code>data</code>, and 
       * <code>archive</code> attributes. See the codebase attribute definition
       *  in HTML 4.0.
       */
      public String getCodeBase();
      public void setCodeBase(String codeBase);
  
      /**
       * Content type for data downloaded via <code>classid</code> attribute. 
       * See the codetype attribute definition in HTML 4.0.
       */
      public String getCodeType();
      public void setCodeType(String codeType);
  
      /**
       * A URI specifying the location of the object's data. See the data 
       * attribute definition in HTML 4.0.
       */
      public String getData();
      public void setData(String data);
  
      /**
       * Declare (for future reference), but do not instantiate, this object. 
       * See the declare attribute definition in HTML 4.0.
       */
      public boolean getDeclare();
      public void setDeclare(boolean declare);
  
      /**
       * Override height. See the height attribute definition in HTML 4.0.
       */
      public String getHeight();
      public void setHeight(String height);
  
      /**
       * Horizontal space to the left and right of this image, applet, or 
       * object. See the hspace attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getHspace();
      public void setHspace(String hspace);
  
      /**
       * Form control or object name when submitted with a form. See the name 
       * attribute definition in HTML 4.0.
       */
      public String getName();
      public void setName(String name);
  
      /**
       * Message to render while loading the object. See the standby attribute 
       * definition in HTML 4.0.
       */
      public String getStandby();
      public void setStandby(String standby);
  
      /**
       * Index that represents the element's position in the tabbing order. See 
       * the tabindex attribute definition in HTML 4.0.
       */
      public int getTabIndex();
      public void setTabIndex(int tabIndex);
  
      /**
       * Content type for data downloaded via <code>data</code> attribute. See 
       * the type attribute definition in HTML 4.0.
       */
      public String getType();
      public void setType(String type);
  
      /**
       * Use client-side image map. See the usemap attribute definition in HTML 
       * 4.0.
       */
      public String getUseMap();
      public void setUseMap(String useMap);
  
      /**
       * Vertical space above and below this image, applet, or object. See the 
       * vspace attribute definition in HTML 4.0. This attribute is deprecated 
       * in HTML 4.0.
       */
      public String getVspace();
      public void setVspace(String vspace);
  
      /**
       * Override width. See the width attribute definition in HTML 4.0.
       */
      public String getWidth();
      public void setWidth(String width);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLOptGroupElement.java
  
  Index: HTMLOptGroupElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Group options together in logical subdivisions. See the OPTGROUP element 
   * definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLOptGroupElement extends HTMLElement {
      /**
       * The control is unavailable in this context. See the disabled attribute 
       * definition in HTML 4.0.
       */
      public boolean getDisabled();
      public void setDisabled(boolean disabled);
  
      /**
       * Assigns a label to this option group. See the label attribute definition
       *  in HTML 4.0.
       */
      public String getLabel();
      public void setLabel(String label);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLOptionElement.java
  
  Index: HTMLOptionElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * A selectable choice. See the OPTION element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLOptionElement extends HTMLElement {
      /**
       * Returns the <code>FORM</code> element containing this control. Returns 
       * <code>null</code> if this control is not within the context of a 
       * form. 
       */
      public HTMLFormElement getForm();
  
      /**
       * Represents the value of the HTML selected attribute. The value of this 
       * attribute does not change if the state of the corresponding form 
       * control, in an interactive user agent, changes. Changing 
       * <code>defaultSelected</code>, however, resets the state of the form 
       * control. See the selected attribute definition in HTML 4.0.
       */
      public boolean getDefaultSelected();
      public void setDefaultSelected(boolean defaultSelected);
  
      /**
       * The text contained within the option element. 
       */
      public String getText();
  
      /**
       * The index of this <code>OPTION</code> in its parent <code>SELECT</code>
       * , starting from 0.
       */
      public int getIndex();
  
      /**
       * The control is unavailable in this context. See the disabled attribute 
       * definition in HTML 4.0.
       */
      public boolean getDisabled();
      public void setDisabled(boolean disabled);
  
      /**
       * Option label for use in hierarchical menus. See the label attribute 
       * definition in HTML 4.0.
       */
      public String getLabel();
      public void setLabel(String label);
  
      /**
       * Represents the current state of the corresponding form control, in an 
       * interactive user agent. Changing this attribute changes the state of 
       * the form control, but does not change the value of the HTML selected 
       * attribute of the element.
       */
      public boolean getSelected();
      public void setSelected(boolean selected);
  
      /**
       * The current form control value. See the value attribute definition in 
       * HTML 4.0.
       */
      public String getValue();
      public void setValue(String value);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLParagraphElement.java
  
  Index: HTMLParagraphElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Paragraphs. See the P element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLParagraphElement extends HTMLElement {
      /**
       * Horizontal text alignment. See the align attribute definition in HTML 
       * 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLParamElement.java
  
  Index: HTMLParamElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Parameters fed to the <code>OBJECT</code> element. See the PARAM element 
   * definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLParamElement extends HTMLElement {
      /**
       * The name of a run-time parameter. See the name attribute definition in 
       * HTML 4.0.
       */
      public String getName();
      public void setName(String name);
  
      /**
       * Content type for the <code>value</code> attribute when 
       * <code>valuetype</code> has the value "ref". See the type attribute 
       * definition in HTML 4.0.
       */
      public String getType();
      public void setType(String type);
  
      /**
       * The value of a run-time parameter. See the value attribute definition 
       * in HTML 4.0.
       */
      public String getValue();
      public void setValue(String value);
  
      /**
       * Information about the meaning of the <code>value</code> attribute 
       * value. See the valuetype attribute definition in HTML 4.0.
       */
      public String getValueType();
      public void setValueType(String valueType);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLPreElement.java
  
  Index: HTMLPreElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Preformatted text. See the PRE element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLPreElement extends HTMLElement {
      /**
       * Fixed width for content. See the width attribute definition in HTML 
       * 4.0. This attribute is deprecated in HTML 4.0.
       */
      public int getWidth();
      public void setWidth(int width);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLQuoteElement.java
  
  Index: HTMLQuoteElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * For the <code>Q</code> and <code>BLOCKQUOTE</code> elements. See the Q 
   * element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLQuoteElement extends HTMLElement {
      /**
       * A URI designating a source document or message. See the cite attribute 
       * definition in HTML 4.0.
       */
      public String getCite();
      public void setCite(String cite);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLScriptElement.java
  
  Index: HTMLScriptElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Script statements. See the SCRIPT element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLScriptElement extends HTMLElement {
      /**
       * The script content of the element. 
       */
      public String getText();
      public void setText(String text);
  
      /**
       * Reserved for future use. 
       */
      public String getHtmlFor();
      public void setHtmlFor(String htmlFor);
  
      /**
       * Reserved for future use. 
       */
      public String getEvent();
      public void setEvent(String event);
  
      /**
       * The character encoding of the linked resource. See the charset 
       * attribute definition in HTML 4.0.
       */
      public String getCharset();
      public void setCharset(String charset);
  
      /**
       * Indicates that the user agent can defer processing of the script. See 
       * the defer attribute definition in HTML 4.0.
       */
      public boolean getDefer();
      public void setDefer(boolean defer);
  
      /**
       * URI designating an external script. See the src attribute definition in 
       * HTML 4.0.
       */
      public String getSrc();
      public void setSrc(String src);
  
      /**
       * The content type of the script language. See the type attribute 
       * definition in HTML 4.0.
       */
      public String getType();
      public void setType(String type);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLSelectElement.java
  
  Index: HTMLSelectElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  import org.w3c.dom.DOMException;
  
  /**
   * The select element allows the selection of an option. The contained options 
   * can be directly accessed through the select element as a collection. See 
   * the SELECT element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLSelectElement extends HTMLElement {
      /**
       * The type of this form control. This is the string "select-multiple" 
       * when the multiple attribute is <code>true</code> and the string 
       * "select-one" when <code>false</code>.
       */
      public String getType();
  
      /**
       * The ordinal index of the selected option, starting from 0. The value -1 
       * is returned if no element is selected. If multiple options are 
       * selected, the index of the first selected option is returned. 
       */
      public int getSelectedIndex();
      public void setSelectedIndex(int selectedIndex);
  
      /**
       * The current form control value. 
       */
      public String getValue();
      public void setValue(String value);
  
      /**
       * The number of options in this <code>SELECT</code>. 
       */
      public int getLength();
  
      /**
       * Returns the <code>FORM</code> element containing this control. Returns 
       * <code>null</code> if this control is not within the context of a 
       * form. 
       */
      public HTMLFormElement getForm();
  
      /**
       * The collection of <code>OPTION</code> elements contained by this 
       * element. 
       */
      public HTMLCollection getOptions();
  
      /**
       * The control is unavailable in this context. See the disabled attribute 
       * definition in HTML 4.0.
       */
      public boolean getDisabled();
      public void setDisabled(boolean disabled);
  
      /**
       * If true, multiple <code>OPTION</code> elements may be selected in this 
       * <code>SELECT</code>. See the multiple attribute definition in HTML 
       * 4.0.
       */
      public boolean getMultiple();
      public void setMultiple(boolean multiple);
  
      /**
       * Form control or object name when submitted with a form. See the name 
       * attribute definition in HTML 4.0.
       */
      public String getName();
      public void setName(String name);
  
      /**
       * Number of visible rows. See the size attribute definition in HTML 4.0.
       */
      public int getSize();
      public void setSize(int size);
  
      /**
       * Index that represents the element's position in the tabbing order. See 
       * the tabindex attribute definition in HTML 4.0.
       */
      public int getTabIndex();
      public void setTabIndex(int tabIndex);
  
      /**
       * Add a new element to the collection of <code>OPTION</code> elements for 
       * this <code>SELECT</code>.
       * @param element The element to add.
       * @param before The element to insert before, or <code>null</code> for 
       *   the tail of the list.
       * @exception DOMException
       *   NOT_FOUND_ERR: Raised if <code>before</code> is not a descendant of 
       *   the <code>SELECT</code> element. 
       */
      public void add(HTMLElement element, 
                      HTMLElement before)
                      throws DOMException;
  
      /**
       * Remove an element from the collection of <code>OPTION</code> elements 
       * for this <code>SELECT</code>. Does nothing if no element has the 
       * given index.
       * @param index The index of the item to remove, starting from 0.
       */
      public void remove(int index);
  
      /**
       * Removes keyboard focus from this element.
       */
      public void blur();
  
      /**
       * Gives keyboard focus to this element.
       */
      public void focus();
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLStyleElement.java
  
  Index: HTMLStyleElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Style information. A more detailed style sheet object model is planned to 
   * be defined in a separate document. See the STYLE element definition in 
   * HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLStyleElement extends HTMLElement {
      /**
       * Enables/disables the style sheet. 
       */
      public boolean getDisabled();
      public void setDisabled(boolean disabled);
  
      /**
       * Designed for use with one or more target media. See the media attribute 
       * definition in HTML 4.0.
       */
      public String getMedia();
      public void setMedia(String media);
  
      /**
       *  The content type of the style sheet language. See the type attribute 
       * definition in HTML 4.0.
       */
      public String getType();
      public void setType(String type);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLTableCaptionElement.java
  
  Index: HTMLTableCaptionElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Table caption See the CAPTION element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLTableCaptionElement extends HTMLElement {
      /**
       * Caption alignment with respect to the table. See the align attribute 
       * definition in HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLTableCellElement.java
  
  Index: HTMLTableCellElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * The object used to represent the <code>TH</code> and <code>TD</code> 
   * elements. See the TD element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLTableCellElement extends HTMLElement {
      /**
       * The index of this cell in the row, starting from 0. This index is in 
       * document tree order and not display order.
       */
      public int getCellIndex();
  
      /**
       * Abbreviation for header cells. See the abbr attribute definition in 
       * HTML 4.0.
       */
      public String getAbbr();
      public void setAbbr(String abbr);
  
      /**
       * Horizontal alignment of data in cell. See the align attribute definition
       *  in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
      /**
       * Names group of related headers. See the axis attribute definition in 
       * HTML 4.0.
       */
      public String getAxis();
      public void setAxis(String axis);
  
      /**
       * Cell background color. See the bgcolor attribute definition in HTML 
       * 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getBgColor();
      public void setBgColor(String bgColor);
  
      /**
       * Alignment character for cells in a column. See the char attribute 
       * definition in HTML 4.0.
       */
      public String getCh();
      public void setCh(String ch);
  
      /**
       * Offset of alignment character. See the charoff attribute definition in 
       * HTML 4.0.
       */
      public String getChOff();
      public void setChOff(String chOff);
  
      /**
       * Number of columns spanned by cell. See the colspan attribute definition 
       * in HTML 4.0.
       */
      public int getColSpan();
      public void setColSpan(int colSpan);
  
      /**
       * List of <code>id</code> attribute values for header cells. See the 
       * headers attribute definition in HTML 4.0.
       */
      public String getHeaders();
      public void setHeaders(String headers);
  
      /**
       * Cell height. See the height attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getHeight();
      public void setHeight(String height);
  
      /**
       * Suppress word wrapping. See the nowrap attribute definition in HTML 
       * 4.0. This attribute is deprecated in HTML 4.0.
       */
      public boolean getNoWrap();
      public void setNoWrap(boolean noWrap);
  
      /**
       * Number of rows spanned by cell. See the rowspan attribute definition in 
       * HTML 4.0.
       */
      public int getRowSpan();
      public void setRowSpan(int rowSpan);
  
      /**
       * Scope covered by header cells. See the scope attribute definition in 
       * HTML 4.0.
       */
      public String getScope();
      public void setScope(String scope);
  
      /**
       * Vertical alignment of data in cell. See the valign attribute definition 
       * in HTML 4.0.
       */
      public String getVAlign();
      public void setVAlign(String vAlign);
  
      /**
       * Cell width. See the width attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getWidth();
      public void setWidth(String width);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLTableColElement.java
  
  Index: HTMLTableColElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Regroups the <code>COL</code> and <code>COLGROUP</code> elements. See the 
   * COL element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLTableColElement extends HTMLElement {
      /**
       * Horizontal alignment of cell data in column. See the align attribute 
       * definition in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
      /**
       * Alignment character for cells in a column. See the char attribute 
       * definition in HTML 4.0.
       */
      public String getCh();
      public void setCh(String ch);
  
      /**
       * Offset of alignment character. See the charoff attribute definition in 
       * HTML 4.0.
       */
      public String getChOff();
      public void setChOff(String chOff);
  
      /**
       * Indicates the number of columns in a group or affected by a grouping. 
       * See the span attribute definition in HTML 4.0.
       */
      public int getSpan();
      public void setSpan(int span);
  
      /**
       * Vertical alignment of cell data in column. See the valign attribute 
       * definition in HTML 4.0.
       */
      public String getVAlign();
      public void setVAlign(String vAlign);
  
      /**
       * Default column width. See the width attribute definition in HTML 4.0.
       */
      public String getWidth();
      public void setWidth(String width);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLTableElement.java
  
  Index: HTMLTableElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  import org.w3c.dom.DOMException;
  
  /**
   * The create* and delete* methods on the table allow authors to construct and 
   * modify tables. HTML 4.0 specifies that only one of each of the 
   * <code>CAPTION</code>, <code>THEAD</code>, and <code>TFOOT</code> elements 
   * may exist in a table. Therefore, if one exists, and the createTHead() or 
   * createTFoot() method is called, the method returns the existing THead or 
   * TFoot element. See the TABLE element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLTableElement extends HTMLElement {
      /**
       * Returns the table's <code>CAPTION</code>, or void if none exists. 
       */
      public HTMLTableCaptionElement getCaption();
      public void setCaption(HTMLTableCaptionElement caption);
  
      /**
       * Returns the table's <code>THEAD</code>, or <code>null</code> if none 
       * exists. 
       */
      public HTMLTableSectionElement getTHead();
      public void setTHead(HTMLTableSectionElement tHead);
  
      /**
       * Returns the table's <code>TFOOT</code>, or <code>null</code> if none 
       * exists. 
       */
      public HTMLTableSectionElement getTFoot();
      public void setTFoot(HTMLTableSectionElement tFoot);
  
      /**
       * Returns a collection of all the rows in the table, including all in 
       * <code>THEAD</code>, <code>TFOOT</code>, all <code>TBODY</code> 
       * elements. 
       */
      public HTMLCollection getRows();
  
      /**
       * Returns a collection of the defined table bodies. 
       */
      public HTMLCollection getTBodies();
  
      /**
       * Specifies the table's position with respect to the rest of the 
       * document. See the align attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
      /**
       * Cell background color. See the bgcolor attribute definition in HTML 
       * 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getBgColor();
      public void setBgColor(String bgColor);
  
      /**
       * The width of the border around the table. See the border attribute 
       * definition in HTML 4.0.
       */
      public String getBorder();
      public void setBorder(String border);
  
      /**
       * Specifies the horizontal and vertical space between cell content and 
       * cell borders. See the cellpadding attribute definition in HTML 4.0.
       */
      public String getCellPadding();
      public void setCellPadding(String cellPadding);
  
      /**
       * Specifies the horizontal and vertical separation between cells. See the 
       * cellspacing attribute definition in HTML 4.0.
       */
      public String getCellSpacing();
      public void setCellSpacing(String cellSpacing);
  
      /**
       * Specifies which external table borders to render. See the frame 
       * attribute definition in HTML 4.0.
       */
      public String getFrame();
      public void setFrame(String frame);
  
      /**
       * Specifies which internal table borders to render. See the rules 
       * attribute definition in HTML 4.0.
       */
      public String getRules();
      public void setRules(String rules);
  
      /**
       * Description about the purpose or structure of a table. See the summary 
       * attribute definition in HTML 4.0.
       */
      public String getSummary();
      public void setSummary(String summary);
  
      /**
       * Specifies the desired table width. See the width attribute definition 
       * in HTML 4.0.
       */
      public String getWidth();
      public void setWidth(String width);
  
      /**
       * Create a table header row or return an existing one.
       * @return A new table header element (<code>THEAD</code>).
       */
      public HTMLElement createTHead();
  
      /**
       * Delete the header from the table, if one exists.
       */
      public void deleteTHead();
  
      /**
       * Create a table footer row or return an existing one.
       * @return A footer element (<code>TFOOT</code>).
       */
      public HTMLElement createTFoot();
  
      /**
       * Delete the footer from the table, if one exists.
       */
      public void deleteTFoot();
  
      /**
       * Create a new table caption object or return an existing one.
       * @return A <code>CAPTION</code> element.
       */
      public HTMLElement createCaption();
  
      /**
       * Delete the table caption, if one exists.
       */
      public void deleteCaption();
  
      /**
       * Insert a new empty row in the table. The new row is inserted 
       * immediately before and in the same section as the current 
       * <code>index</code>th row in the table. If <code>index</code> is equal 
       * to the number of rows, the new row is appended. In addition, when the 
       * table is empty the row is inserted into a <code>TBODY</code> which is 
       * created and inserted into the table. Note. A table row cannot be 
       * empty according to HTML 4.0 Recommendation.
       * @param index The row number where to insert a new row. This index 
       *   starts from 0 and is relative to all the rows contained inside the 
       *   table, regardless of section parentage.
       * @return The newly created row.
       * @exception DOMException
       *   INDEX_SIZE_ERR: Raised if the specified index is greater than the 
       *   number of rows or if the index is negative.
       */
      public HTMLElement insertRow(int index)
                                   throws DOMException;
  
      /**
       * Delete a table row.
       * @param index The index of the row to be deleted. This index starts from 
       *   0 and is relative to all the rows contained inside the table, 
       *   regardless of section parentage.
       * @exception DOMException
       *   INDEX_SIZE_ERR: Raised if the specified index is greater than or 
       *   equal to the number of rows or if the index is negative.
       */
      public void deleteRow(int index)
                            throws DOMException;
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLTableRowElement.java
  
  Index: HTMLTableRowElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  import org.w3c.dom.DOMException;
  
  /**
   * A row in a table. See the TR element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLTableRowElement extends HTMLElement {
      /**
       * The index of this row, relative to the entire table, starting from 0. 
       * This is in document tree order and not display order. The 
       * <code>rowIndex</code> does not take into account sections (
       * <code>THEAD</code>, <code>TFOOT</code>, or <code>TBODY</code>) within 
       * the table.
       */
      public int getRowIndex();
  
      /**
       * The index of this row, relative to the current section (
       * <code>THEAD</code>, <code>TFOOT</code>, or <code>TBODY</code>), 
       * starting from 0.
       */
      public int getSectionRowIndex();
  
      /**
       * The collection of cells in this row. 
       */
      public HTMLCollection getCells();
  
      /**
       * Horizontal alignment of data within cells of this row. See the align 
       * attribute definition in HTML 4.0.
       */
      public String getAlign();
      public void setAlign(String align);
  
      /**
       * Background color for rows. See the bgcolor attribute definition in HTML 
       * 4.0. This attribute is deprecated in HTML 4.0.
       */
      public String getBgColor();
      public void setBgColor(String bgColor);
  
      /**
       * Alignment character for cells in a column. See the char attribute 
       * definition in HTML 4.0.
       */
      public String getCh();
      public void setCh(String ch);
  
      /**
       * Offset of alignment character. See the charoff attribute definition in 
       * HTML 4.0.
       */
      public String getChOff();
      public void setChOff(String chOff);
  
      /**
       * Vertical alignment of data within cells of this row. See the valign 
       * attribute definition in HTML 4.0.
       */
      public String getVAlign();
      public void setVAlign(String vAlign);
  
      /**
       * Insert an empty <code>TD</code> cell into this row. If 
       * <code>index</code> is equal to the number of cells, the new cell is 
       * appended.
       * @param index The place to insert the cell, starting from 0.
       * @return The newly created cell.
       * @exception DOMException
       *   INDEX_SIZE_ERR: Raised if the specified <code>index</code> is greater 
       *   than the number of cells or if the index is negative.
       */
      public HTMLElement insertCell(int index)
                                    throws DOMException;
  
      /**
       * Delete a cell from the current row.
       * @param index The index of the cell to delete, starting from 0.
       * @exception DOMException
       *   INDEX_SIZE_ERR: Raised if the specified <code>index</code> is greater 
       *   than or equal to the number of cells or if the index is negative.
       */
      public void deleteCell(int index)
                             throws DOMException;
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLTableSectionElement.java
  
  Index: HTMLTableSectionElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  import org.w3c.dom.DOMException;
  
  /**
   * The <code>THEAD</code>, <code>TFOOT</code>, and <code>TBODY</code> 
   * elements. 
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLTableSectionElement extends HTMLElement {
      /**
       * Horizontal alignment of data in cells. See the <code>align</code> 
       * attribute for HTMLTheadElement for details. 
       */
      public String getAlign();
      public void setAlign(String align);
  
      /**
       * Alignment character for cells in a column. See the char attribute 
       * definition in HTML 4.0.
       */
      public String getCh();
      public void setCh(String ch);
  
      /**
       * Offset of alignment character. See the charoff attribute definition in 
       * HTML 4.0.
       */
      public String getChOff();
      public void setChOff(String chOff);
  
      /**
       * Vertical alignment of data in cells. See the <code>valign</code> 
       * attribute for HTMLTheadElement for details. 
       */
      public String getVAlign();
      public void setVAlign(String vAlign);
  
      /**
       * The collection of rows in this table section. 
       */
      public HTMLCollection getRows();
  
      /**
       * Insert a row into this section. The new row is inserted immediately 
       * before the current <code>index</code>th row in this section. If 
       * <code>index</code> is equal to the number of rows in this section, 
       * the new row is appended.
       * @param index The row number where to insert a new row. This index 
       *   starts from 0 and is relative only to the rows contained inside 
       *   this section, not all the rows in the table.
       * @return The newly created row.
       * @exception DOMException
       *   INDEX_SIZE_ERR: Raised if the specified index is greater than the 
       *   number of rows or if the index is negative.
       */
      public HTMLElement insertRow(int index)
                                   throws DOMException;
  
      /**
       * Delete a row from this section.
       * @param index The index of the row to be deleted. This index starts from 
       *   0 and is relative only to the rows contained inside this section, 
       *   not all the rows in the table.
       * @exception DOMException
       *   INDEX_SIZE_ERR: Raised if the specified index is greater than or 
       *   equal to the number of rows or if the index is negative.
       */
      public void deleteRow(int index)
                            throws DOMException;
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLTextAreaElement.java
  
  Index: HTMLTextAreaElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Multi-line text field. See the TEXTAREA element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLTextAreaElement extends HTMLElement {
      /**
       * Represents the contents of the element. The value of this attribute 
       * does not change if the contents of the corresponding form control, in 
       * an interactive user agent, changes. Changing this attribute, however, 
       * resets the contents of the form control.
       */
      public String getDefaultValue();
      public void setDefaultValue(String defaultValue);
  
      /**
       * Returns the <code>FORM</code> element containing this control. Returns 
       * <code>null</code> if this control is not within the context of a 
       * form. 
       */
      public HTMLFormElement getForm();
  
      /**
       * A single character access key to give access to the form control. See 
       * the accesskey attribute definition in HTML 4.0.
       */
      public String getAccessKey();
      public void setAccessKey(String accessKey);
  
      /**
       * Width of control (in characters). See the cols attribute definition in 
       * HTML 4.0.
       */
      public int getCols();
      public void setCols(int cols);
  
      /**
       * The control is unavailable in this context. See the disabled attribute 
       * definition in HTML 4.0.
       */
      public boolean getDisabled();
      public void setDisabled(boolean disabled);
  
      /**
       * Form control or object name when submitted with a form. See the name 
       * attribute definition in HTML 4.0.
       */
      public String getName();
      public void setName(String name);
  
      /**
       * This control is read-only. See the readonly attribute definition in 
       * HTML 4.0.
       */
      public boolean getReadOnly();
      public void setReadOnly(boolean readOnly);
  
      /**
       * Number of text rows. See the rows attribute definition in HTML 4.0.
       */
      public int getRows();
      public void setRows(int rows);
  
      /**
       * Index that represents the element's position in the tabbing order. See 
       * the tabindex attribute definition in HTML 4.0.
       */
      public int getTabIndex();
      public void setTabIndex(int tabIndex);
  
      /**
       * The type of this form control. This the string "textarea".
       */
      public String getType();
  
      /**
       * Represents the current contents of the corresponding form control, in 
       * an interactive user agent. Changing this attribute changes the 
       * contents of the form control, but does not change the contents of the 
       * element. If the entirety of the data can not fit into a single 
       * <code>DOMString</code>, the implementation may truncate the data.
       */
      public String getValue();
      public void setValue(String value);
  
      /**
       * Removes keyboard focus from this element.
       */
      public void blur();
  
      /**
       * Gives keyboard focus to this element.
       */
      public void focus();
  
      /**
       * Select the contents of the <code>TEXTAREA</code>.
       */
      public void select();
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLTitleElement.java
  
  Index: HTMLTitleElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * The document title. See the TITLE element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLTitleElement extends HTMLElement {
      /**
       * The specified title as a string. 
       */
      public String getText();
      public void setText(String text);
  
  }
  
  
  
  1.1                  xml-commons/java/external/src/org/w3c/dom/html/HTMLUListElement.java
  
  Index: HTMLUListElement.java
  ===================================================================
  /*
   * Copyright (c) 2000 World Wide Web Consortium,
   * (Massachusetts Institute of Technology, Institut National de
   * Recherche en Informatique et en Automatique, Keio University). All
   * Rights Reserved. This program is distributed under the W3C's Software
   * Intellectual Property License. This program is distributed in the
   * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   * PURPOSE.
   * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
   */
  
  package org.w3c.dom.html;
  
  /**
   * Unordered list. See the UL element definition in HTML 4.0.
   * <p>See also the <a href='http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929'>Document Object Model (DOM) Level 1 Specification (Second Edition)</a>.
   */
  public interface HTMLUListElement extends HTMLElement {
      /**
       * Reduce spacing between list items. See the compact attribute definition 
       * in HTML 4.0. This attribute is deprecated in HTML 4.0.
       */
      public boolean getCompact();
      public void setCompact(boolean compact);
  
      /**
       * Bullet style. See the type attribute definition in HTML 4.0. This 
       * attribute is deprecated in HTML 4.0.
       */
      public String getType();
      public void setType(String type);
  
  }
  
  
  
  1.2       +15 -15    xml-commons/java/external/src/org/w3c/dom/ranges/Range.java
  
  Index: Range.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/ranges/Range.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- Range.java	1 Jun 2001 11:13:22 -0000	1.1
  +++ Range.java	4 Jan 2002 20:20:52 -0000	1.2
  @@ -78,9 +78,9 @@
   
       /**
        * Sets the attributes describing the start of the Range. 
  -     * @param refNodeThe <code>refNode</code> value. This parameter must be 
  +     * @param refNode The <code>refNode</code> value. This parameter must be 
        *   different from <code>null</code>.
  -     * @param offsetThe <code>startOffset</code> value. 
  +     * @param offset The <code>startOffset</code> value. 
        * @exception RangeException
        *   INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor 
        *   of <code>refNode</code> is an Entity, Notation, or DocumentType 
  @@ -100,9 +100,9 @@
   
       /**
        * Sets the attributes describing the end of a Range.
  -     * @param refNodeThe <code>refNode</code> value. This parameter must be 
  +     * @param refNode The <code>refNode</code> value. This parameter must be 
        *   different from <code>null</code>.
  -     * @param offsetThe <code>endOffset</code> value. 
  +     * @param offset The <code>endOffset</code> value. 
        * @exception RangeException
        *   INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor 
        *   of <code>refNode</code> is an Entity, Notation, or DocumentType 
  @@ -122,7 +122,7 @@
   
       /**
        * Sets the start position to be before a node
  -     * @param refNodeRange starts before <code>refNode</code> 
  +     * @param refNode Range starts before <code>refNode</code> 
        * @exception RangeException
        *   INVALID_NODE_TYPE_ERR: Raised if the root container of 
        *   <code>refNode</code> is not an Attr, Document, or DocumentFragment 
  @@ -137,7 +137,7 @@
   
       /**
        * Sets the start position to be after a node
  -     * @param refNodeRange starts after <code>refNode</code> 
  +     * @param refNode Range starts after <code>refNode</code> 
        * @exception RangeException
        *   INVALID_NODE_TYPE_ERR: Raised if the root container of 
        *   <code>refNode</code> is not an Attr, Document, or DocumentFragment 
  @@ -152,7 +152,7 @@
   
       /**
        * Sets the end position to be before a node. 
  -     * @param refNodeRange ends before <code>refNode</code> 
  +     * @param refNode Range ends before <code>refNode</code> 
        * @exception RangeException
        *   INVALID_NODE_TYPE_ERR: Raised if the root container of 
        *   <code>refNode</code> is not an Attr, Document, or DocumentFragment 
  @@ -167,7 +167,7 @@
   
       /**
        * Sets the end of a Range to be after a node 
  -     * @param refNodeRange ends after <code>refNode</code>. 
  +     * @param refNode Range ends after <code>refNode</code>. 
        * @exception RangeException
        *   INVALID_NODE_TYPE_ERR: Raised if the root container of 
        *   <code>refNode</code> is not an Attr, Document or DocumentFragment 
  @@ -182,7 +182,7 @@
   
       /**
        * Collapse a Range onto one of its boundary-points 
  -     * @param toStartIf TRUE, collapses the Range onto its start; if FALSE, 
  +     * @param toStart If TRUE, collapses the Range onto its start; if FALSE, 
        *   collapses it onto its end. 
        * @exception DOMException
        *   INVALID_STATE_ERR: Raised if <code>detach()</code> has already been 
  @@ -193,7 +193,7 @@
   
       /**
        * Select a node and its contents 
  -     * @param refNodeThe node to select. 
  +     * @param refNode The node to select. 
        * @exception RangeException
        *   INVALID_NODE_TYPE_ERR: Raised if an ancestor of <code>refNode</code> 
        *   is an Entity, Notation or DocumentType node or if 
  @@ -208,7 +208,7 @@
   
       /**
        * Select the contents within a node 
  -     * @param refNodeNode to select from 
  +     * @param refNode Node to select from 
        * @exception RangeException
        *   INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor 
        *   of <code>refNode</code> is an Entity, Notation or DocumentType node.
  @@ -247,8 +247,8 @@
   
       /**
        * Compare the boundary-points of two Ranges in a document.
  -     * @param howA code representing the type of comparison, as defined above.
  -     * @param sourceRangeThe <code>Range</code> on which this current 
  +     * @param how A code representing the type of comparison, as defined above.
  +     * @param sourceRange The <code>Range</code> on which this current 
        *   <code>Range</code> is compared to.
        * @return  -1, 0 or 1 depending on whether the corresponding 
        *   boundary-point of the Range is respectively before, equal to, or 
  @@ -315,7 +315,7 @@
        * automatically merged. If the node to be inserted is a 
        * DocumentFragment node, the children will be inserted rather than the 
        * DocumentFragment node itself.
  -     * @param newNodeThe node to insert at the start of the Range 
  +     * @param newNode The node to insert at the start of the Range 
        * @exception DOMException
        *   NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of the 
        *   start of the Range is read-only.
  @@ -338,7 +338,7 @@
       /**
        * Reparents the contents of the Range to the given node and inserts the 
        * node at the position of the start of the Range. 
  -     * @param newParentThe node to surround the contents with. 
  +     * @param newParent The node to surround the contents with. 
        * @exception DOMException
        *   NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of 
        *   either boundary-point of the Range is read-only.
  
  
  
  1.2       +2 -2      xml-commons/java/external/src/org/w3c/dom/stylesheets/MediaList.java
  
  Index: MediaList.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/stylesheets/MediaList.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- MediaList.java	1 Jun 2001 11:13:24 -0000	1.1
  +++ MediaList.java	4 Jan 2002 20:20:52 -0000	1.2
  @@ -57,7 +57,7 @@
   
       /**
        *  Deletes the medium indicated by <code>oldMedium</code> from the list. 
  -     * @param oldMediumThe medium to delete in the media list.
  +     * @param oldMedium The medium to delete in the media list.
        * @exception DOMException
        *    NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly. 
        *   <br> NOT_FOUND_ERR: Raised if <code>oldMedium</code> is not in the 
  @@ -69,7 +69,7 @@
       /**
        *  Adds the medium <code>newMedium</code> to the end of the list. If the 
        * <code>newMedium</code> is already used, it is first removed. 
  -     * @param newMediumThe new medium to add.
  +     * @param newMedium The new medium to add.
        * @exception DOMException
        *    INVALID_CHARACTER_ERR: If the medium contains characters that are 
        *   invalid in the underlying style language. 
  
  
  
  1.2       +1 -1      xml-commons/java/external/src/org/w3c/dom/stylesheets/StyleSheetList.java
  
  Index: StyleSheetList.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/stylesheets/StyleSheetList.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- StyleSheetList.java	1 Jun 2001 11:13:24 -0000	1.1
  +++ StyleSheetList.java	4 Jan 2002 20:20:52 -0000	1.2
  @@ -32,7 +32,7 @@
        *  Used to retrieve a style sheet by ordinal index. If index is greater 
        * than or equal to the number of style sheets in the list, this returns 
        * <code>null</code>. 
  -     * @param indexIndex into the collection
  +     * @param index Index into the collection
        * @return The style sheet at the <code>index</code> position in the 
        *   <code>StyleSheetList</code>, or <code>null</code> if that is not a 
        *   valid index. 
  
  
  
  1.2       +8 -8      xml-commons/java/external/src/org/w3c/dom/traversal/DocumentTraversal.java
  
  Index: DocumentTraversal.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/traversal/DocumentTraversal.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- DocumentTraversal.java	1 Jun 2001 11:13:26 -0000	1.1
  +++ DocumentTraversal.java	4 Jan 2002 20:20:52 -0000	1.2
  @@ -29,19 +29,19 @@
       /**
        * Create a new <code>NodeIterator</code> over the subtree rooted at the 
        * specified node.
  -     * @param rootThe node which will be iterated together with its children. 
  +     * @param root The node which will be iterated together with its children. 
        *   The iterator is initially positioned just before this node. The 
        *   <code>whatToShow</code> flags and the filter, if any, are not 
        *   considered when setting this position. The root must not be 
        *   <code>null</code>.
  -     * @param whatToShowThis flag specifies which node types may appear in 
  +     * @param whatToShow This flag specifies which node types may appear in 
        *   the logical view of the tree presented by the iterator. See the 
        *   description of <code>NodeFilter</code> for the set of possible 
        *   <code>SHOW_</code> values.These flags can be combined using 
        *   <code>OR</code>.
  -     * @param filterThe <code>NodeFilter</code> to be used with this 
  +     * @param filter The <code>NodeFilter</code> to be used with this 
        *   <code>TreeWalker</code>, or <code>null</code> to indicate no filter.
  -     * @param entityReferenceExpansionThe value of this flag determines 
  +     * @param entityReferenceExpansion The value of this flag determines 
        *   whether entity reference nodes are expanded.
        * @return The newly created <code>NodeIterator</code>.
        * @exception DOMException
  @@ -57,7 +57,7 @@
       /**
        * Create a new <code>TreeWalker</code> over the subtree rooted at the 
        * specified node.
  -     * @param rootThe node which will serve as the <code>root</code> for the 
  +     * @param root The node which will serve as the <code>root</code> for the 
        *   <code>TreeWalker</code>. The <code>whatToShow</code> flags and the 
        *   <code>NodeFilter</code> are not considered when setting this value; 
        *   any node type will be accepted as the <code>root</code>. The 
  @@ -67,13 +67,13 @@
        *   methods that look upward in the document structure, such as 
        *   <code>parentNode</code> and nextNode. The <code>root</code> must 
        *   not be <code>null</code>.
  -     * @param whatToShowThis flag specifies which node types may appear in 
  +     * @param whatToShow This flag specifies which node types may appear in 
        *   the logical view of the tree presented by the tree-walker. See the 
        *   description of <code>NodeFilter</code> for the set of possible 
        *   SHOW_ values.These flags can be combined using <code>OR</code>.
  -     * @param filterThe <code>NodeFilter</code> to be used with this 
  +     * @param filter The <code>NodeFilter</code> to be used with this 
        *   <code>TreeWalker</code>, or <code>null</code> to indicate no filter.
  -     * @param entityReferenceExpansionIf this flag is false, the contents of 
  +     * @param entityReferenceExpansion If this flag is false, the contents of 
        *   <code>EntityReference</code> nodes are not presented in the logical 
        *   view.
        * @return The newly created <code>TreeWalker</code>.
  
  
  
  1.2       +1 -1      xml-commons/java/external/src/org/w3c/dom/traversal/NodeFilter.java
  
  Index: NodeFilter.java
  ===================================================================
  RCS file: /home/cvs/xml-commons/java/external/src/org/w3c/dom/traversal/NodeFilter.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- NodeFilter.java	1 Jun 2001 11:13:26 -0000	1.1
  +++ NodeFilter.java	4 Jan 2002 20:20:52 -0000	1.2
  @@ -133,7 +133,7 @@
        * <code>NodeIterator</code>; it is not normally called directly from 
        * user code. (Though you could do so if you wanted to use the same 
        * filter to guide your own application logic.)
  -     * @param nThe node to check to see if it passes the filter or not.
  +     * @param n The node to check to see if it passes the filter or not.
        * @return a constant to determine whether the node is accepted, 
        *   rejected, or skipped, as defined above.
        */