diff --git a/src/corelib/tools/qlist.qdoc b/src/corelib/tools/qlist.qdoc
index b1b8ef6eed9..48822d31e3d 100644
--- a/src/corelib/tools/qlist.qdoc
+++ b/src/corelib/tools/qlist.qdoc
@@ -908,6 +908,15 @@
     \since 5.6
 
     Moves the item at index position \a from to index position \a to.
+
+    \c from and \c to must be within bounds.
+
+    For example, to move the first item to the end of the list:
+    \code
+    QList<int> list = {1, 2, 3};
+    list.move(0, list.size() - 1);
+    qDebug() << list; // Prints "QList(2, 3, 1)"
+    \endcode
 */
 
 /*! \fn template <typename T> void QList<T>::removeFirst()