- added DomNode->append_sibling to function list

- some remarks about the new behaviour of DomNode->append_child


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@78341 c90b9560-bf6c-de11-be94-00142212c4b1

reference/domxml/functions.xml

@@ -31,6 +31,7 @@
 &reference.domxml.functions.DomElement-set-attribute-node;
 &reference.domxml.functions.DomElement-tagname;
 &reference.domxml.functions.DomNode-append-child;
+&reference.domxml.functions.DomNode-append-sibling;
 &reference.domxml.functions.DomNode-attributes;
 &reference.domxml.functions.DomNode-child-nodes;
 &reference.domxml.functions.DomNode-clone-node;

reference/domxml/reference.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
  <reference id="ref.domxml">
   <title>DOM XML functions</title>
   <titleabbrev>DOM XML</titleabbrev>
@@ -41,6 +41,14 @@
 
    <section id="domxml-deprecated">
     <title>Deprecated functions</title>
+    <para>
+     There a quite some functions which do not fit into the DOM standard and
+     should not be used anymore as listed in the following table.
+     The function <function>DomNode_append_child</function> has changed its
+     behaviour. It now actually adds a child and not a sibling. If this
+     breaks your application use the non DOM function
+     <function>DomNode_append_sibling</function>.
+    </para>
     <para>
     <table>
      <title>Deprecated functions and its replacements</title>
@@ -543,6 +551,11 @@
         <entry><function>DomNode_append_child</function></entry>
         <entry></entry>
        </row>
+       <row>
+        <entry><function>DomNode_append_sibling</function></entry>
+        <entry>Not in DOM standard. This function emulates the former
+         behaviour of <function>DomNode_append_child</function>.</entry>
+       </row>
        <row>
         <entry><function>DomNode_remove_child</function></entry>
         <entry></entry>