diff -r 41300fa6a67c -r 2f34d5167611 src/xml/dom/qdom.cpp --- a/src/xml/dom/qdom.cpp Tue Feb 02 00:43:10 2010 +0200 +++ b/src/xml/dom/qdom.cpp Fri Apr 16 15:50:13 2010 +0300 @@ -1,6 +1,6 @@ /**************************************************************************** ** -** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). +** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). ** All rights reserved. ** Contact: Nokia Corporation (qt-info@nokia.com) ** @@ -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.