cvs: phpdoc /en/reference/domxml/functions DomNode-replace-node.xml

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>