[docs] QList: fix history of clear() semantics change

The description was copied from QVector, and doesn't exactly fit
QList. For QList, the behavior changed in Qt 6.0 when QList became
QVector, not in Qt 5.7, as indicated.

Be more precise.

Change-Id: I4029d83128ec205f628125d78394e8ee79cc221f
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
(cherry picked from commit 13293d3308c04d22bc2928e8991f47744560e085)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
This commit is contained in:
Marc Mutz 2022-11-02 17:06:22 +01:00 committed by Qt Cherry-pick Bot
parent 83bf81fd73
commit 866301ca12

View File

@ -549,17 +549,14 @@
Removes all the elements from the list.
\note Until Qt 5.6, this also released the memory used by
the list. From Qt 5.7, the capacity is preserved. To shed
all capacity, swap with a default-constructed list:
\code
QList<T> l ...;
QList<T>().swap(l);
Q_ASSERT(l.capacity() == 0);
\endcode
or call squeeze().
If this list is not shared, the capacity() is preserved. Use squeeze() to
shed excess capacity.
\sa squeeze()
\note In Qt versions prior to 5.7 (for QVector) and 6.0 (for QList), this
function released the memory used by the list instead of preserving the
capacity.
\sa resize(), squeeze()
*/
/*! \fn template <typename T> const T &QList<T>::at(qsizetype i) const