diff -r cc75c76972ee -r c0432d11811c src/xmlpatterns/api/qxmlresultitems.cpp
--- a/src/xmlpatterns/api/qxmlresultitems.cpp	Wed Apr 21 12:15:23 2010 +0300
+++ b/src/xmlpatterns/api/qxmlresultitems.cpp	Wed Apr 21 20:15:53 2010 +0300
@@ -70,6 +70,10 @@
   sequence and returns it, and current() always returns the QXmlItem
   that next() returned the last time it was called.
 
+  \note When using the QXmlResultItems overload of QXmlQuery::evaluateTo()
+  to execute a query, it is advisable to create a new instance of this
+  class for each new set of results rather than reusing an old instance.
+
   \sa QXmlItem::isNode(), QXmlItem::isAtomicValue(), QXmlNodeModelIndex
  */