diff --git a/reference/domxml/functions.xml b/reference/domxml/functions.xml
index 326fbde763..ff837178ea 100644
--- a/reference/domxml/functions.xml
+++ b/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;
diff --git a/reference/domxml/reference.xml b/reference/domxml/reference.xml
index 790e93060d..f3b3d9169d 100644
--- a/reference/domxml/reference.xml
+++ b/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>