From 83d6f9938ee6711d61d4e9dafafe5dcc68870ad5 Mon Sep 17 00:00:00 2001
From: Uwe Steinmann <steinm@php.net>
Date: Tue, 23 Apr 2002 05:29:54 +0000
Subject: [PATCH] - Initial documentation

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@79538 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../domxml/functions/DomNode-replace-node.xml      | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/reference/domxml/functions/DomNode-replace-node.xml b/reference/domxml/functions/DomNode-replace-node.xml
index 04459c88ac..bddba9cc00 100644
--- a/reference/domxml/functions/DomNode-replace-node.xml
+++ b/reference/domxml/functions/DomNode-replace-node.xml
@@ -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>