jkesselm 01/04/06 07:25:53
Modified: java/src/org/apache/xml/utils Tag: DTM_EXP DTM.java
Log:
Javadoc clarifications/issues
Revision Changes Path
No revision
No revision
1.2.2.9 +8 -0 xml-xalan/java/src/org/apache/xml/utils/DTM.java
Index: DTM.java
===================================================================
RCS file: /home/cvs/xml-xalan/java/src/org/apache/xml/utils/DTM.java,v
retrieving revision 1.2.2.8
retrieving revision 1.2.2.9
diff -u -r1.2.2.8 -r1.2.2.9
--- DTM.java 2001/04/06 14:14:40 1.2.2.8
+++ DTM.java 2001/04/06 14:25:52 1.2.2.9
@@ -714,6 +714,14 @@
/**
* Append a child to the end of the document. Please note that the node
* is always cloned if it is owned by another document.
+ * <p>
+ * TODO: "End of the document" needs to be defined better. I believe the
+ * intent is equivalent to the DOM sequence
+ * document.getRootElement().appendChild(document.importNode(newChild)))
+ * but we need to nail that down more explicitly.
+ * <p>
+ * TODO: ISSUE -- In DTM, I believe we must ALWAYS clone the node, since
+ * the base DTM is immutable and nodes never exist in isolation.
*
* @param newChild Must be a valid new node handle.
* @param clone true if the child should be cloned into the document.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
