Bug #1494: Document that appendChild removes first.

diff --git a/Doc/library/xml.dom.rst b/Doc/library/xml.dom.rst
index d08eee60a2a6545359396f83190d3cb5513e5c95..5f0a9aa7e30daf97ce2071cc84e5c6596c30abc4 100644 (file)
--- a/Doc/library/xml.dom.rst
+++ b/Doc/library/xml.dom.rst
@@ -372,8 +372,9 @@ All of the components of an XML document are subclasses of :class:`Node`.
 
 .. method:: Node.appendChild(newChild)
 
-   Add a new child node to this node at the end of the list of children, returning
-   *newChild*.
+   Add a new child node to this node at the end of the list of
+   children, returning *newChild*. If the node was already in
+   in the tree, it is removed first.
 
 
 .. method:: Node.insertBefore(newChild, refChild)