X-Git-Url: http://git.sourceforge.jp/view?a=blobdiff_plain;f=libjava%2Fclasspath%2Fexternal%2Fw3c_dom%2Forg%2Fw3c%2Fdom%2Fls%2FLSParserFilter.java;h=00db4d3c230fb840090050115e2d59e57ffa8d1c;hb=1c1d817aeab43a795cd70fc8ff159007ba878938;hp=4e612945e956bc558b5c5fca913bcc1a6296993f;hpb=ab0157ddcf1f5d6ec814d0bdddeb4229cca4a309;p=pf3gnuchains%2Fgcc-fork.git
diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSParserFilter.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSParserFilter.java
index 4e612945e95..00db4d3c230 100644
--- a/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSParserFilter.java
+++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/ls/LSParserFilter.java
@@ -16,32 +16,32 @@ import org.w3c.dom.Node;
import org.w3c.dom.Element;
/**
- * LSParserFilter
s provide applications the ability to examine
- * nodes as they are being constructed while parsing. As each node is
- * examined, it may be modified or removed, or the entire parse may be
- * terminated early.
- *
At the time any of the filter methods are called by the parser, the
- * owner Document and DOMImplementation objects exist and are accessible.
- * The document element is never passed to the LSParserFilter
- * methods, i.e. it is not possible to filter out the document element.
- * Document
, DocumentType
, Notation
,
- * Entity
, and Attr
nodes are never passed to the
- * acceptNode
method on the filter. The child nodes of an
- * EntityReference
node are passed to the filter if the
+ * LSParserFilter
s provide applications the ability to examine
+ * nodes as they are being constructed while parsing. As each node is
+ * examined, it may be modified or removed, or the entire parse may be
+ * terminated early.
+ *
At the time any of the filter methods are called by the parser, the
+ * owner Document and DOMImplementation objects exist and are accessible.
+ * The document element is never passed to the LSParserFilter
+ * methods, i.e. it is not possible to filter out the document element.
+ * Document
, DocumentType
, Notation
,
+ * Entity
, and Attr
nodes are never passed to the
+ * acceptNode
method on the filter. The child nodes of an
+ * EntityReference
node are passed to the filter if the
* parameter "
* entities" is set to false
. Note that, as described by the parameter "
- * entities", unexpanded entity reference nodes are never discarded and are always
- * passed to the filter.
- *
All validity checking while parsing a document occurs on the source - * document as it appears on the input stream, not on the DOM document as it - * is built in memory. With filters, the document in memory may be a subset - * of the document on the stream, and its validity may have been affected by - * the filtering. - *
All default attributes must be present on elements when the elements - * are passed to the filter methods. All other default content must be - * passed to the filter methods. - *
DOM applications must not raise exceptions in a filter. The effect of - * throwing exceptions from a filter is DOM implementation dependent. + * entities", unexpanded entity reference nodes are never discarded and are always + * passed to the filter. + *
All validity checking while parsing a document occurs on the source + * document as it appears on the input stream, not on the DOM document as it + * is built in memory. With filters, the document in memory may be a subset + * of the document on the stream, and its validity may have been affected by + * the filtering. + *
All default attributes must be present on elements when the elements + * are passed to the filter methods. All other default content must be + * passed to the filter methods. + *
DOM applications must not raise exceptions in a filter. The effect of + * throwing exceptions from a filter is DOM implementation dependent. *
See also the Document Object Model (DOM) Level 3 Load
and Save Specification.
*/
@@ -56,116 +56,116 @@ public interface LSParserFilter {
*/
public static final short FILTER_REJECT = 2;
/**
- * Skip this single node. The children of this node will still be
- * considered.
+ * Skip this single node. The children of this node will still be
+ * considered.
*/
public static final short FILTER_SKIP = 3;
/**
- * Interrupt the normal processing of the document.
+ * Interrupt the normal processing of the document.
*/
public static final short FILTER_INTERRUPT = 4;
/**
- * The parser will call this method after each Element
start
- * tag has been scanned, but before the remainder of the
- * Element
is processed. The intent is to allow the
- * element, including any children, to be efficiently skipped. Note that
- * only element nodes are passed to the startElement
- * function.
- *
The element node passed to startElement
for filtering
- * will include all of the Element's attributes, but none of the
- * children nodes. The Element may not yet be in place in the document
- * being constructed (it may not have a parent node.)
- *
A startElement
filter function may access or change
- * the attributes for the Element. Changing Namespace declarations will
+ * The parser will call this method after each Element
start
+ * tag has been scanned, but before the remainder of the
+ * Element
is processed. The intent is to allow the
+ * element, including any children, to be efficiently skipped. Note that
+ * only element nodes are passed to the startElement
+ * function.
+ *
The element node passed to startElement
for filtering
+ * will include all of the Element's attributes, but none of the
+ * children nodes. The Element may not yet be in place in the document
+ * being constructed (it may not have a parent node.)
+ *
A startElement
filter function may access or change
+ * the attributes for the Element. Changing Namespace declarations will
* have no effect on namespace resolution by the parser.
- *
For efficiency, the Element node passed to the filter may not be
- * the same one as is actually placed in the tree if the node is
- * accepted. And the actual node (node object identity) may be reused
+ *
For efficiency, the Element node passed to the filter may not be
+ * the same one as is actually placed in the tree if the node is
+ * accepted. And the actual node (node object identity) may be reused
* during the process of reading in and filtering a document.
- * @param elementArg The newly encountered element. At the time this
- * method is called, the element is incomplete - it will have its
- * attributes, but no children.
- * @return
+ * @param elementArg The newly encountered element. At the time this
+ * method is called, the element is incomplete - it will have its
+ * attributes, but no children.
+ * @return
*
FILTER_ACCEPT
if the Element
should
- * be included in the DOM document being built.
+ * FILTER_ACCEPT
if the Element
should
+ * be included in the DOM document being built.
* FILTER_REJECT
if the Element
and all of
- * its children should be rejected.
+ * FILTER_REJECT
if the Element
and all of
+ * its children should be rejected.
* FILTER_SKIP
if the
- * Element
should be skipped. All of its children are
- * inserted in place of the skipped Element
node.
+ * FILTER_SKIP
if the
+ * Element
should be skipped. All of its children are
+ * inserted in place of the skipped Element
node.
* FILTER_INTERRUPT
if the filter wants to stop the
- * processing of the document. Interrupting the processing of the
- * document does no longer guarantee that the resulting DOM tree is
- * XML well-formed. The Element
is rejected.
+ * FILTER_INTERRUPT
if the filter wants to stop the
+ * processing of the document. Interrupting the processing of the
+ * document does no longer guarantee that the resulting DOM tree is
+ * XML well-formed. The Element
is rejected.
* FILTER_ACCEPT
if this Node
should
- * be included in the DOM document being built.
+ * FILTER_ACCEPT
if this Node
should
+ * be included in the DOM document being built.
* FILTER_REJECT
if the Node
and all of its
- * children should be rejected.
+ * FILTER_REJECT
if the Node
and all of its
+ * children should be rejected.
* FILTER_SKIP
if the
- * Node
should be skipped and the Node
- * should be replaced by all the children of the Node
.
+ * FILTER_SKIP
if the
+ * Node
should be skipped and the Node
+ * should be replaced by all the children of the Node
.
* FILTER_INTERRUPT
if the filter wants to stop the
- * processing of the document. Interrupting the processing of the
- * document does no longer guarantee that the resulting DOM tree is
- * XML well-formed. The Node
is accepted and will be the
- * last completely parsed node.
+ * FILTER_INTERRUPT
if the filter wants to stop the
+ * processing of the document. Interrupting the processing of the
+ * document does no longer guarantee that the resulting DOM tree is
+ * XML well-formed. The Node
is accepted and will be the
+ * last completely parsed node.
* LSParser
what types of nodes to show to the
- * method LSParserFilter.acceptNode
. If a node is not shown
- * to the filter using this attribute, it is automatically included in
- * the DOM document being built. See NodeFilter
for
+ * Tells the LSParser
what types of nodes to show to the
+ * method LSParserFilter.acceptNode
. If a node is not shown
+ * to the filter using this attribute, it is automatically included in
+ * the DOM document being built. See NodeFilter
for
* definition of the constants. The constants SHOW_ATTRIBUTE
- * , SHOW_DOCUMENT
, SHOW_DOCUMENT_TYPE
,
- * SHOW_NOTATION
, SHOW_ENTITY
, and
- * SHOW_DOCUMENT_FRAGMENT
are meaningless here. Those nodes
- * will never be passed to LSParserFilter.acceptNode
.
+ * , SHOW_DOCUMENT
, SHOW_DOCUMENT_TYPE
,
+ * SHOW_NOTATION
, SHOW_ENTITY
, and
+ * SHOW_DOCUMENT_FRAGMENT
are meaningless here. Those nodes
+ * will never be passed to LSParserFilter.acceptNode
.
*