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>
 


Reply via email to