From 13293d3308c04d22bc2928e8991f47744560e085 Mon Sep 17 00:00:00 2001 From: Marc Mutz Date: Wed, 2 Nov 2022 17:06:22 +0100 Subject: [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. Pick-to: 6.4 6.2 Change-Id: I4029d83128ec205f628125d78394e8ee79cc221f Reviewed-by: Thiago Macieira --- src/corelib/tools/qlist.qdoc | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) diff --git a/src/corelib/tools/qlist.qdoc b/src/corelib/tools/qlist.qdoc index e1c917bbc4..f3b501a0e9 100644 --- a/src/corelib/tools/qlist.qdoc +++ b/src/corelib/tools/qlist.qdoc @@ -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 l ...; - QList().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. + + \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 squeeze() + \sa resize(), squeeze() */ /*! \fn template const T &QList::at(qsizetype i) const -- cgit v1.2.3