1 files changed, 150 insertions, 0 deletions
diff --git a/src/testlib/qtestcase.qdoc b/src/testlib/qtestcase.qdoc
index 171a0b906c..d735647124 100644
--- a/src/testlib/qtestcase.qdoc
+++ b/src/testlib/qtestcase.qdoc
@@ -455,6 +455,156 @@
    QEXPECT_FAIL()
 */
 
+/*! \macro QTRY_COMPARE_EQ_WITH_TIMEOUT(left, right, timeout)
+    \relates QTest
+
+    This macro is similar to QCOMPARE_EQ(), but performs the comparison of the
+    \a left and \a right values repeatedly, until either the comparison returns
+    \c true or the \a timeout (in milliseconds) is reached. Between each
+    comparison, events will be processed. If the timeout is reached, a failure
+    is recorded in the test log and the test won't be executed further.
+
+    \include qtestcase.qdoc macro-usage-limitation
+
+    \sa QCOMPARE_EQ(), QTRY_COMPARE_EQ()
+*/
+
+/*! \macro QTRY_COMPARE_EQ(left, right)
+    \relates QTest
+
+    Performs comparison of \a left and \a right values by invoking
+    QTRY_COMPARE_EQ_WITH_TIMEOUT with a timeout of five seconds.
+
+    \include qtestcase.qdoc macro-usage-limitation
+
+    \sa QCOMPARE_EQ(), QTRY_COMPARE_EQ_WITH_TIMEOUT()
+*/
+
+/*! \macro QTRY_COMPARE_NE_WITH_TIMEOUT(left, right, timeout)
+    \relates QTest
+
+    This macro is similar to QCOMPARE_NE(), but performs the comparison of the
+    \a left and \a right values repeatedly, until either the comparison returns
+    \c true or the \a timeout (in milliseconds) is reached. Between each
+    comparison, events will be processed. If the timeout is reached, a failure
+    is recorded in the test log and the test won't be executed further.
+
+    \include qtestcase.qdoc macro-usage-limitation
+
+    \sa QCOMPARE_NE(), QTRY_COMPARE_NE()
+*/
+
+/*! \macro QTRY_COMPARE_NE(left, right)
+    \relates QTest
+
+    Performs comparison of \a left and \a right values by invoking
+    QTRY_COMPARE_NE_WITH_TIMEOUT with a timeout of five seconds.
+
+    \include qtestcase.qdoc macro-usage-limitation
+
+    \sa QCOMPARE_NE(), QTRY_COMPARE_NE_WITH_TIMEOUT()
+*/
+
+/*! \macro QTRY_COMPARE_LT_WITH_TIMEOUT(left, right, timeout)
+    \relates QTest
+
+    This macro is similar to QCOMPARE_LT(), but performs the comparison of the
+    \a left and \a right values repeatedly, until either the comparison returns
+    \c true or the \a timeout (in milliseconds) is reached. Between each
+    comparison, events will be processed. If the timeout is reached, a failure
+    is recorded in the test log and the test won't be executed further.
+
+    \include qtestcase.qdoc macro-usage-limitation
+
+    \sa QCOMPARE_LT(), QTRY_COMPARE_LT()
+*/
+
+/*! \macro QTRY_COMPARE_LT(left, right)
+    \relates QTest
+
+    Performs comparison of \a left and \a right values by invoking
+    QTRY_COMPARE_LT_WITH_TIMEOUT with a timeout of five seconds.
+
+    \include qtestcase.qdoc macro-usage-limitation
+
+    \sa QCOMPARE_LT(), QTRY_COMPARE_LT_WITH_TIMEOUT()
+*/
+
+/*! \macro QTRY_COMPARE_LE_WITH_TIMEOUT(left, right, timeout)
+    \relates QTest
+
+    This macro is similar to QCOMPARE_LE(), but performs the comparison of the
+    \a left and \a right values repeatedly, until either the comparison returns
+    \c true or the \a timeout (in milliseconds) is reached. Between each
+    comparison, events will be processed. If the timeout is reached, a failure
+    is recorded in the test log and the test won't be executed further.
+
+    \include qtestcase.qdoc macro-usage-limitation
+
+    \sa QCOMPARE_LE(), QTRY_COMPARE_LE()
+*/
+
+/*! \macro QTRY_COMPARE_LE(left, right)
+    \relates QTest
+
+    Performs comparison of \a left and \a right values by invoking
+    QTRY_COMPARE_LE_WITH_TIMEOUT with a timeout of five seconds.
+
+    \include qtestcase.qdoc macro-usage-limitation
+
+    \sa QCOMPARE_LE(), QTRY_COMPARE_LE_WITH_TIMEOUT()
+*/
+
+/*! \macro QTRY_COMPARE_GT_WITH_TIMEOUT(left, right, timeout)
+    \relates QTest
+
+    This macro is similar to QCOMPARE_GT(), but performs the comparison of the
+    \a left and \a right values repeatedly, until either the comparison returns
+    \c true or the \a timeout (in milliseconds) is reached. Between each
+    comparison, events will be processed. If the timeout is reached, a failure
+    is recorded in the test log and the test won't be executed further.
+
+    \include qtestcase.qdoc macro-usage-limitation
+
+    \sa QCOMPARE_GT(), QTRY_COMPARE_GT()
+*/
+
+/*! \macro QTRY_COMPARE_GT(left, right)
+    \relates QTest
+
+    Performs comparison of \a left and \a right values by invoking
+    QTRY_COMPARE_GT_WITH_TIMEOUT with a timeout of five seconds.
+
+    \include qtestcase.qdoc macro-usage-limitation
+
+    \sa QCOMPARE_GT(), QTRY_COMPARE_GT_WITH_TIMEOUT()
+*/
+
+/*! \macro QTRY_COMPARE_GE_WITH_TIMEOUT(left, right, timeout)
+    \relates QTest
+
+    This macro is similar to QCOMPARE_GE(), but performs the comparison of the
+    \a left and \a right values repeatedly, until either the comparison returns
+    \c true or the \a timeout (in milliseconds) is reached. Between each
+    comparison, events will be processed. If the timeout is reached, a failure
+    is recorded in the test log and the test won't be executed further.
+
+    \include qtestcase.qdoc macro-usage-limitation
+
+    \sa QCOMPARE_GE(), QTRY_COMPARE_GE()
+*/
+
+/*! \macro QTRY_COMPARE_GE(left, right)
+    \relates QTest
+
+    Performs comparison of \a left and \a right values by invoking
+    QTRY_COMPARE_GE_WITH_TIMEOUT with a timeout of five seconds.
+
+    \include qtestcase.qdoc macro-usage-limitation
+
+    \sa QCOMPARE_GE(), QTRY_COMPARE_GE_WITH_TIMEOUT()
+*/
+
 /*! \macro QFETCH(type, name)
 
    \relates QTest