Add docs to clarify and restrict what the LayoutChangeHint means.

Change-Id: I1b786c5151bcce253b6afa1eebc85e864ed7e91f
Reviewed-by: David Faure <david.faure@kdab.com>

diff --git a/src/corelib/itemmodels/qabstractitemmodel.cpp b/src/corelib/itemmodels/qabstractitemmodel.cpp
index 9fc6871..7e4c664 100644 (file)
--- a/src/corelib/itemmodels/qabstractitemmodel.cpp
+++ b/src/corelib/itemmodels/qabstractitemmodel.cpp
@@ -1331,6 +1331,10 @@ void QAbstractItemModelPrivate::columnsRemoved(const QModelIndex &parent,
     \value NoLayoutChangeHint   No hint is available.
     \value VerticalSortHint     Rows are being sorted.
     \value HorizontalSortHint   Columns are being sorted.
+
+    Note that VerticalSortHint and HorizontalSortHint carry the meaning that
+    items are being moved within the same parent, not moved to a different
+    parent in the model, and not filtered out or in.
 */
 
 /*!