jkesselm 01/04/05 07:49:50
Modified: java/src/org/apache/xml/utils Tag: DTM_EXP DTMManager.java
Log:
Javadoc tweak
Revision Changes Path
No revision
No revision
1.1.2.2 +10 -6 xml-xalan/java/src/org/apache/xml/utils/DTMManager.java
Index: DTMManager.java
===================================================================
RCS file: /home/cvs/xml-xalan/java/src/org/apache/xml/utils/DTMManager.java,v
retrieving revision 1.1.2.1
retrieving revision 1.1.2.2
diff -u -r1.1.2.1 -r1.1.2.2
--- DTMManager.java 2001/04/03 21:10:00 1.1.2.1
+++ DTMManager.java 2001/04/05 14:49:50 1.1.2.2
@@ -160,9 +160,14 @@
PrefixResolver presolver);
/**
- * Create a new <code>DTMIterator</code> based only on a whatToShow and
- * a DTMFilter. The traversal semantics are defined as the descendant
- * access.
+ * Create a new <code>DTMIterator</code> based only on a whatToShow
+ * and a DTMFilter. The traversal semantics are defined as the
+ * descendant access.
+ * <p>
+ * Note that DTMIterators may not be an exact match to DOM *
+ * NodeIterators. They are initialized and used in much the same way
+ * as a NodeIterator, but their response to document mutation is not
+ * currently defined.
*
* @param whatToShow This flag specifies which node types may appear in
* the logical view of the tree presented by the iterator. See the
@@ -170,12 +175,11 @@
* <code>SHOW_</code> values.These flags can be combined using
* <code>OR</code>.
* @param filter The <code>NodeFilter</code> to be used with this
- * <code>TreeWalker</code>, or <code>null</code> to indicate no filter.
+ * <code>DTMFilter</code>, or <code>null</code> to indicate no filter.
* @param entityReferenceExpansion The value of this flag determines
* whether entity reference nodes are expanded.
*
- * @return The newly created <code>DTMIterator</code>.
- */
+ * @return The newly created <code>DTMIterator</code>. */
public abstract DTMIterator createDTMIterator(int whatToShow,
DTMFilter filter, boolean entityReferenceExpansion);
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
