From c508030c4a75c01939382dbbab221be1076ea0f7 Mon Sep 17 00:00:00 2001
From: Markku Heikkila <markku.heikkila@digia.com>
Date: Tue, 26 Jun 2012 13:05:17 +0300
Subject: 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>
---
 src/widgets/itemviews/qstandarditemmodel.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/widgets/itemviews/qstandarditemmodel.cpp b/src/widgets/itemviews/qstandarditemmodel.cpp
index 17a7341b7c..45ffa249e5 100644
--- 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
 {
-- 
cgit v1.2.3