Clarified documentation for QStandardItem::parent()

Task-number: QTBUG-18785

Change-Id: I91ee8c3dc10c1484376a17e3f13794038d4a648f
Reviewed-by: Stephen Kelly <stephen.kelly@kdab.com>
Reviewed-by: Girish Ramakrishnan <girish.1.ramakrishnan@nokia.com>

diff --git a/src/widgets/itemviews/qstandarditemmodel.cpp b/src/widgets/itemviews/qstandarditemmodel.cpp
index 17a7341..45ffa24 100644 (file)
--- a/src/widgets/itemviews/qstandarditemmodel.cpp
+++ b/src/widgets/itemviews/qstandarditemmodel.cpp
@@ -782,8 +782,10 @@ QStandardItem::~QStandardItem()
 
 /*!
   Returns the item's parent item, or 0 if the item has no parent.
+  \note For toplevel items parent() returns 0. To receive toplevel
+  item's parent use QStandardItemModel::invisibleRootItem() instead.
 
-  \sa child()
+  \sa child(), QStandardItemModel::invisibleRootItem()
 */
 QStandardItem *QStandardItem::parent() const
 {