diff --git a/src/corelib/tools/qcontainerfwd.h b/src/corelib/tools/qcontainerfwd.h
index 46c2801b000..575cd1def99 100644
--- a/src/corelib/tools/qcontainerfwd.h
+++ b/src/corelib/tools/qcontainerfwd.h
@@ -61,8 +61,13 @@ template <class T> class QStack;
 template<class T, qsizetype Prealloc = 256> class QVarLengthArray;
 template <class T> class QList;
 template<typename T> using QVector = QList<T>;
+#ifndef Q_CLANG_QDOC
 using QStringList = QList<QString>;
 using QByteArrayList = QList<QByteArray>;
+#else
+class QStringList;
+class QByteArrayList;
+#endif
 class QMetaType;
 class QVariant;
 
diff --git a/src/corelib/tools/qlist.h b/src/corelib/tools/qlist.h
index 5bdc993b670..3f621e71fb9 100644
--- a/src/corelib/tools/qlist.h
+++ b/src/corelib/tools/qlist.h
@@ -302,9 +302,15 @@ public:
 
     QList<T> &fill(parameter_type t, qsizetype size = -1);
 
+#ifndef Q_QDOC
     using QListSpecialMethods<T>::contains;
     using QListSpecialMethods<T>::indexOf;
     using QListSpecialMethods<T>::lastIndexOf;
+#else
+    qsizetype indexOf(const T &t, qsizetype from = 0) const noexcept;
+    qsizetype lastIndexOf(const T &t, qsizetype from = -1) const noexcept;
+    bool contains(const T &t) const noexcept;
+#endif
 
     qsizetype count(const T &t) const noexcept
     {