From 3ad12ecf267f56a600e03c960a164f89c8a16210 Mon Sep 17 00:00:00 2001 From: jkesselm Date: Fri, 10 May 2002 20:32:51 +0000 Subject: [PATCH] Still trying to get the Javadoc synched up. No functional changes. DOM Level 2 Errata: http://www.w3.org/2001/06/DOM-Level-2-Core-java-binding-20010621.zip http://www.w3.org/2001/06/DOM-Level-2-Traversal-Range-java-binding-20010621.zip http://www.w3.org/2001/06/DOM-Level-2-Views-java-binding-20010621.zip http://www.w3.org/2001/06/DOM-Level-2-Events-java-binding-20010621.zip http://www.w3.org/2001/06/DOM-Level-2-Style-java-binding-20010621.zip DOM HTML Level 1 Second Edition, extracted from http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/java-binding.zip git-svn-id: https://svn.apache.org/repos/asf/xml/commons/trunk@225969 13f79535-47bb-0310-9956-ffa450edef68 --- java/external/src/org/w3c/dom/Attr.java | 31 +- .../src/org/w3c/dom/CDATASection.java | 4 +- .../src/org/w3c/dom/CharacterData.java | 15 + .../src/org/w3c/dom/DOMException.java | 4 +- .../src/org/w3c/dom/DOMImplementation.java | 34 +- java/external/src/org/w3c/dom/Document.java | 121 ++- .../src/org/w3c/dom/DocumentType.java | 9 +- java/external/src/org/w3c/dom/Element.java | 48 +- java/external/src/org/w3c/dom/Entity.java | 2 +- .../src/org/w3c/dom/NamedNodeMap.java | 28 +- java/external/src/org/w3c/dom/Node.java | 176 +++- java/external/src/org/w3c/dom/NodeList.java | 2 +- .../org/w3c/dom/ProcessingInstruction.java | 7 + .../src/org/w3c/dom/css/CSS2Properties.java | 854 ++++++++++++++++++ .../src/org/w3c/dom/css/CSSCharsetRule.java | 8 + .../src/org/w3c/dom/css/CSSMediaRule.java | 14 +- .../src/org/w3c/dom/css/CSSPageRule.java | 7 + .../org/w3c/dom/css/CSSPrimitiveValue.java | 10 +- .../external/src/org/w3c/dom/css/CSSRule.java | 12 + .../org/w3c/dom/css/CSSStyleDeclaration.java | 38 +- .../src/org/w3c/dom/css/CSSStyleRule.java | 9 + .../src/org/w3c/dom/css/CSSStyleSheet.java | 6 +- .../src/org/w3c/dom/css/CSSValue.java | 10 + .../org/w3c/dom/css/DOMImplementationCSS.java | 6 +- .../src/org/w3c/dom/css/DocumentCSS.java | 6 +- .../external/src/org/w3c/dom/css/ViewCSS.java | 6 +- .../src/org/w3c/dom/events/EventListener.java | 2 +- .../src/org/w3c/dom/events/MouseEvent.java | 12 +- .../src/org/w3c/dom/ranges/Range.java | 21 +- .../org/w3c/dom/stylesheets/MediaList.java | 11 +- .../org/w3c/dom/stylesheets/StyleSheet.java | 8 + .../w3c/dom/traversal/DocumentTraversal.java | 38 +- .../src/org/w3c/dom/traversal/NodeFilter.java | 34 +- .../org/w3c/dom/traversal/NodeIterator.java | 53 +- .../src/org/w3c/dom/traversal/TreeWalker.java | 19 +- 35 files changed, 1459 insertions(+), 206 deletions(-) diff --git a/java/external/src/org/w3c/dom/Attr.java b/java/external/src/org/w3c/dom/Attr.java index 05b0c12..4ba62e2 100644 --- a/java/external/src/org/w3c/dom/Attr.java +++ b/java/external/src/org/w3c/dom/Attr.java @@ -13,7 +13,7 @@ package org.w3c.dom; /** - * The Attr interface represents an attribute in an + * The Attr interface represents an attribute in an * Element object. Typically the allowable values for the * attribute are defined in a document type definition. *

Attr objects inherit the Node interface, but @@ -33,7 +33,7 @@ package org.w3c.dom; * DOM need to be aware that Attr nodes have some things in * common with other objects inheriting the Node interface, but * they also are quite distinct. - *

The attribute's effective value is determined as follows: if this + *

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 @@ package org.w3c.dom; * attribute does not exist on this element in the structure model until it * has been explicitly added. Note that the nodeValue attribute * on the Attr instance can also be used to retrieve the string - * version of the attribute's value(s). + * version of the attribute's value(s). *

