From 3afcc1f8e36f091279fb227b9340fde834e19738 Mon Sep 17 00:00:00 2001
From: Christian Stocker <chregu@php.net>
Date: Fri, 16 Aug 2002 09:10:15 +0000
Subject: [PATCH] updated to the last source commits

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@92254 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../domxml/functions/DomNode-append-child.xml      | 14 +++++++++++---
 .../domxml/functions/DomNode-insert-before.xml     | 12 +++++++++---
 .../domxml/functions/DomNode-next-sibling.xml      |  7 ++++---
 .../domxml/functions/DomNode-previous-sibling.xml  |  7 +++++--
 4 files changed, 29 insertions(+), 11 deletions(-)

diff --git a/reference/domxml/functions/DomNode-append-child.xml b/reference/domxml/functions/DomNode-append-child.xml
index de1b835bc0..a8e1b53ae8 100644
--- a/reference/domxml/functions/DomNode-append-child.xml
+++ b/reference/domxml/functions/DomNode-append-child.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.40 -->
   <refentry id='function.DomNode-append-child'>
    <refnamediv>
@@ -22,7 +22,7 @@
      other node.
     </para>
     <para>
-     Before a new child is appended it is first duplicated. Therefore the new
+     (PHP &lt; 4.3) Before a new child is appended it is first duplicated. Therefore the new
      child is a completely new copy which can be modified without changing the
      node which was passed to this function. If the node passed has children
      itself, they will be duplicated as well, which makes it quite easy to
@@ -30,6 +30,13 @@
      appended child. If you plan to do further modifications on the appended
      child you must use the returned node.
     </para>
+    <para>
+     (PHP &gt;= 4.3) The new child <parameter>newnode</parameter> is first 
+     unlinked from its existing context, if it already existed in a document.
+     Therefore the node is moved and not copies anymore. This is the behaviour 
+     according to the W3C specifications. If you want to duplicate large parts
+     of a xml document, use DomNode->clone_node() before appending.
+    </para>
     <para>
      The following example will add a new element node to a fresh document
      and sets the attribute "align" to "left".
@@ -98,7 +105,8 @@ echo "</PRE>";
      <function>DomNode_append_child</function>.
     </para>
     <para>
-     See also <function>DomNode_insert_before</function>.
+     See also <function>DomNode_insert_before</function>,
+              <function>DomNode_clone_node</function>.
     </para>
    </refsect1>
   </refentry>
diff --git a/reference/domxml/functions/DomNode-insert-before.xml b/reference/domxml/functions/DomNode-insert-before.xml
index 9470f78d58..ada975a635 100644
--- a/reference/domxml/functions/DomNode-insert-before.xml
+++ b/reference/domxml/functions/DomNode-insert-before.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.38 -->
   <refentry id='function.DomNode-insert-before'>
    <refnamediv>
@@ -17,10 +17,16 @@
     </methodsynopsis>
     <para>
      This function inserts the new node <parameter>newnode</parameter> right
-     before the node <parameter>refnode</parameter>. The return value is the
-     inserted node. If you plan to do further modifications on the appended
+     before the node <parameter>refnode</parameter>. The return value is the 
+     inserted node. If you plan to do further modifications on the appended 
      child you must use the returned node.
     </para>
+    <para>
+     (PHP &gt;= 4.3 only) If <parameter>newnode</parameter> already is part of a 
+     document, it will be first unlinked from its existing context. If 
+     <parameter>refnode</parameter> is NULL, then <parameter>newnode</parameter>
+     will be inserted at the end of the list of children.  
+    </para>
     <para>
      <function>DomNode_insert_before</function> is very similar to
      <function>DomNode_append_child</function> as the following example shows
diff --git a/reference/domxml/functions/DomNode-next-sibling.xml b/reference/domxml/functions/DomNode-next-sibling.xml
index bf1b8c9b7a..758efda0f6 100644
--- a/reference/domxml/functions/DomNode-next-sibling.xml
+++ b/reference/domxml/functions/DomNode-next-sibling.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.38 -->
   <refentry id='function.DomNode-next-sibling'>
    <refnamediv>
@@ -16,8 +16,9 @@
     </methodsynopsis>
     <para>
      This function returns the next sibling of the current node. If there is
-     no next sibling it returns false. You can use this function to iterate
-     over all children of a node as shown in the example.
+     no next sibling it returns false (&lt; 4.3) or null (&gt= 4.3). You can 
+     use this function to iterate over all children of a node as shown in the 
+     example.
     </para>
     <para>
      <example>
diff --git a/reference/domxml/functions/DomNode-previous-sibling.xml b/reference/domxml/functions/DomNode-previous-sibling.xml
index 542a6e1499..8b0a02a65f 100644
--- a/reference/domxml/functions/DomNode-previous-sibling.xml
+++ b/reference/domxml/functions/DomNode-previous-sibling.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.38 -->
   <refentry id='function.DomNode-previous-sibling'>
    <refnamediv>
@@ -15,7 +15,10 @@
      <void/>
     </methodsynopsis>
     <para>
-     This function returns the previous sibling of the current node.
+     This function returns the previous sibling of the current node. If there 
+     is no previous sibling it returns false (&lt; 4.3) or null (&gt= 4.3). You 
+     can use this function to iterate over all children of a node as shown in 
+     the example.
     </para>
     <para>
      See also <function>DomNode_next_sibling</function>.