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:
+ *
| Attribute | + *Value | + *
|---|---|
Node.nodeName |
+ *
+ * qualifiedName |
+ *
Node.namespaceURI |
+ *
+ * namespaceURI |
+ *
Node.prefix |
+ * prefix, extracted
* from qualifiedName, or null if there is
- * no prefixNode.localNamelocal name, extracted from
- * qualifiedNameElement.tagName
- * qualifiedName
+ * no prefix |
+ *
Node.localName |
+ * local name, extracted from
+ * qualifiedName |
+ *
Element.tagName |
+ *
+ * qualifiedName |
+ *
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" .
+ * "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
+ * | + * Attribute | + *Value | + *
|---|---|
Node.nodeName |
+ * qualifiedName | + *
+ * Node.namespaceURI |
+ * namespaceURI |
+ *
+ * Node.prefix |
+ * prefix, extracted from
* qualifiedName, or null if there is no
- * prefixNode.localNamelocal name, extracted from
- * qualifiedNameAttr.name
- * qualifiedNameNode.nodeValuethe empty
- * string
+ * prefix |
+ *
Node.localName |
+ * local name, extracted from
+ * qualifiedName |
+ *
Attr.name |
+ *
+ * qualifiedName |
+ *
Node.nodeValue |
+ * the empty + * string | + *
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/".
+ * "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.
+ * 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.
- * 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/".
+ * "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.
- * 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.
+ * 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.
- * 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.
+ * "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.
- * 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.
+ * 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.
+ * 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.
+ * 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.
- * 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.
+ * "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.
- * 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:
+ *
| Interface | + *nodeName | + *nodeValue | + *attributes | + *
|---|---|---|---|
| Attr | + *name of + * attribute | + *value of attribute | + *null | + *
| CDATASection | + *"#cdata-section" |
+ * + * content of the CDATA Section | + *null | + *
| Comment | + *"#comment" |
+ * content of + * the comment | + *null | + *
| Document | + *"#document" |
+ * null | + *null | + *
| DocumentFragment | + *
+ * "#document-fragment" |
+ * null | + *null | + *
| DocumentType | + *document type name | + *+ * null | + *null | + *
| Element | + *tag name | + *null | + *NamedNodeMap | + *
| Entity | + *entity name | + *null | + *null | + *
| + * EntityReference | + *name of entity referenced | + *null | + *null | + *
| Notation | + *notation name | + *null | + *+ * null | + *
| ProcessingInstruction | + *target | + *entire content excluding the target | + *null | + *
| Text | + *
+ * "#text" |
+ * content of the text node | + *null | + *
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;