diff --git a/src/corelib/serialization/qxmlstream.cpp b/src/corelib/serialization/qxmlstream.cpp
index d7fb0d0d41..3e42a58bbe 100644
--- a/src/corelib/serialization/qxmlstream.cpp
+++ b/src/corelib/serialization/qxmlstream.cpp
@@ -263,12 +263,10 @@ QXmlStreamEntityResolver *QXmlStreamReader::entityResolver() const
 
   \ingroup xml-tools
 
-  QXmlStreamReader is a faster and more convenient replacement for
-  Qt's own SAX parser (see QXmlSimpleReader). In some cases it might
-  also be a faster and more convenient alternative for use in
-  applications that would otherwise use a DOM tree (see QDomDocument).
-  QXmlStreamReader reads data either from a QIODevice (see
-  setDevice()), or from a raw QByteArray (see addData()).
+  QXmlStreamReader provides a simple streaming API to parse well-formed
+  XML. It is an alternative to first loading the complete XML into a
+  DOM tree (see \l QDomDocument). QXmlStreamReader reads data either
+  from a QIODevice (see setDevice()), or from a raw QByteArray (see addData()).
 
   Qt provides QXmlStreamWriter for writing XML.