steinm Tue Apr 23 01:29:54 2002 EDT
Modified files:
/phpdoc/en/reference/domxml/functions DomNode-replace-node.xml
Log:
- Initial documentation
Index: phpdoc/en/reference/domxml/functions/DomNode-replace-node.xml
diff -u phpdoc/en/reference/domxml/functions/DomNode-replace-node.xml:1.2
phpdoc/en/reference/domxml/functions/DomNode-replace-node.xml:1.3
--- phpdoc/en/reference/domxml/functions/DomNode-replace-node.xml:1.2 Wed Apr 17
02:37:40 2002
+++ phpdoc/en/reference/domxml/functions/DomNode-replace-node.xml Tue Apr 23
+01:29:54 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/domxml.xml, last change in rev 1.39 -->
<refentry id='function.DomNode-replace-node'>
<refnamediv>
@@ -12,11 +12,21 @@
<title>Description</title>
<methodsynopsis>
<type>object</type><methodname>DomNode->replace_node</methodname>
+ <methodparam><type>object</type><parameter>newnode</parameter></methodparam>
<void/>
</methodsynopsis>
<para>
- &warn.undocumented.func;
+ This function replaces an existing node with the passed
+ new node. Before the replacement
+ <parameter>newnode</parameter> is copied to make sure a node which is
+ already in the document will not be inserted a second time. This
+ behaviour enforces to do all modifications on the node before the
+ replacement or to refetch the inserted node afterwards with functions like
+ <function>DomNode_first_child</function>,
+ <function>DomNode_child_nodes</function> etc..
</para>
+ <para>
+ See also <function>DomNode_append_child</function>
</refsect1>
</refentry>