--- a/src/xmlpatterns/api/qxmlresultitems.cpp	Mon May 03 13:17:34 2010 +0300
+++ b/src/xmlpatterns/api/qxmlresultitems.cpp	Fri May 14 16:40:13 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
  */