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

chregu Thu Aug 15 06:22:22 2002 EDT Modified files: /phpdoc/en/reference/domxml/functions DomNode-replace-child.xml Log: Added notice about changed behaviour in php 4.3 Index: phpdoc/en/reference/domxml/functions/DomNode-replace-child.xml diff -u phpdoc/en/reference/domxml/functions/DomNode-replace-child.xml:1.2 phpdoc/en/reference/domxml/functions/DomNode-replace-child.xml:1.3 --- phpdoc/en/reference/domxml/functions/DomNode-replace-child.xml:1.2 Wed Apr 24 04:27:30 2002 +++ phpdoc/en/reference/domxml/functions/DomNode-replace-child.xml Thu Aug 15 06:22:22 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <refentry id='function.DomNode-replace-child'> <refnamediv> <refname>DomNode->replace_child</refname> @@ -15,11 +15,19 @@ <methodparam><type>object</type><parameter>newnode</parameter></methodparam> </methodsynopsis> <para> - This function replaces the child <parameter>oldnode</parameter> + (PHP 4.2) This function replaces the child <parameter>oldnode</parameter> with the passed new node. If the new node is already a child it will not be added a second time. If the old node cannot be found the function returns false. If the replacement succeds the old node is returned. + </para> + <para> + (PHP 4.3) This function replaces the child <parameter>oldnode</parameter> + with the passed <parameter>newnode</parameter>, even if the new node already + is a child of the DomNode. If <parameter>newnode</parameter> was already + inserted in the document it is first unlinked from its existing context. + If the old node cannot be found the function returns false. If the replacement + succeds the old node is returned. (This behaviour is according to the W3C specs). </para> <para> See also <function>DomNode_append_child</function>