From 78c677376a59b5ac59a7dcad18bbe0542ff66db9 Mon Sep 17 00:00:00 2001
From: Ivan Solovev <ivan.solovev@qt.io>
Date: Tue, 7 Jun 2022 08:51:47 +0200
Subject: [PATCH] QTestLib: improve documentation

Add missing '\since' version numbers.

This commit amends cc6d984390dc937b9d8440b6ba7d4f578e22ac0d
and 0681a2dd5a8095baddb5905fb21a58ce19b958c5

Pick-to: 6.4
Change-Id: Ia10b991c996fb58f08a17e485c4dfcbfbe8eba0a
Reviewed-by: Marc Mutz <marc.mutz@qt.io>
Reviewed-by: Edward Welbourne <edward.welbourne@qt.io>
---
 src/testlib/qtestcase.cpp  |  2 ++
 src/testlib/qtestcase.qdoc | 12 ++++++++++++
 2 files changed, 14 insertions(+)

diff --git a/src/testlib/qtestcase.cpp b/src/testlib/qtestcase.cpp
index 644bc9116bb..d69bd9d3d18 100644
--- a/src/testlib/qtestcase.cpp
+++ b/src/testlib/qtestcase.cpp
@@ -2950,6 +2950,7 @@ bool QTest::compare_helper(bool success, const char *failureMsg,
 #endif // QT_DEPRECATED_SINCE(6, 4)
 
 /*! \internal
+    \since 6.4
     This function is called by various specializations of QTest::qCompare
     to decide whether to report a failure and to produce verbose test output.
 
@@ -2973,6 +2974,7 @@ bool QTest::compare_helper(bool success, const char *failureMsg,
 }
 
 /*! \internal
+    \since 6.4
     This function is called by various specializations of QTest::qCompare
     to decide whether to report a failure and to produce verbose test output.
 
diff --git a/src/testlib/qtestcase.qdoc b/src/testlib/qtestcase.qdoc
index d7356471240..5ab493a2fc1 100644
--- a/src/testlib/qtestcase.qdoc
+++ b/src/testlib/qtestcase.qdoc
@@ -456,6 +456,7 @@
 */
 
 /*! \macro QTRY_COMPARE_EQ_WITH_TIMEOUT(left, right, timeout)
+    \since 6.4
     \relates QTest
 
     This macro is similar to QCOMPARE_EQ(), but performs the comparison of the
@@ -470,6 +471,7 @@
 */
 
 /*! \macro QTRY_COMPARE_EQ(left, right)
+    \since 6.4
     \relates QTest
 
     Performs comparison of \a left and \a right values by invoking
@@ -481,6 +483,7 @@
 */
 
 /*! \macro QTRY_COMPARE_NE_WITH_TIMEOUT(left, right, timeout)
+    \since 6.4
     \relates QTest
 
     This macro is similar to QCOMPARE_NE(), but performs the comparison of the
@@ -495,6 +498,7 @@
 */
 
 /*! \macro QTRY_COMPARE_NE(left, right)
+    \since 6.4
     \relates QTest
 
     Performs comparison of \a left and \a right values by invoking
@@ -506,6 +510,7 @@
 */
 
 /*! \macro QTRY_COMPARE_LT_WITH_TIMEOUT(left, right, timeout)
+    \since 6.4
     \relates QTest
 
     This macro is similar to QCOMPARE_LT(), but performs the comparison of the
@@ -520,6 +525,7 @@
 */
 
 /*! \macro QTRY_COMPARE_LT(left, right)
+    \since 6.4
     \relates QTest
 
     Performs comparison of \a left and \a right values by invoking
@@ -531,6 +537,7 @@
 */
 
 /*! \macro QTRY_COMPARE_LE_WITH_TIMEOUT(left, right, timeout)
+    \since 6.4
     \relates QTest
 
     This macro is similar to QCOMPARE_LE(), but performs the comparison of the
@@ -545,6 +552,7 @@
 */
 
 /*! \macro QTRY_COMPARE_LE(left, right)
+    \since 6.4
     \relates QTest
 
     Performs comparison of \a left and \a right values by invoking
@@ -556,6 +564,7 @@
 */
 
 /*! \macro QTRY_COMPARE_GT_WITH_TIMEOUT(left, right, timeout)
+    \since 6.4
     \relates QTest
 
     This macro is similar to QCOMPARE_GT(), but performs the comparison of the
@@ -570,6 +579,7 @@
 */
 
 /*! \macro QTRY_COMPARE_GT(left, right)
+    \since 6.4
     \relates QTest
 
     Performs comparison of \a left and \a right values by invoking
@@ -581,6 +591,7 @@
 */
 
 /*! \macro QTRY_COMPARE_GE_WITH_TIMEOUT(left, right, timeout)
+    \since 6.4
     \relates QTest
 
     This macro is similar to QCOMPARE_GE(), but performs the comparison of the
@@ -595,6 +606,7 @@
 */
 
 /*! \macro QTRY_COMPARE_GE(left, right)
+    \since 6.4
     \relates QTest
 
     Performs comparison of \a left and \a right values by invoking