diff -r 3b1da2848fc7 -r d3bac044e0f0 src/xml/dom/qdom.cpp
--- a/src/xml/dom/qdom.cpp	Fri Feb 19 23:40:16 2010 +0200
+++ b/src/xml/dom/qdom.cpp	Fri Mar 12 15:46:37 2010 +0200
@@ -2596,11 +2596,15 @@
     already has an element node as a child, \a newChild is not added as
     a child and a null node is returned.
 
-    Calling this function on a null node(created, for example, with the
-    default constructor) does nothing.
-
-    The DOM specification disallow inserting attribute nodes, but due
-    to historical reasons QDom accept them nevertheless.
+    Returns a new reference to \a newChild on success or a \link
+    isNull() null node\endlink on failure.
+
+    Calling this function on a null node(created, for example, with
+    the default constructor) does nothing and returns a \link isNull()
+    null node\endlink.
+
+    The DOM specification disallow inserting attribute nodes, but for
+    historical reasons, QDom accepts them anyway.
 
     \sa insertBefore() insertAfter() replaceChild() removeChild()
 */
@@ -2969,7 +2973,7 @@
 }
 
 /*!
-    Returns the next sibilng element with tag name \a tagName if \a tagName
+    Returns the next sibling element with tag name \a tagName if \a tagName
     is non-empty; otherwise returns any next sibling element.
     Returns a null element if no such sibling exists.