1 files changed, 30 insertions, 9 deletions
diff --git a/src/corelib/itemmodels/qrangemodeladapter.qdoc b/src/corelib/itemmodels/qrangemodeladapter.qdoc
index 5ab128a8c5f..ff595529d34 100644
--- a/src/corelib/itemmodels/qrangemodeladapter.qdoc
+++ b/src/corelib/itemmodels/qrangemodeladapter.qdoc
@@ -118,11 +118,9 @@
     would bypass the QAbstractItemModel notification protocol, those reference
     objects prevent direct modifications of the items.
 
-    \note Calling mutable overloads generates some overhead. Make a const copy
-    of the adapter (which will not copy the data), or use \c{std::as_const} to
-    make sure that only the const overloads are used in performance critical,
-    read-heavy code. This is the same technique as when accessing elements in
-    an implicitly shared Qt container.
+    \note Accessing the reference object always makes a call to the model to get
+    a copy of the value. This can be expensive; for performance critical access
+    to data, store a copy.
 
     \section3 Item access
 
@@ -331,16 +329,39 @@
 
 /*!
     \fn template <typename Range, typename Protocol, typename Model> template <typename NewRange, QRangeModelAdapter<Range, Protocol, Model>::if_assignable_range<NewRange>> void QRangeModelAdapter<Range, Protocol, Model>::setRange(NewRange &&newRange)
-    \fn template <typename Range, typename Protocol, typename Model> template <typename NewRange, QRangeModelAdapter<Range, Protocol, Model>::if_assignable_range<NewRange>> QRangeModelAdapter &QRangeModelAdapter<Range, Protocol, Model>::operator=(NewRange &&newRange)
+    \fn template <typename Range, typename Protocol, typename Model> template <typename NewRange, QRangeModelAdapter<Range, Protocol, Model>::if_assignable_range<NewRange>, QRangeModelAdapter<Range, Protocol, Model>::unless_adapter<NewRange>> QRangeModelAdapter &QRangeModelAdapter<Range, Protocol, Model>::operator=(NewRange &&newRange)
+
+    Replaces the contents of the model with the rows in \a newRange, possibly
+    using move semantics.
 
-    Assigns \a newRange to the stored range, possibly using move semantics.
     This function makes the model() emit the \l{QAbstractItemModel::}{modelAboutToBeReset()}
     and \l{QAbstractItemModel::}{modelReset()} signals.
 
     \constraints \c Range is mutable, and \a newRange is of a type that can be
-                 assigned to \c Range.
+                 assigned to \c Range, but not a QRangeModelAdapter.
+
+    \sa range(), at(), model(), assign()
+*/
+
+/*!
+    \fn template <typename Range, typename Protocol, typename Model> template <typename Row, QRangeModelAdapter<Range, Protocol, Model>::if_assignable_range<std::initializer_list<Row>>> void QRangeModelAdapter<Range, Protocol, Model>::setRange(std::initializer_list<Row> newRange)
+    \fn template <typename Range, typename Protocol, typename Model> template <typename Row, QRangeModelAdapter<Range, Protocol, Model>::if_assignable_range<std::initializer_list<Row>>> QRangeModelAdapter &QRangeModelAdapter<Range, Protocol, Model>::assign(std::initializer_list<Row> newRange)
+    \fn template <typename Range, typename Protocol, typename Model> template <typename Row, QRangeModelAdapter<Range, Protocol, Model>::if_assignable_range<std::initializer_list<Row>>> QRangeModelAdapter &QRangeModelAdapter<Range, Protocol, Model>::operator=(std::initializer_list<Row> newRange)
+
+    Replaces the contents of the model with the rows in \a newRange.
+
+    \constraints \c Range is mutable, and \a newRange can be assigned to \c Range.
+
+    \sa range(), at, model()
+*/
+
+/*!
+    \fn template <typename Range, typename Protocol, typename Model> template <typename InputIterator, typename Sentinel, typename I = Impl, QRangeModelAdapter<Range, Protocol, Model>::if_writable<I>> void QRangeModelAdapter<Range, Protocol, Model>::setRange(InputIterator first, Sentinel last)
+    \fn template <typename Range, typename Protocol, typename Model> template <typename InputIterator, typename Sentinel, typename I = Impl, QRangeModelAdapter<Range, Protocol, Model>::if_writable<I>> void QRangeModelAdapter<Range, Protocol, Model>::assign(InputIterator first, Sentinel last)
+
+    Replaces the contents of the models with the rows in the range [\a first, \a last).
 
-    \sa range(), at(), model()
+    \sa range(), at, model()
 */
 
 /*!