Bug #1494: Document that appendChild removes first.
diff --git a/Doc/library/xml.dom.rst b/Doc/library/xml.dom.rst
index d08eee6..5f0a9aa 100644
--- a/Doc/library/xml.dom.rst
+++ b/Doc/library/xml.dom.rst
@@ -372,8 +372,9 @@
.. 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)