In XML, where the value of an attribute can contain entity references, * the child nodes of the Attr node may be either * Text or EntityReference nodes (when these are * in use; see the description of EntityReference 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. *

See also the Document Object Model (DOM) Level 2 Core Specification. */ public interface Attr extends Node { /** - * Returns the name of this attribute. + * Returns the name of this attribute. */ public String getName(); @@ -69,14 +69,14 @@ public interface Attr extends Node { * implementation will then make a new attribute available with * specified set to false and the default * value (if one exists). - *
In summary: If the attribute has an assigned value in the document + *
In summary: If the attribute has an assigned value in the document * then specified is true, 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 * specified is false, 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 ownerElement attribute is null (i.e. * because it was just created or was set to null by the * various removal and cloning operations) specified is @@ -98,6 +98,19 @@ public interface Attr extends Node { * 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 getAttribute on the + * Element interface. + *
On setting, this creates a Text 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 setAttribute on the Element + * interface. + * @exception DOMException + * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. + */ public void setValue(String value) throws DOMException; diff --git a/java/external/src/org/w3c/dom/CDATASection.java b/java/external/src/org/w3c/dom/CDATASection.java index 9e74734..f3aea8a 100644 --- a/java/external/src/org/w3c/dom/CDATASection.java +++ b/java/external/src/org/w3c/dom/CDATASection.java @@ -24,8 +24,8 @@ package org.w3c.dom; * 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. - *

The CDATASection interface inherits from the + * of a CDATA section. + *

The CDATASection interface inherits from the * CharacterData interface through the Text * interface. Adjacent CDATASection nodes are not merged by use * of the normalize method of the Node interface. diff --git a/java/external/src/org/w3c/dom/CharacterData.java b/java/external/src/org/w3c/dom/CharacterData.java index d4a36cc..c067120 100644 --- a/java/external/src/org/w3c/dom/CharacterData.java +++ b/java/external/src/org/w3c/dom/CharacterData.java @@ -44,6 +44,21 @@ public interface CharacterData extends Node { */ 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 CharacterData node. However, + * implementation limits may mean that the entirety of a node's data may + * not fit into a single DOMString. In such cases, the user + * may call substringData 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 DOMString variable on the implementation + * platform. + */ public void setData(String data) throws DOMException; diff --git a/java/external/src/org/w3c/dom/DOMException.java b/java/external/src/org/w3c/dom/DOMException.java index 098c6c5..16866ce 100644 --- a/java/external/src/org/w3c/dom/DOMException.java +++ b/java/external/src/org/w3c/dom/DOMException.java @@ -18,10 +18,10 @@ package org.w3c.dom; * 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 - * NodeList. + * NodeList. *

Implementations should raise other exceptions under other circumstances. * For example, implementations should raise an implementation-dependent - * exception if a null argument is passed. + * exception if a null argument is passed. *

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, diff --git a/java/external/src/org/w3c/dom/DOMImplementation.java b/java/external/src/org/w3c/dom/DOMImplementation.java index 5defc8e..6e9a554 100644 --- a/java/external/src/org/w3c/dom/DOMImplementation.java +++ b/java/external/src/org/w3c/dom/DOMImplementation.java @@ -26,11 +26,7 @@ public interface DOMImplementation { * 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 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". + * unique. * @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 @@ -47,9 +43,8 @@ public interface DOMImplementation { * default attribute additions do not occur. It is expected that a * future version of the DOM will provide a way for populating a * DocumentType. - *
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 DocumentType node with @@ -59,6 +54,12 @@ public interface DOMImplementation { * contains an illegal character. *
NAMESPACE_ERR: Raised if the qualifiedName is * malformed. + *
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 DocumentType createDocumentType(String qualifiedName, @@ -67,10 +68,10 @@ public interface DOMImplementation { throws DOMException; /** - * Creates an XML Document 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. + * Creates a DOM Document object of the specified type with its document + * element. + * @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 null. @@ -86,10 +87,19 @@ public interface DOMImplementation { * namespaceURI is null, or if the * qualifiedName has a prefix that is "xml" and the * namespaceURI is different from " - * http://www.w3.org/XML/1998/namespace" . + * http://www.w3.org/XML/1998/namespace" , or if the DOM + * implementation does not support the "XML" feature but + * a non-null namespace URI was provided, since namespaces were + * defined by XML. *
WRONG_DOCUMENT_ERR: Raised if doctype has already * been used with a different document or was created from a different * implementation. + *
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, diff --git a/java/external/src/org/w3c/dom/Document.java b/java/external/src/org/w3c/dom/Document.java index 320dbb7..79214e0 100644 --- a/java/external/src/org/w3c/dom/Document.java +++ b/java/external/src/org/w3c/dom/Document.java @@ -62,7 +62,7 @@ public interface Document extends Node { * @param tagName The name of the element type to instantiate. For XML, * this is case-sensitive. For HTML, the tagName * 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 Element object with the * nodeName attribute set to tagName, and * localName, prefix, and @@ -75,7 +75,7 @@ public interface Document extends Node { throws DOMException; /** - * Creates an empty DocumentFragment object. + * Creates an empty DocumentFragment object. * @return A new DocumentFragment. */ public DocumentFragment createDocumentFragment(); @@ -148,7 +148,7 @@ public interface Document extends Node { * node is also unbound; (its namespaceURI is * null). 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 EntityReference object. * @exception DOMException * INVALID_CHARACTER_ERR: Raised if the specified name contains an @@ -161,7 +161,7 @@ public interface Document extends Node { /** * Returns a NodeList of all the Elements with a * given tag name in the order in which they are encountered in a - * preorder traversal of the Document tree. + * preorder traversal of the Document tree. * @param tagname The name of the tag to match on. The special value "*" * matches all tags. * @return A new NodeList object containing all the matched @@ -255,7 +255,7 @@ public interface Document extends Node { * types of nodes inheriting from CharacterData copy their * data and length attributes from those of * the source node. - * + * * @param importedNode The node to import. * @param deep If true, recursively import the subtree under * the specified node; if false, import only the node @@ -272,28 +272,57 @@ public interface Document extends Node { throws DOMException; /** - * Creates an element of the given qualified name and namespace URI. - * HTML-only DOM implementations do not need to implement this method. + * Creates an element of the given qualified name and namespace URI. * @param namespaceURI The namespace URI of the element to create. * @param qualifiedName The qualified name of the element type to * instantiate. * @return A new Element object with the following - * attributes:AttributeValueNode.nodeName - * qualifiedNameNode.namespaceURI - * namespaceURINode.prefixprefix, extracted + * attributes: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
AttributeValue
Node.nodeName + * qualifiedName
Node.namespaceURI + * namespaceURI
Node.prefixprefix, extracted * from qualifiedName, or null if there is - * no prefixNode.localNamelocal name, extracted from - * qualifiedNameElement.tagName - * qualifiedName + * no prefix
Node.localNamelocal name, extracted from + * qualifiedName
Element.tagName + * qualifiedName
* @exception DOMException * INVALID_CHARACTER_ERR: Raised if the specified qualified name - * contains an illegal character. + * contains an illegal character, per the XML 1.0 specification . *
NAMESPACE_ERR: Raised if the qualifiedName is - * malformed, if the qualifiedName has a prefix and the + * malformed per the Namespaces in XML specification, if the + * qualifiedName has a prefix and the * namespaceURI is null, or if the * qualifiedName has a prefix that is "xml" and the * namespaceURI is different from " * http://www.w3.org/XML/1998/namespace" . + *
NOT_SUPPORTED_ERR: Always thrown if the current document does not + * support the "XML" feature, since namespaces were + * defined by XML. * @since DOM Level 2 */ public Element createElementNS(String namespaceURI, @@ -301,31 +330,65 @@ public interface Document extends Node { throws DOMException; /** - * Creates an attribute of the given qualified name and namespace URI. - * HTML-only DOM implementations do not need to implement this method. + * Creates an attribute of the given qualified name and namespace URI. * @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 Attr object with the following attributes: - * AttributeValueNode.nodeNamequalifiedName - * Node.namespaceURInamespaceURI - * Node.prefixprefix, extracted from + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
+ * AttributeValue
Node.nodeNamequalifiedName
+ * Node.namespaceURInamespaceURI
+ * Node.prefixprefix, extracted from * qualifiedName, or null if there is no - * prefixNode.localNamelocal name, extracted from - * qualifiedNameAttr.name - * qualifiedNameNode.nodeValuethe empty - * string + * prefix
Node.localNamelocal name, extracted from + * qualifiedName
Attr.name + * qualifiedName
Node.nodeValuethe empty + * string
* @exception DOMException * INVALID_CHARACTER_ERR: Raised if the specified qualified name - * contains an illegal character. + * contains an illegal character, per the XML 1.0 specification . *
NAMESPACE_ERR: Raised if the qualifiedName is - * malformed, if the qualifiedName has a prefix and the + * malformed per the Namespaces in XML specification, if the + * qualifiedName has a prefix and the * namespaceURI is null, if the * qualifiedName has a prefix that is "xml" and the * namespaceURI is different from " * http://www.w3.org/XML/1998/namespace", or if the - * qualifiedName is "xmlns" and the + * qualifiedName, or its prefix, is "xmlns" and the * namespaceURI is different from " * http://www.w3.org/2000/xmlns/". + *
NOT_SUPPORTED_ERR: Always thrown if the current document does not + * support the "XML" feature, since namespaces were + * defined by XML. * @since DOM Level 2 */ public Attr createAttributeNS(String namespaceURI, @@ -355,7 +418,7 @@ public interface Document extends Node { * 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 null. + * not are expected to return null. * @param elementId The unique id value for an element. * @return The matching element. * @since DOM Level 2 diff --git a/java/external/src/org/w3c/dom/DocumentType.java b/java/external/src/org/w3c/dom/DocumentType.java index b5537cb..86c312b 100644 --- a/java/external/src/org/w3c/dom/DocumentType.java +++ b/java/external/src/org/w3c/dom/DocumentType.java @@ -68,10 +68,11 @@ public interface DocumentType extends Node { public String getSystemId(); /** - * 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. + * The internal subset as a string, or null 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. * @since DOM Level 2 */ public String getInternalSubset(); diff --git a/java/external/src/org/w3c/dom/Element.java b/java/external/src/org/w3c/dom/Element.java index b2a7123..614ca87 100644 --- a/java/external/src/org/w3c/dom/Element.java +++ b/java/external/src/org/w3c/dom/Element.java @@ -39,7 +39,7 @@ public interface Element extends Node { * case-preserving in XML, as are all of the operations of the DOM. The * HTML DOM returns the tagName of an HTML element in the * canonical uppercase form, regardless of the case in the source HTML - * document. + * document. */ public String getTagName(); @@ -151,8 +151,11 @@ public interface Element extends Node { public NodeList getElementsByTagName(String name); /** - * Retrieves an attribute value by local name and namespace URI. HTML-only - * DOM implementations do not need to implement this method. + * Retrieves an attribute value by local name and namespace URI. + *
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. * @param namespaceURI The namespace URI of the attribute to retrieve. * @param localName The local name of the attribute to retrieve. * @return The Attr value as a string, or the empty string @@ -177,7 +180,6 @@ public interface Element extends Node { * and use setAttributeNodeNS or * setAttributeNode to assign it as the value of an * attribute. - *
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 @@ -185,17 +187,21 @@ public interface Element extends Node { * @param value The value to set in string form. * @exception DOMException * INVALID_CHARACTER_ERR: Raised if the specified qualified name - * contains an illegal character. + * contains an illegal character, per the XML 1.0 specification . *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. *
NAMESPACE_ERR: Raised if the qualifiedName is - * malformed, if the qualifiedName has a prefix and the + * malformed per the Namespaces in XML specification, if the + * qualifiedName has a prefix and the * namespaceURI is null, if the * qualifiedName has a prefix that is "xml" and the * namespaceURI is different from " * http://www.w3.org/XML/1998/namespace", or if the - * qualifiedName is "xmlns" and the + * qualifiedName, or its prefix, is "xmlns" and the * namespaceURI is different from " * http://www.w3.org/2000/xmlns/". + *
NOT_SUPPORTED_ERR: Always thrown if the current document does not + * support the "XML" feature, since namespaces were + * defined by XML. * @since DOM Level 2 */ public void setAttributeNS(String namespaceURI, @@ -208,7 +214,10 @@ public interface Element extends Node { * 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. - *
HTML-only DOM implementations do not need to implement this method. + *
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. * @param namespaceURI The namespace URI of the attribute to remove. * @param localName The local name of the attribute to remove. * @exception DOMException @@ -220,8 +229,11 @@ public interface Element extends Node { throws DOMException; /** - * Retrieves an Attr node by local name and namespace URI. - * HTML-only DOM implementations do not need to implement this method. + * Retrieves an Attr node by local name and namespace URI. + *
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. * @param namespaceURI The namespace URI of the attribute to retrieve. * @param localName The local name of the attribute to retrieve. * @return The Attr node with the specified attribute local @@ -236,7 +248,6 @@ public interface Element extends Node { * 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. - *
HTML-only DOM implementations do not need to implement this method. * @param newAttr The Attr node to add to the attribute list. * @return If the newAttr attribute replaces an existing * attribute with the same local name and namespace URI, the replaced @@ -250,6 +261,9 @@ public interface Element extends Node { * attribute of another Element object. The DOM user must * explicitly clone Attr nodes to re-use them in other * elements. + *
NOT_SUPPORTED_ERR: Always thrown if the current document does not + * support the "XML" feature, since namespaces were + * defined by XML. * @since DOM Level 2 */ public Attr setAttributeNodeNS(Attr newAttr) @@ -260,7 +274,10 @@ public interface Element extends Node { * Elements with a given local name and namespace URI in * the order in which they are encountered in a preorder traversal of * this Element tree. - *
HTML-only DOM implementations do not need to implement this method. + *
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. * @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 @@ -287,8 +304,11 @@ public interface Element extends Node { /** * Returns true when an attribute with a given local name and * namespace URI is specified on this element or has a default value, - * false otherwise. HTML-only DOM implementations do not - * need to implement this method. + * false otherwise. + *
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. * @param namespaceURI The namespace URI of the attribute to look for. * @param localName The local name of the attribute to look for. * @return true if an attribute with the given local name diff --git a/java/external/src/org/w3c/dom/Entity.java b/java/external/src/org/w3c/dom/Entity.java index ecbf6a9..11bd0df 100644 --- a/java/external/src/org/w3c/dom/Entity.java +++ b/java/external/src/org/w3c/dom/Entity.java @@ -61,7 +61,7 @@ public interface Entity extends Node { /** * For unparsed entities, the name of the notation for the entity. For - * parsed entities, this is null. + * parsed entities, this is null. */ public String getNotationName(); diff --git a/java/external/src/org/w3c/dom/NamedNodeMap.java b/java/external/src/org/w3c/dom/NamedNodeMap.java index 2c199c3..8437366 100644 --- a/java/external/src/org/w3c/dom/NamedNodeMap.java +++ b/java/external/src/org/w3c/dom/NamedNodeMap.java @@ -56,6 +56,11 @@ public interface NamedNodeMap { * Attr that is already an attribute of another * Element object. The DOM user must explicitly clone * Attr nodes to re-use them in other elements. + *
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; @@ -89,13 +94,16 @@ public interface NamedNodeMap { /** * The number of nodes in this map. The range of valid child node indices - * is 0 to length-1 inclusive. + * is 0 to length-1 inclusive. */ public int getLength(); /** - * Retrieves a node specified by local name and namespace URI. HTML-only - * DOM implementations do not need to implement this method. + * Retrieves a node specified by local name and namespace URI. + *
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. * @param namespaceURI The namespace URI of the node to retrieve. * @param localName The local name of the node to retrieve. * @return A Node (of any type) with the specified local @@ -111,7 +119,6 @@ public interface NamedNodeMap { * localName. If a node with that namespace URI and that * local name is already present in this map, it is replaced by the new * one. - *
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 namespaceURI and * localName attributes. @@ -126,6 +133,14 @@ public interface NamedNodeMap { * Attr that is already an attribute of another * Element object. The DOM user must explicitly clone * Attr nodes to re-use them in other elements. + *
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. + *
NOT_SUPPORTED_ERR: Always thrown if the current document does not + * support the "XML" feature, since namespaces were + * defined by XML. * @since DOM Level 2 */ public Node setNamedItemNS(Node arg) @@ -138,7 +153,10 @@ public interface NamedNodeMap { * attribute of the Node interface. If so, an attribute * immediately appears containing the default value as well as the * corresponding namespace URI, local name, and prefix when applicable. - *
HTML-only DOM implementations do not need to implement this method. + *
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. * @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 diff --git a/java/external/src/org/w3c/dom/Node.java b/java/external/src/org/w3c/dom/Node.java index 58e4318..56ed30a 100644 --- a/java/external/src/org/w3c/dom/Node.java +++ b/java/external/src/org/w3c/dom/Node.java @@ -29,6 +29,97 @@ package org.w3c.dom; * ), this returns null. Note that the specialized interfaces * may contain additional and more convenient mechanisms to get and set the * relevant information. + *

The values of nodeName, + * nodeValue, and attributes vary according to the + * node type as follows: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
InterfacenodeNamenodeValueattributes
Attrname of + * attributevalue of attributenull
CDATASection"#cdata-section" + * content of the CDATA Sectionnull
Comment"#comment"content of + * the commentnull
Document"#document"nullnull
DocumentFragment + * "#document-fragment"nullnull
DocumentTypedocument type name + * nullnull
Elementtag namenullNamedNodeMap
Entityentity namenullnull
+ * EntityReferencename of entity referencednullnull
Notationnotation namenull + * null
ProcessingInstructiontargetentire content excluding the targetnull
Text + * "#text"content of the text nodenull
*

See also the Document Object Model (DOM) Level 2 Core Specification. */ public interface Node { @@ -83,7 +174,7 @@ public interface Node { 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(); @@ -99,6 +190,16 @@ public interface Node { */ public String getNodeValue() throws DOMException; + /** + * The value of this node, depending on its type; see the table above. + * When it is defined to be null, 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 DOMString variable on the implementation + * platform. + */ public void setNodeValue(String nodeValue) throws DOMException; @@ -150,7 +251,7 @@ public interface Node { /** * A NamedNodeMap containing the attributes of this node (if - * it is an Element) or null otherwise. + * it is an Element) or null otherwise. */ public NamedNodeMap getAttributes(); @@ -173,13 +274,14 @@ public interface Node { * refChild. If the newChild 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 newChild node, or if - * the node to insert is one of this node's ancestors. + * the node to insert is one of this node's ancestors or this node + * itself. *
WRONG_DOCUMENT_ERR: Raised if newChild was created * from a different document than the one that created this node. *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or @@ -205,7 +307,8 @@ public interface Node { * @exception DOMException * HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not * allow children of the type of the newChild node, or if - * the node to put in is one of this node's ancestors. + * the node to put in is one of this node's ancestors or this node + * itself. *
WRONG_DOCUMENT_ERR: Raised if newChild was created * from a different document than the one that created this node. *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node or the parent of @@ -234,24 +337,26 @@ public interface Node { * Adds the node newChild to the end of the list of children * of this node. If the newChild is already in the tree, it * is first removed. - * @param newChild The node to add.If it is a DocumentFragment - * 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 + * DocumentFragment 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 newChild node, or if - * the node to append is one of this node's ancestors. + * the node to append is one of this node's ancestors or this node + * itself. *
WRONG_DOCUMENT_ERR: Raised if newChild was created * from a different document than the one that created this node. - *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or + * if the previous parent of the node being inserted is readonly. */ public Node appendChild(Node newChild) throws DOMException; /** * Returns whether this node has any children. - * @return true if this node has any children, + * @return true if this node has any children, * false otherwise. */ public boolean hasChildNodes(); @@ -277,7 +382,7 @@ public interface Node { * Notation nodes is implementation dependent. * @param deep If true, recursively clone the subtree under * the specified node; if false, clone only the node - * itself (and its attributes, if it is an Element). + * itself (and its attributes, if it is an Element). * @return The duplicate node. */ public Node cloneNode(boolean deep); @@ -352,20 +457,51 @@ public interface Node { * Document interface, this is always null. * @exception DOMException * INVALID_CHARACTER_ERR: Raised if the specified prefix contains an - * illegal character. + * illegal character, per the XML 1.0 specification . *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. *
NAMESPACE_ERR: Raised if the specified prefix is - * malformed, if the namespaceURI of this node is - * null, if the specified prefix is "xml" and the - * namespaceURI 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 - * namespaceURI of this node is different from " + * malformed per the Namespaces in XML specification, if the + * namespaceURI of this node is null, if the + * specified prefix is "xml" and the namespaceURI 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 namespaceURI of this node is different from " * http://www.w3.org/2000/xmlns/", or if this node is an attribute and * the qualifiedName of this node is "xmlns" . * @since DOM Level 2 */ public String getPrefix(); + /** + * The namespace prefix of this node, or null if it is + * unspecified. + *
Note that setting this attribute, when permitted, changes the + * nodeName attribute, which holds the qualified name, as + * well as the tagName and name attributes of + * the Element and Attr interfaces, when + * applicable. + *
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 + * namespaceURI and localName do not change. + *
For nodes of any type other than ELEMENT_NODE and + * ATTRIBUTE_NODE and nodes created with a DOM Level 1 + * method, such as createElement from the + * Document interface, this is always null. + * @exception DOMException + * INVALID_CHARACTER_ERR: Raised if the specified prefix contains an + * illegal character, per the XML 1.0 specification . + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. + *
NAMESPACE_ERR: Raised if the specified prefix is + * malformed per the Namespaces in XML specification, if the + * namespaceURI of this node is null, if the + * specified prefix is "xml" and the namespaceURI 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 namespaceURI of this node is different from " + * http://www.w3.org/2000/xmlns/", or if this node is an attribute and + * the qualifiedName of this node is "xmlns" . + * @since DOM Level 2 + */ public void setPrefix(String prefix) throws DOMException; diff --git a/java/external/src/org/w3c/dom/NodeList.java b/java/external/src/org/w3c/dom/NodeList.java index 2a6e238..a90b4fd 100644 --- a/java/external/src/org/w3c/dom/NodeList.java +++ b/java/external/src/org/w3c/dom/NodeList.java @@ -34,7 +34,7 @@ public interface NodeList { /** * The number of nodes in the list. The range of valid child node indices - * is 0 to length-1 inclusive. + * is 0 to length-1 inclusive. */ public int getLength(); diff --git a/java/external/src/org/w3c/dom/ProcessingInstruction.java b/java/external/src/org/w3c/dom/ProcessingInstruction.java index f84fdf2..fe447b5 100644 --- a/java/external/src/org/w3c/dom/ProcessingInstruction.java +++ b/java/external/src/org/w3c/dom/ProcessingInstruction.java @@ -34,6 +34,13 @@ public interface ProcessingInstruction extends Node { * 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 ?>. + * @exception DOMException + * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. + */ public void setData(String data) throws DOMException; diff --git a/java/external/src/org/w3c/dom/css/CSS2Properties.java b/java/external/src/org/w3c/dom/css/CSS2Properties.java index b84df9b..18f589f 100644 --- a/java/external/src/org/w3c/dom/css/CSS2Properties.java +++ b/java/external/src/org/w3c/dom/css/CSS2Properties.java @@ -74,6 +74,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getAzimuth(); + /** + * See the azimuth property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setAzimuth(String azimuth) throws DOMException; @@ -85,6 +92,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBackground(); + /** + * See the background property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBackground(String background) throws DOMException; @@ -96,6 +110,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBackgroundAttachment(); + /** + * See the background-attachment property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBackgroundAttachment(String backgroundAttachment) throws DOMException; @@ -107,6 +128,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBackgroundColor(); + /** + * See the background-color property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBackgroundColor(String backgroundColor) throws DOMException; @@ -118,6 +146,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBackgroundImage(); + /** + * See the background-image property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBackgroundImage(String backgroundImage) throws DOMException; @@ -129,6 +164,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBackgroundPosition(); + /** + * See the background-position property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBackgroundPosition(String backgroundPosition) throws DOMException; @@ -140,6 +182,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBackgroundRepeat(); + /** + * See the background-repeat property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBackgroundRepeat(String backgroundRepeat) throws DOMException; @@ -151,6 +200,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorder(); + /** + * See the border property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorder(String border) throws DOMException; @@ -162,6 +218,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderCollapse(); + /** + * See the border-collapse property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderCollapse(String borderCollapse) throws DOMException; @@ -173,6 +236,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderColor(); + /** + * See the border-color property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderColor(String borderColor) throws DOMException; @@ -184,6 +254,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderSpacing(); + /** + * See the border-spacing property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderSpacing(String borderSpacing) throws DOMException; @@ -195,6 +272,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderStyle(); + /** + * See the border-style property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderStyle(String borderStyle) throws DOMException; @@ -206,6 +290,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderTop(); + /** + * See the border-top property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderTop(String borderTop) throws DOMException; @@ -217,6 +308,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderRight(); + /** + * See the border-right property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderRight(String borderRight) throws DOMException; @@ -228,6 +326,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderBottom(); + /** + * See the border-bottom property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderBottom(String borderBottom) throws DOMException; @@ -239,6 +344,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderLeft(); + /** + * See the border-left property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderLeft(String borderLeft) throws DOMException; @@ -250,6 +362,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderTopColor(); + /** + * See the border-top-color property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderTopColor(String borderTopColor) throws DOMException; @@ -261,6 +380,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderRightColor(); + /** + * See the border-right-color property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderRightColor(String borderRightColor) throws DOMException; @@ -272,6 +398,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderBottomColor(); + /** + * See the border-bottom-color property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderBottomColor(String borderBottomColor) throws DOMException; @@ -283,6 +416,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderLeftColor(); + /** + * See the border-left-color property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderLeftColor(String borderLeftColor) throws DOMException; @@ -294,6 +434,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderTopStyle(); + /** + * See the border-top-style property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderTopStyle(String borderTopStyle) throws DOMException; @@ -305,6 +452,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderRightStyle(); + /** + * See the border-right-style property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderRightStyle(String borderRightStyle) throws DOMException; @@ -316,6 +470,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderBottomStyle(); + /** + * See the border-bottom-style property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderBottomStyle(String borderBottomStyle) throws DOMException; @@ -327,6 +488,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderLeftStyle(); + /** + * See the border-left-style property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderLeftStyle(String borderLeftStyle) throws DOMException; @@ -338,6 +506,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderTopWidth(); + /** + * See the border-top-width property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderTopWidth(String borderTopWidth) throws DOMException; @@ -349,6 +524,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderRightWidth(); + /** + * See the border-right-width property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderRightWidth(String borderRightWidth) throws DOMException; @@ -360,6 +542,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderBottomWidth(); + /** + * See the border-bottom-width property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderBottomWidth(String borderBottomWidth) throws DOMException; @@ -371,6 +560,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderLeftWidth(); + /** + * See the border-left-width property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderLeftWidth(String borderLeftWidth) throws DOMException; @@ -382,6 +578,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBorderWidth(); + /** + * See the border-width property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBorderWidth(String borderWidth) throws DOMException; @@ -393,6 +596,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getBottom(); + /** + * See the bottom property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setBottom(String bottom) throws DOMException; @@ -404,6 +614,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getCaptionSide(); + /** + * See the caption-side property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setCaptionSide(String captionSide) throws DOMException; @@ -415,6 +632,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getClear(); + /** + * See the clear property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setClear(String clear) throws DOMException; @@ -426,6 +650,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getClip(); + /** + * See the clip property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setClip(String clip) throws DOMException; @@ -437,6 +668,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getColor(); + /** + * See the color property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setColor(String color) throws DOMException; @@ -448,6 +686,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getContent(); + /** + * See the content property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setContent(String content) throws DOMException; @@ -459,6 +704,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getCounterIncrement(); + /** + * See the counter-increment property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setCounterIncrement(String counterIncrement) throws DOMException; @@ -470,6 +722,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getCounterReset(); + /** + * See the counter-reset property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setCounterReset(String counterReset) throws DOMException; @@ -481,6 +740,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getCue(); + /** + * See the cue property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setCue(String cue) throws DOMException; @@ -492,6 +758,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getCueAfter(); + /** + * See the cue-after property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setCueAfter(String cueAfter) throws DOMException; @@ -503,6 +776,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getCueBefore(); + /** + * See the cue-before property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setCueBefore(String cueBefore) throws DOMException; @@ -514,6 +794,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getCursor(); + /** + * See the cursor property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setCursor(String cursor) throws DOMException; @@ -525,6 +812,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getDirection(); + /** + * See the direction property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setDirection(String direction) throws DOMException; @@ -536,6 +830,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getDisplay(); + /** + * See the display property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setDisplay(String display) throws DOMException; @@ -547,6 +848,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getElevation(); + /** + * See the elevation property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setElevation(String elevation) throws DOMException; @@ -558,6 +866,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getEmptyCells(); + /** + * See the empty-cells property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setEmptyCells(String emptyCells) throws DOMException; @@ -569,6 +884,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getCssFloat(); + /** + * See the float property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setCssFloat(String cssFloat) throws DOMException; @@ -580,6 +902,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getFont(); + /** + * See the font property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setFont(String font) throws DOMException; @@ -591,6 +920,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getFontFamily(); + /** + * See the font-family property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setFontFamily(String fontFamily) throws DOMException; @@ -602,6 +938,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getFontSize(); + /** + * See the font-size property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setFontSize(String fontSize) throws DOMException; @@ -613,6 +956,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getFontSizeAdjust(); + /** + * See the font-size-adjust property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setFontSizeAdjust(String fontSizeAdjust) throws DOMException; @@ -624,6 +974,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getFontStretch(); + /** + * See the font-stretch property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setFontStretch(String fontStretch) throws DOMException; @@ -635,6 +992,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getFontStyle(); + /** + * See the font-style property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setFontStyle(String fontStyle) throws DOMException; @@ -646,6 +1010,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getFontVariant(); + /** + * See the font-variant property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setFontVariant(String fontVariant) throws DOMException; @@ -657,6 +1028,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getFontWeight(); + /** + * See the font-weight property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setFontWeight(String fontWeight) throws DOMException; @@ -668,6 +1046,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getHeight(); + /** + * See the height property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setHeight(String height) throws DOMException; @@ -679,6 +1064,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getLeft(); + /** + * See the left property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setLeft(String left) throws DOMException; @@ -690,6 +1082,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getLetterSpacing(); + /** + * See the letter-spacing property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setLetterSpacing(String letterSpacing) throws DOMException; @@ -701,6 +1100,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getLineHeight(); + /** + * See the line-height property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setLineHeight(String lineHeight) throws DOMException; @@ -712,6 +1118,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getListStyle(); + /** + * See the list-style property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setListStyle(String listStyle) throws DOMException; @@ -723,6 +1136,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getListStyleImage(); + /** + * See the list-style-image property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setListStyleImage(String listStyleImage) throws DOMException; @@ -734,6 +1154,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getListStylePosition(); + /** + * See the list-style-position property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setListStylePosition(String listStylePosition) throws DOMException; @@ -745,6 +1172,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getListStyleType(); + /** + * See the list-style-type property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setListStyleType(String listStyleType) throws DOMException; @@ -756,6 +1190,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getMargin(); + /** + * See the margin property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setMargin(String margin) throws DOMException; @@ -767,6 +1208,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getMarginTop(); + /** + * See the margin-top property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setMarginTop(String marginTop) throws DOMException; @@ -778,6 +1226,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getMarginRight(); + /** + * See the margin-right property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setMarginRight(String marginRight) throws DOMException; @@ -789,6 +1244,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getMarginBottom(); + /** + * See the margin-bottom property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setMarginBottom(String marginBottom) throws DOMException; @@ -800,6 +1262,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getMarginLeft(); + /** + * See the margin-left property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setMarginLeft(String marginLeft) throws DOMException; @@ -811,6 +1280,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getMarkerOffset(); + /** + * See the marker-offset property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setMarkerOffset(String markerOffset) throws DOMException; @@ -822,6 +1298,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getMarks(); + /** + * See the marks property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setMarks(String marks) throws DOMException; @@ -833,6 +1316,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getMaxHeight(); + /** + * See the max-height property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setMaxHeight(String maxHeight) throws DOMException; @@ -844,6 +1334,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getMaxWidth(); + /** + * See the max-width property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setMaxWidth(String maxWidth) throws DOMException; @@ -855,6 +1352,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getMinHeight(); + /** + * See the min-height property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setMinHeight(String minHeight) throws DOMException; @@ -866,6 +1370,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getMinWidth(); + /** + * See the min-width property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setMinWidth(String minWidth) throws DOMException; @@ -877,6 +1388,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getOrphans(); + /** + * See the orphans property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setOrphans(String orphans) throws DOMException; @@ -888,6 +1406,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getOutline(); + /** + * See the outline property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setOutline(String outline) throws DOMException; @@ -899,6 +1424,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getOutlineColor(); + /** + * See the outline-color property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setOutlineColor(String outlineColor) throws DOMException; @@ -910,6 +1442,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getOutlineStyle(); + /** + * See the outline-style property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setOutlineStyle(String outlineStyle) throws DOMException; @@ -921,6 +1460,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getOutlineWidth(); + /** + * See the outline-width property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setOutlineWidth(String outlineWidth) throws DOMException; @@ -932,6 +1478,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getOverflow(); + /** + * See the overflow property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setOverflow(String overflow) throws DOMException; @@ -943,6 +1496,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPadding(); + /** + * See the padding property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPadding(String padding) throws DOMException; @@ -954,6 +1514,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPaddingTop(); + /** + * See the padding-top property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPaddingTop(String paddingTop) throws DOMException; @@ -965,6 +1532,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPaddingRight(); + /** + * See the padding-right property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPaddingRight(String paddingRight) throws DOMException; @@ -976,6 +1550,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPaddingBottom(); + /** + * See the padding-bottom property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPaddingBottom(String paddingBottom) throws DOMException; @@ -987,6 +1568,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPaddingLeft(); + /** + * See the padding-left property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPaddingLeft(String paddingLeft) throws DOMException; @@ -998,6 +1586,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPage(); + /** + * See the page property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPage(String page) throws DOMException; @@ -1009,6 +1604,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPageBreakAfter(); + /** + * See the page-break-after property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPageBreakAfter(String pageBreakAfter) throws DOMException; @@ -1020,6 +1622,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPageBreakBefore(); + /** + * See the page-break-before property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPageBreakBefore(String pageBreakBefore) throws DOMException; @@ -1031,6 +1640,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPageBreakInside(); + /** + * See the page-break-inside property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPageBreakInside(String pageBreakInside) throws DOMException; @@ -1042,6 +1658,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPause(); + /** + * See the pause property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPause(String pause) throws DOMException; @@ -1053,6 +1676,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPauseAfter(); + /** + * See the pause-after property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPauseAfter(String pauseAfter) throws DOMException; @@ -1064,6 +1694,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPauseBefore(); + /** + * See the pause-before property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPauseBefore(String pauseBefore) throws DOMException; @@ -1075,6 +1712,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPitch(); + /** + * See the pitch property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPitch(String pitch) throws DOMException; @@ -1086,6 +1730,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPitchRange(); + /** + * See the pitch-range property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPitchRange(String pitchRange) throws DOMException; @@ -1097,6 +1748,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPlayDuring(); + /** + * See the play-during property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPlayDuring(String playDuring) throws DOMException; @@ -1108,6 +1766,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getPosition(); + /** + * See the position property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setPosition(String position) throws DOMException; @@ -1119,6 +1784,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getQuotes(); + /** + * See the quotes property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setQuotes(String quotes) throws DOMException; @@ -1130,6 +1802,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getRichness(); + /** + * See the richness property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setRichness(String richness) throws DOMException; @@ -1141,6 +1820,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getRight(); + /** + * See the right property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setRight(String right) throws DOMException; @@ -1152,6 +1838,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getSize(); + /** + * See the size property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setSize(String size) throws DOMException; @@ -1163,6 +1856,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getSpeak(); + /** + * See the speak property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setSpeak(String speak) throws DOMException; @@ -1174,6 +1874,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getSpeakHeader(); + /** + * See the speak-header property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setSpeakHeader(String speakHeader) throws DOMException; @@ -1185,6 +1892,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getSpeakNumeral(); + /** + * See the speak-numeral property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setSpeakNumeral(String speakNumeral) throws DOMException; @@ -1196,6 +1910,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getSpeakPunctuation(); + /** + * See the speak-punctuation property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setSpeakPunctuation(String speakPunctuation) throws DOMException; @@ -1207,6 +1928,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getSpeechRate(); + /** + * See the speech-rate property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setSpeechRate(String speechRate) throws DOMException; @@ -1218,6 +1946,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getStress(); + /** + * See the stress property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setStress(String stress) throws DOMException; @@ -1229,6 +1964,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getTableLayout(); + /** + * See the table-layout property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setTableLayout(String tableLayout) throws DOMException; @@ -1240,6 +1982,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getTextAlign(); + /** + * See the text-align property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setTextAlign(String textAlign) throws DOMException; @@ -1251,6 +2000,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getTextDecoration(); + /** + * See the text-decoration property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setTextDecoration(String textDecoration) throws DOMException; @@ -1262,6 +2018,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getTextIndent(); + /** + * See the text-indent property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setTextIndent(String textIndent) throws DOMException; @@ -1273,6 +2036,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getTextShadow(); + /** + * See the text-shadow property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setTextShadow(String textShadow) throws DOMException; @@ -1284,6 +2054,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getTextTransform(); + /** + * See the text-transform property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setTextTransform(String textTransform) throws DOMException; @@ -1295,6 +2072,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getTop(); + /** + * See the top property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setTop(String top) throws DOMException; @@ -1306,6 +2090,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getUnicodeBidi(); + /** + * See the unicode-bidi property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setUnicodeBidi(String unicodeBidi) throws DOMException; @@ -1317,6 +2108,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getVerticalAlign(); + /** + * See the vertical-align property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setVerticalAlign(String verticalAlign) throws DOMException; @@ -1328,6 +2126,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getVisibility(); + /** + * See the visibility property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setVisibility(String visibility) throws DOMException; @@ -1339,6 +2144,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getVoiceFamily(); + /** + * See the voice-family property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setVoiceFamily(String voiceFamily) throws DOMException; @@ -1350,6 +2162,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getVolume(); + /** + * See the volume property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setVolume(String volume) throws DOMException; @@ -1361,6 +2180,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getWhiteSpace(); + /** + * See the white-space property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setWhiteSpace(String whiteSpace) throws DOMException; @@ -1372,6 +2198,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getWidows(); + /** + * See the widows property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setWidows(String widows) throws DOMException; @@ -1383,6 +2216,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getWidth(); + /** + * See the width property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setWidth(String width) throws DOMException; @@ -1394,6 +2234,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getWordSpacing(); + /** + * See the word-spacing property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setWordSpacing(String wordSpacing) throws DOMException; @@ -1405,6 +2252,13 @@ public interface CSS2Properties { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. */ public String getZIndex(); + /** + * See the z-index property definition in CSS2. + * @exception DOMException + * SYNTAX_ERR: Raised if the new value has a syntax error and is + * unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly. + */ public void setZIndex(String zIndex) throws DOMException; diff --git a/java/external/src/org/w3c/dom/css/CSSCharsetRule.java b/java/external/src/org/w3c/dom/css/CSSCharsetRule.java index ac18845..fc85a05 100644 --- a/java/external/src/org/w3c/dom/css/CSSCharsetRule.java +++ b/java/external/src/org/w3c/dom/css/CSSCharsetRule.java @@ -42,6 +42,14 @@ public interface CSSCharsetRule extends CSSRule { * readonly. */ public String getEncoding(); + /** + * The encoding information used in this @charset rule. + * @exception DOMException + * SYNTAX_ERR: Raised if the specified encoding value has a syntax error + * and is unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this encoding rule is + * readonly. + */ public void setEncoding(String encoding) throws DOMException; diff --git a/java/external/src/org/w3c/dom/css/CSSMediaRule.java b/java/external/src/org/w3c/dom/css/CSSMediaRule.java index c74d3fa..68a7304 100644 --- a/java/external/src/org/w3c/dom/css/CSSMediaRule.java +++ b/java/external/src/org/w3c/dom/css/CSSMediaRule.java @@ -35,14 +35,14 @@ public interface CSSMediaRule extends CSSRule { /** * Used to insert a new rule into the media block. - * @param rule The parsable text representing the rule. For rule sets + * @param rule The parsable text representing the rule. For rule sets * this contains both the selector and the style declaration. For * at-rules, this specifies both the at-identifier and the rule * content. - * @param index The index within the media block's rule collection of the - * rule before which to insert the specified rule. If the specified - * index is equal to the length of the media blocks's rule collection, - * the rule will be added to the end of the media block. + * @param index The index within the media block's rule collection of + * the rule before which to insert the specified rule. If the + * specified index is equal to the length of the media blocks's rule + * collection, the rule will be added to the end of the media block. * @return The index within the media block's rule collection of the * newly inserted rule. * @exception DOMException @@ -62,8 +62,8 @@ public interface CSSMediaRule extends CSSRule { /** * Used to delete a rule from the media block. - * @param index The index within the media block's rule collection of the - * rule to remove. + * @param index The index within the media block's rule collection of + * the rule to remove. * @exception DOMException * INDEX_SIZE_ERR: Raised if the specified index does not correspond to * a rule in the media rule list. diff --git a/java/external/src/org/w3c/dom/css/CSSPageRule.java b/java/external/src/org/w3c/dom/css/CSSPageRule.java index d2fc9c3..cb95a3e 100644 --- a/java/external/src/org/w3c/dom/css/CSSPageRule.java +++ b/java/external/src/org/w3c/dom/css/CSSPageRule.java @@ -30,6 +30,13 @@ public interface CSSPageRule extends CSSRule { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this rule is readonly. */ public String getSelectorText(); + /** + * The parsable textual representation of the page selector for the rule. + * @exception DOMException + * SYNTAX_ERR: Raised if the specified CSS string value has a syntax + * error and is unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this rule is readonly. + */ public void setSelectorText(String selectorText) throws DOMException; diff --git a/java/external/src/org/w3c/dom/css/CSSPrimitiveValue.java b/java/external/src/org/w3c/dom/css/CSSPrimitiveValue.java index 781ce8a..4131d26 100644 --- a/java/external/src/org/w3c/dom/css/CSSPrimitiveValue.java +++ b/java/external/src/org/w3c/dom/css/CSSPrimitiveValue.java @@ -177,7 +177,7 @@ public interface CSSPrimitiveValue extends CSSValue { * attached with this value can not accept the specified unit or the * float value, the value will be unchanged and a * DOMException will be raised. - * @param unitType A unit code as defined above. The unit code can only + * @param unitType A unit code as defined above. The unit code can only * be a float unit type (i.e. CSS_NUMBER, * CSS_PERCENTAGE, CSS_EMS, * CSS_EXS, CSS_PX, CSS_CM, @@ -186,7 +186,7 @@ public interface CSSPrimitiveValue extends CSSValue { * CSS_GRAD, CSS_MS, CSS_S, * CSS_HZ, CSS_KHZ, * CSS_DIMENSION). - * @param floatValue The new float value. + * @param floatValue The new float value. * @exception DOMException * INVALID_ACCESS_ERR: Raised if the attached property doesn't support * the float value or the unit type. @@ -200,7 +200,7 @@ public interface CSSPrimitiveValue extends CSSValue { * This method is used to get a float value in a specified unit. If this * CSS value doesn't contain a float value or can't be converted into * the specified unit, a DOMException is raised. - * @param unitType A unit code to get the float value. The unit code can + * @param unitType A unit code to get the float value. The unit code can * only be a float unit type (i.e. CSS_NUMBER, * CSS_PERCENTAGE, CSS_EMS, * CSS_EXS, CSS_PX, CSS_CM, @@ -223,11 +223,11 @@ public interface CSSPrimitiveValue extends CSSValue { * property attached to this value can't accept the specified unit or * the string value, the value will be unchanged and a * DOMException will be raised. - * @param stringType A string code as defined above. The string code can + * @param stringType A string code as defined above. The string code can * only be a string unit type (i.e. CSS_STRING, * CSS_URI, CSS_IDENT, and * CSS_ATTR). - * @param stringValue The new string value. + * @param stringValue The new string value. * @exception DOMException * INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a string * value or if the string value can't be converted into the specified diff --git a/java/external/src/org/w3c/dom/css/CSSRule.java b/java/external/src/org/w3c/dom/css/CSSRule.java index 8626f80..2d375e9 100644 --- a/java/external/src/org/w3c/dom/css/CSSRule.java +++ b/java/external/src/org/w3c/dom/css/CSSRule.java @@ -75,6 +75,18 @@ public interface CSSRule { *
NO_MODIFICATION_ALLOWED_ERR: Raised if the rule is readonly. */ public String getCssText(); + /** + * The parsable textual representation of the rule. This reflects the + * current state of the rule and not its initial value. + * @exception DOMException + * SYNTAX_ERR: Raised if the specified CSS string value has a syntax + * error and is unparsable. + *
INVALID_MODIFICATION_ERR: Raised if the specified CSS string + * value represents a different type of rule than the current one. + *
HIERARCHY_REQUEST_ERR: Raised if the rule cannot be inserted at + * this point in the style sheet. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if the rule is readonly. + */ public void setCssText(String cssText) throws DOMException; diff --git a/java/external/src/org/w3c/dom/css/CSSStyleDeclaration.java b/java/external/src/org/w3c/dom/css/CSSStyleDeclaration.java index d017fbd..bcd5229 100644 --- a/java/external/src/org/w3c/dom/css/CSSStyleDeclaration.java +++ b/java/external/src/org/w3c/dom/css/CSSStyleDeclaration.java @@ -47,14 +47,26 @@ public interface CSSStyleDeclaration { * readonly or a property is readonly. */ public String getCssText(); + /** + * The parsable textual representation of the declaration block + * (excluding the surrounding curly braces). Setting this attribute will + * result in the parsing of the new value and resetting of all the + * properties in the declaration block including the removal or addition + * of properties. + * @exception DOMException + * SYNTAX_ERR: Raised if the specified CSS string value has a syntax + * error and is unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this declaration is + * readonly or a property is readonly. + */ public void setCssText(String cssText) throws DOMException; /** * Used to retrieve the value of a CSS property if it has been explicitly * set within this declaration block. - * @param propertyName The name of the CSS property. See the CSS property - * index. + * @param propertyName The name of the CSS property. See the CSS + * property index. * @return Returns the value of the property if it has been explicitly * set for this declaration block. Returns the empty string if the * property has not been set. @@ -68,8 +80,8 @@ public interface CSSStyleDeclaration { * property. Shorthand property values can only be accessed and modified * as strings, using the getPropertyValue and * setProperty methods. - * @param propertyName The name of the CSS property. See the CSS property - * index. + * @param propertyName The name of the CSS property. See the CSS + * property index. * @return Returns the value of the property if it has been explicitly * set for this declaration block. Returns null if the * property has not been set. @@ -79,8 +91,8 @@ public interface CSSStyleDeclaration { /** * Used to remove a CSS property if it has been explicitly set within * this declaration block. - * @param propertyName The name of the CSS property. See the CSS property - * index. + * @param propertyName The name of the CSS property. See the CSS + * property index. * @return Returns the value of the property if it has been explicitly * set for this declaration block. Returns the empty string if the * property has not been set or the property name does not correspond @@ -96,8 +108,8 @@ public interface CSSStyleDeclaration { * Used to retrieve the priority of a CSS property (e.g. the * "important" qualifier) if the property has been * explicitly set in this declaration block. - * @param propertyName The name of the CSS property. See the CSS property - * index. + * @param propertyName The name of the CSS property. See the CSS + * property index. * @return A string representing the priority (e.g. * "important") if one exists. The empty string if none * exists. @@ -107,10 +119,10 @@ public interface CSSStyleDeclaration { /** * Used to set a property value and priority within this declaration * block. - * @param propertyName The name of the CSS property. See the CSS property - * index. - * @param value The new value of the property. - * @param priority The new priority of the property (e.g. + * @param propertyName The name of the CSS property. See the CSS + * property index. + * @param value The new value of the property. + * @param priority The new priority of the property (e.g. * "important"). * @exception DOMException * SYNTAX_ERR: Raised if the specified value has a syntax error and is @@ -136,7 +148,7 @@ public interface CSSStyleDeclaration { * method does not have to be the order in which they were set. This * method can be used to iterate over all properties in this declaration * block. - * @param index Index of the property name to retrieve. + * @param index Index of the property name to retrieve. * @return The name of the property at this ordinal position. The empty * string if no property exists at this position. */ diff --git a/java/external/src/org/w3c/dom/css/CSSStyleRule.java b/java/external/src/org/w3c/dom/css/CSSStyleRule.java index 45a647b..e3e0cd8 100644 --- a/java/external/src/org/w3c/dom/css/CSSStyleRule.java +++ b/java/external/src/org/w3c/dom/css/CSSStyleRule.java @@ -31,6 +31,15 @@ public interface CSSStyleRule extends CSSRule { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this rule is readonly. */ public String getSelectorText(); + /** + * The textual representation of the selector for the rule set. The + * implementation may have stripped out insignificant whitespace while + * parsing the selector. + * @exception DOMException + * SYNTAX_ERR: Raised if the specified CSS string value has a syntax + * error and is unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this rule is readonly. + */ public void setSelectorText(String selectorText) throws DOMException; diff --git a/java/external/src/org/w3c/dom/css/CSSStyleSheet.java b/java/external/src/org/w3c/dom/css/CSSStyleSheet.java index cdfd74d..b529e5d 100644 --- a/java/external/src/org/w3c/dom/css/CSSStyleSheet.java +++ b/java/external/src/org/w3c/dom/css/CSSStyleSheet.java @@ -44,11 +44,11 @@ public interface CSSStyleSheet extends StyleSheet { /** * Used to insert a new rule into the style sheet. The new rule now * becomes part of the cascade. - * @param rule The parsable text representing the rule. For rule sets + * @param rule The parsable text representing the rule. For rule sets * this contains both the selector and the style declaration. For * at-rules, this specifies both the at-identifier and the rule * content. - * @param index The index within the style sheet's rule list of the rule + * @param index The index within the style sheet's rule list of the rule * before which to insert the specified rule. If the specified index * is equal to the length of the style sheet's rule collection, the * rule will be added to the end of the style sheet. @@ -71,7 +71,7 @@ public interface CSSStyleSheet extends StyleSheet { /** * Used to delete a rule from the style sheet. - * @param index The index within the style sheet's rule list of the rule + * @param index The index within the style sheet's rule list of the rule * to remove. * @exception DOMException * INDEX_SIZE_ERR: Raised if the specified index does not correspond to diff --git a/java/external/src/org/w3c/dom/css/CSSValue.java b/java/external/src/org/w3c/dom/css/CSSValue.java index c409290..48b2fbd 100644 --- a/java/external/src/org/w3c/dom/css/CSSValue.java +++ b/java/external/src/org/w3c/dom/css/CSSValue.java @@ -57,6 +57,16 @@ public interface CSSValue { *
NO_MODIFICATION_ALLOWED_ERR: Raised if this value is readonly. */ public String getCssText(); + /** + * A string representation of the current value. + * @exception DOMException + * SYNTAX_ERR: Raised if the specified CSS string value has a syntax + * error (according to the attached property) or is unparsable. + *
INVALID_MODIFICATION_ERR: Raised if the specified CSS string + * value represents a different type of values than the values allowed + * by the CSS property. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this value is readonly. + */ public void setCssText(String cssText) throws DOMException; diff --git a/java/external/src/org/w3c/dom/css/DOMImplementationCSS.java b/java/external/src/org/w3c/dom/css/DOMImplementationCSS.java index 66755de..65c9729 100644 --- a/java/external/src/org/w3c/dom/css/DOMImplementationCSS.java +++ b/java/external/src/org/w3c/dom/css/DOMImplementationCSS.java @@ -25,9 +25,9 @@ import org.w3c.dom.DOMException; public interface DOMImplementationCSS extends DOMImplementation { /** * Creates a new CSSStyleSheet. - * @param title The advisory title. See also the section. - * @param media The comma-separated list of media associated with the new - * style sheet. See also the section. + * @param title The advisory title. See also the section. + * @param media The comma-separated list of media associated with the + * new style sheet. See also the section. * @return A new CSS style sheet. * @exception DOMException * SYNTAX_ERR: Raised if the specified media string value has a syntax diff --git a/java/external/src/org/w3c/dom/css/DocumentCSS.java b/java/external/src/org/w3c/dom/css/DocumentCSS.java index bb1b854..8fe93c7 100644 --- a/java/external/src/org/w3c/dom/css/DocumentCSS.java +++ b/java/external/src/org/w3c/dom/css/DocumentCSS.java @@ -12,8 +12,8 @@ package org.w3c.dom.css; -import org.w3c.dom.stylesheets.DocumentStyle; import org.w3c.dom.Element; +import org.w3c.dom.stylesheets.DocumentStyle; /** * This interface represents a document with a CSS view. @@ -39,9 +39,9 @@ public interface DocumentCSS extends DocumentStyle { /** * This method is used to retrieve the override style declaration for a * specified element and a specified pseudo-element. - * @param elt The element whose style is to be modified. This parameter + * @param elt The element whose style is to be modified. This parameter * cannot be null. - * @param pseudoElt The pseudo-element or null if none. + * @param pseudoElt The pseudo-element or null if none. * @return The override style declaration. */ public CSSStyleDeclaration getOverrideStyle(Element elt, diff --git a/java/external/src/org/w3c/dom/css/ViewCSS.java b/java/external/src/org/w3c/dom/css/ViewCSS.java index 6c98bd4..0f7e88f 100644 --- a/java/external/src/org/w3c/dom/css/ViewCSS.java +++ b/java/external/src/org/w3c/dom/css/ViewCSS.java @@ -12,8 +12,8 @@ package org.w3c.dom.css; -import org.w3c.dom.views.AbstractView; import org.w3c.dom.Element; +import org.w3c.dom.views.AbstractView; /** * This interface represents a CSS view. The getComputedStyle @@ -31,9 +31,9 @@ import org.w3c.dom.Element; public interface ViewCSS extends AbstractView { /** * This method is used to get the computed style as it is defined in . - * @param elt The element whose style is to be computed. This parameter + * @param elt The element whose style is to be computed. This parameter * cannot be null. - * @param pseudoElt The pseudo-element or null if none. + * @param pseudoElt The pseudo-element or null if none. * @return The computed style. The CSSStyleDeclaration is * read-only and contains only absolute values. */ diff --git a/java/external/src/org/w3c/dom/events/EventListener.java b/java/external/src/org/w3c/dom/events/EventListener.java index 52e60cb..1df8020 100644 --- a/java/external/src/org/w3c/dom/events/EventListener.java +++ b/java/external/src/org/w3c/dom/events/EventListener.java @@ -31,7 +31,7 @@ public interface EventListener { /** * This method is called whenever an event occurs of the type for which * the EventListener interface was registered. - * @param evt The Event contains contextual information + * @param evt The Event contains contextual information * about the event. It also contains the stopPropagation * and preventDefault methods which are used in * determining the event's flow and default action. diff --git a/java/external/src/org/w3c/dom/events/MouseEvent.java b/java/external/src/org/w3c/dom/events/MouseEvent.java index 2f3d203..be78035 100644 --- a/java/external/src/org/w3c/dom/events/MouseEvent.java +++ b/java/external/src/org/w3c/dom/events/MouseEvent.java @@ -117,10 +117,14 @@ public interface MouseEvent extends UIEvent { * @param viewArg Specifies the Event's * AbstractView. * @param detailArg Specifies the Event's mouse click count. - * @param screenXArg Specifies the Event's screen x coordinate - * @param screenYArg Specifies the Event's screen y coordinate - * @param clientXArg Specifies the Event's client x coordinate - * @param clientYArg Specifies the Event's client y coordinate + * @param screenXArg Specifies the Event's screen x + * coordinate + * @param screenYArg Specifies the Event's screen y + * coordinate + * @param clientXArg Specifies the Event's client x + * coordinate + * @param clientYArg Specifies the Event's client y + * coordinate * @param ctrlKeyArg Specifies whether or not control key was depressed * during the Event. * @param altKeyArg Specifies whether or not alt key was depressed during diff --git a/java/external/src/org/w3c/dom/ranges/Range.java b/java/external/src/org/w3c/dom/ranges/Range.java index da0f53d..a576b4d 100644 --- a/java/external/src/org/w3c/dom/ranges/Range.java +++ b/java/external/src/org/w3c/dom/ranges/Range.java @@ -13,8 +13,8 @@ package org.w3c.dom.ranges; import org.w3c.dom.Node; -import org.w3c.dom.DocumentFragment; import org.w3c.dom.DOMException; +import org.w3c.dom.DocumentFragment; /** *

See also the Document Object Model (DOM) Level 2 Traversal and Range Specification. @@ -93,6 +93,8 @@ public interface Range { * node. Child units are Nodes in all other cases. *
INVALID_STATE_ERR: Raised if detach() has already * been invoked on this object. + *
WRONG_DOCUMENT_ERR: Raised if refNode was created + * from a different document than the one that created this range. */ public void setStart(Node refNode, int offset) @@ -115,6 +117,8 @@ public interface Range { * node. Child units are Nodes in all other cases. *
INVALID_STATE_ERR: Raised if detach() has already * been invoked on this object. + *
WRONG_DOCUMENT_ERR: Raised if refNode was created + * from a different document than the one that created this range. */ public void setEnd(Node refNode, int offset) @@ -131,6 +135,8 @@ public interface Range { * @exception DOMException * INVALID_STATE_ERR: Raised if detach() has already been * invoked on this object. + *
WRONG_DOCUMENT_ERR: Raised if refNode was created + * from a different document than the one that created this range. */ public void setStartBefore(Node refNode) throws RangeException, DOMException; @@ -146,6 +152,8 @@ public interface Range { * @exception DOMException * INVALID_STATE_ERR: Raised if detach() has already been * invoked on this object. + *
WRONG_DOCUMENT_ERR: Raised if refNode was created + * from a different document than the one that created this range. */ public void setStartAfter(Node refNode) throws RangeException, DOMException; @@ -161,6 +169,8 @@ public interface Range { * @exception DOMException * INVALID_STATE_ERR: Raised if detach() has already been * invoked on this object. + *
WRONG_DOCUMENT_ERR: Raised if refNode was created + * from a different document than the one that created this range. */ public void setEndBefore(Node refNode) throws RangeException, DOMException; @@ -176,6 +186,8 @@ public interface Range { * @exception DOMException * INVALID_STATE_ERR: Raised if detach() has already been * invoked on this object. + *
WRONG_DOCUMENT_ERR: Raised if refNode was created + * from a different document than the one that created this range. */ public void setEndAfter(Node refNode) throws RangeException, DOMException; @@ -202,6 +214,8 @@ public interface Range { * @exception DOMException * INVALID_STATE_ERR: Raised if detach() has already been * invoked on this object. + *
WRONG_DOCUMENT_ERR: Raised if refNode was created + * from a different document than the one that created this range. */ public void selectNode(Node refNode) throws RangeException, DOMException; @@ -215,6 +229,8 @@ public interface Range { * @exception DOMException * INVALID_STATE_ERR: Raised if detach() has already been * invoked on this object. + *
WRONG_DOCUMENT_ERR: Raised if refNode was created + * from a different document than the one that created this range. */ public void selectNodeContents(Node refNode) throws RangeException, DOMException; @@ -247,7 +263,8 @@ public interface Range { /** * Compare the boundary-points of two Ranges in a document. - * @param how A code representing the type of comparison, as defined above. + * @param how A code representing the type of comparison, as defined + * above. * @param sourceRange The Range on which this current * Range is compared to. * @return -1, 0 or 1 depending on whether the corresponding diff --git a/java/external/src/org/w3c/dom/stylesheets/MediaList.java b/java/external/src/org/w3c/dom/stylesheets/MediaList.java index eaf152f..3b10ed2 100644 --- a/java/external/src/org/w3c/dom/stylesheets/MediaList.java +++ b/java/external/src/org/w3c/dom/stylesheets/MediaList.java @@ -35,6 +35,15 @@ public interface MediaList { * readonly. */ public String getMediaText(); + /** + * The parsable textual representation of the media list. This is a + * comma-separated list of media. + * @exception DOMException + * SYNTAX_ERR: Raised if the specified string value has a syntax error + * and is unparsable. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this media list is + * readonly. + */ public void setMediaText(String mediaText) throws DOMException; @@ -48,7 +57,7 @@ public interface MediaList { * Returns the indexth in the list. If index is * greater than or equal to the number of media in the list, this * returns null. - * @param index Index into the collection. + * @param index Index into the collection. * @return The medium at the indexth position in the * MediaList, or null if that is not a valid * index. diff --git a/java/external/src/org/w3c/dom/stylesheets/StyleSheet.java b/java/external/src/org/w3c/dom/stylesheets/StyleSheet.java index 94ccc18..3da4307 100644 --- a/java/external/src/org/w3c/dom/stylesheets/StyleSheet.java +++ b/java/external/src/org/w3c/dom/stylesheets/StyleSheet.java @@ -44,6 +44,14 @@ public interface StyleSheet { * user agent, the disabled attribute is ignored. */ public boolean getDisabled(); + /** + * false if the style sheet is applied to the document. + * true if it is not. Modifying this attribute may cause a + * new resolution of style for the document. A stylesheet only applies + * if both an appropriate medium definition is present and the disabled + * attribute is false. So, if the media doesn't apply to the current + * user agent, the disabled attribute is ignored. + */ public void setDisabled(boolean disabled); /** diff --git a/java/external/src/org/w3c/dom/traversal/DocumentTraversal.java b/java/external/src/org/w3c/dom/traversal/DocumentTraversal.java index d27a9f1..103cde0 100644 --- a/java/external/src/org/w3c/dom/traversal/DocumentTraversal.java +++ b/java/external/src/org/w3c/dom/traversal/DocumentTraversal.java @@ -16,12 +16,13 @@ import org.w3c.dom.Node; import org.w3c.dom.DOMException; /** - * DocumentTraversal contains methods that create iterators and - * tree-walkers to traverse a node and its children in document order (depth - * first, pre-order traversal, which is equivalent to the order in which the - * start tags occur in the text representation of the document). In DOMs - * which support the Traversal feature, DocumentTraversal will - * be implemented by the same objects that implement the Document interface. + * DocumentTraversal contains methods that create + * NodeIterators and TreeWalkers to traverse a + * node and its children in document order (depth first, pre-order + * traversal, which is equivalent to the order in which the start tags occur + * in the text representation of the document). In DOMs which support the + * Traversal feature, DocumentTraversal will be implemented by + * the same objects that implement the Document interface. *

See also the Document Object Model (DOM) Level 2 Traversal and Range Specification. * @since DOM Level 2 */ @@ -29,16 +30,16 @@ public interface DocumentTraversal { /** * Create a new NodeIterator over the subtree rooted at the * specified node. - * @param root The node which will be iterated together with its children. - * The iterator is initially positioned just before this node. The - * whatToShow flags and the filter, if any, are not - * considered when setting this position. The root must not be - * null. + * @param root The node which will be iterated together with its + * children. The NodeIterator is initially positioned + * just before this node. The whatToShow flags and the + * filter, if any, are not considered when setting this position. The + * root must not be null. * @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 NodeFilter for the set of possible - * SHOW_ values.These flags can be combined using - * OR. + * the logical view of the tree presented by the + * NodeIterator. See the description of + * NodeFilter for the set of possible SHOW_ + * values.These flags can be combined using OR. * @param filter The NodeFilter to be used with this * TreeWalker, or null to indicate no filter. * @param entityReferenceExpansion The value of this flag determines @@ -68,9 +69,10 @@ public interface DocumentTraversal { * parentNode and nextNode. The root must * not be null. * @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 NodeFilter for the set of possible - * SHOW_ values.These flags can be combined using OR. + * the logical view of the tree presented by the + * TreeWalker. See the description of + * NodeFilter for the set of possible SHOW_ + * values.These flags can be combined using OR. * @param filter The NodeFilter to be used with this * TreeWalker, or null to indicate no filter. * @param entityReferenceExpansion If this flag is false, the contents of diff --git a/java/external/src/org/w3c/dom/traversal/NodeFilter.java b/java/external/src/org/w3c/dom/traversal/NodeFilter.java index 1fcff59..b9beac4 100644 --- a/java/external/src/org/w3c/dom/traversal/NodeFilter.java +++ b/java/external/src/org/w3c/dom/traversal/NodeFilter.java @@ -68,11 +68,11 @@ public interface NodeFilter { public static final int SHOW_ELEMENT = 0x00000001; /** * Show Attr nodes. This is meaningful only when creating an - * iterator or tree-walker with an attribute node as its - * root; in this case, it means that the attribute node - * will appear in the first position of the iteration or traversal. - * Since attributes are never children of other nodes, they do not - * appear when traversing over the document tree. + * NodeIterator or TreeWalker with an + * attribute node as its root; in this case, it means that + * the attribute node will appear in the first position of the iteration + * or traversal. Since attributes are never children of other nodes, + * they do not appear when traversing over the document tree. */ public static final int SHOW_ATTRIBUTE = 0x00000002; /** @@ -89,11 +89,12 @@ public interface NodeFilter { public static final int SHOW_ENTITY_REFERENCE = 0x00000010; /** * Show Entity nodes. This is meaningful only when creating - * an iterator or tree-walker with an Entity node as its - * root; in this case, it means that the Entity - * node will appear in the first position of the traversal. Since - * entities are not part of the document tree, they do not appear when - * traversing over the document tree. + * an NodeIterator or TreeWalker with an + * Entity node as its root; in this case, it + * means that the Entity node will appear in the first + * position of the traversal. Since entities are not part of the + * document tree, they do not appear when traversing over the document + * tree. */ public static final int SHOW_ENTITY = 0x00000020; /** @@ -118,11 +119,12 @@ public interface NodeFilter { public static final int SHOW_DOCUMENT_FRAGMENT = 0x00000400; /** * Show Notation nodes. This is meaningful only when creating - * an iterator or tree-walker with a Notation node as its - * root; in this case, it means that the - * Notation node will appear in the first position of the - * traversal. Since notations are not part of the document tree, they do - * not appear when traversing over the document tree. + * an NodeIterator or TreeWalker with a + * Notation node as its root; in this case, it + * means that the Notation node will appear in the first + * position of the traversal. Since notations are not part of the + * document tree, they do not appear when traversing over the document + * tree. */ public static final int SHOW_NOTATION = 0x00000800; @@ -134,7 +136,7 @@ public interface NodeFilter { * user code. (Though you could do so if you wanted to use the same * filter to guide your own application logic.) * @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, + * @return A constant to determine whether the node is accepted, * rejected, or skipped, as defined above. */ public short acceptNode(Node n); diff --git a/java/external/src/org/w3c/dom/traversal/NodeIterator.java b/java/external/src/org/w3c/dom/traversal/NodeIterator.java index 1035faf..d1f0d08 100644 --- a/java/external/src/org/w3c/dom/traversal/NodeIterator.java +++ b/java/external/src/org/w3c/dom/traversal/NodeIterator.java @@ -16,15 +16,15 @@ import org.w3c.dom.Node; import org.w3c.dom.DOMException; /** - * Iterators are used to step through a set of nodes, e.g. the - * set of nodes in a NodeList, the document subtree governed by - * a particular Node, the results of a query, or any other set - * of nodes. The set of nodes to be iterated is determined by the - * implementation of the NodeIterator. DOM Level 2 specifies a - * single NodeIterator implementation for document-order - * traversal of a document subtree. Instances of these iterators are created - * by calling DocumentTraversal - * .createNodeIterator(). + * NodeIterators are used to step through a set of nodes, e.g. + * the set of nodes in a NodeList, the document subtree + * governed by a particular Node, the results of a query, or + * any other set of nodes. The set of nodes to be iterated is determined by + * the implementation of the NodeIterator. DOM Level 2 + * specifies a single NodeIterator implementation for + * document-order traversal of a document subtree. Instances of these + * NodeIterators are created by calling + * DocumentTraversal.createNodeIterator(). *

See also the Document Object Model (DOM) Level 2 Traversal and Range Specification. * @since DOM Level 2 */ @@ -37,8 +37,8 @@ public interface NodeIterator { /** * This attribute determines which node types are presented via the - * iterator. The available set of constants is defined in the - * NodeFilter interface. Nodes not accepted by + * NodeIterator. The available set of constants is defined + * in the NodeFilter interface. Nodes not accepted by * whatToShow will be skipped, but their children may still * be considered. Note that this skip takes precedence over the filter, * if any. @@ -52,10 +52,10 @@ public interface NodeIterator { /** * The value of this flag determines whether the children of entity - * reference nodes are visible to the iterator. If false, they and - * their descendants will be rejected. Note that this rejection takes - * precedence over whatToShow and the filter. Also note - * that this is currently the only situation where + * reference nodes are visible to the NodeIterator. If + * false, these children and their descendants will be rejected. Note + * that this rejection takes precedence over whatToShow and + * the filter. Also note that this is currently the only situation where * NodeIterators may reject a complete subtree rather than * skipping individual nodes. *
@@ -63,18 +63,18 @@ public interface NodeIterator { * expanded and does not expose the entity reference node itself, use * the whatToShow flags to hide the entity reference node * and set expandEntityReferences to true when creating the - * iterator. To produce a view of the document that has entity reference - * nodes but no entity expansion, use the whatToShow flags - * to show the entity reference node and set - * expandEntityReferences to false. + * NodeIterator. To produce a view of the document that has + * entity reference nodes but no entity expansion, use the + * whatToShow flags to show the entity reference node and + * set expandEntityReferences to false. */ public boolean getExpandEntityReferences(); /** * Returns the next node in the set and advances the position of the - * iterator in the set. After a NodeIterator is created, - * the first call to nextNode() returns the first node in - * the set. + * NodeIterator in the set. After a + * NodeIterator is created, the first call to + * nextNode() returns the first node in the set. * @return The next Node in the set being iterated over, or * null if there are no more members in that set. * @exception DOMException @@ -98,10 +98,11 @@ public interface NodeIterator { /** * Detaches the NodeIterator from the set which it iterated - * over, releasing any computational resources and placing the iterator - * in the INVALID state. After detach has been invoked, - * calls to nextNode or previousNode will - * raise the exception INVALID_STATE_ERR. + * over, releasing any computational resources and placing the + * NodeIterator in the INVALID state. After + * detach has been invoked, calls to nextNode + * or previousNode will raise the exception + * INVALID_STATE_ERR. */ public void detach(); diff --git a/java/external/src/org/w3c/dom/traversal/TreeWalker.java b/java/external/src/org/w3c/dom/traversal/TreeWalker.java index b109e8d..e90da06 100644 --- a/java/external/src/org/w3c/dom/traversal/TreeWalker.java +++ b/java/external/src/org/w3c/dom/traversal/TreeWalker.java @@ -58,8 +58,8 @@ public interface TreeWalker { /** * The value of this flag determines whether the children of entity * reference nodes are visible to the TreeWalker. If false, - * they and their descendants will be rejected. Note that this - * rejection takes precedence over whatToShow and the + * these children and their descendants will be rejected. Note that + * this rejection takes precedence over whatToShow and the * filter, if any. *
To produce a view of the document that has entity references * expanded and does not expose the entity reference node itself, use @@ -88,6 +88,21 @@ public interface TreeWalker { * currentNode to null. */ public Node getCurrentNode(); + /** + * The node at which the TreeWalker is currently positioned. + *
Alterations to the DOM tree may cause the current node to no longer + * be accepted by the TreeWalker's associated filter. + * currentNode may also be explicitly set to any node, + * whether or not it is within the subtree specified by the + * root node or would be accepted by the filter and + * whatToShow flags. Further traversal occurs relative to + * currentNode even if it is not part of the current view, + * by applying the filters in the requested direction; if no traversal + * is possible, currentNode is not changed. + * @exception DOMException + * NOT_SUPPORTED_ERR: Raised if an attempt is made to set + * currentNode to null. + */ public void setCurrentNode(Node currentNode) throws DOMException;