1 files changed, 15 insertions, 31 deletions

diff --git a/src/qmltest/doc/src/qtquicktest-index.qdoc b/src/qmltest/doc/src/qtquicktest-index.qdoc
index 4fad21e080..a7a840f2b3 100644
--- a/src/qmltest/doc/src/qtquicktest-index.qdoc
+++ b/src/qmltest/doc/src/qtquicktest-index.qdoc
@@ -30,6 +30,7 @@
     \title Qt Quick Test
     \brief Unit testing framework for QML.
 
+    \target Introduction to Qt Quick Test
     \section1 Introduction
 
     \l {Qt Quick Test QML Types}{Qt Quick Test} is a unit test framework for QML applications.
@@ -62,15 +63,13 @@
           only guaranteed to work with the Qt version it was developed against.
           However, source compatibility is guaranteed.
 
+    \target Running Qt Quick Tests
     \section1 Running Tests
 
     Test cases are launched by a C++ harness that consists of
     the following code:
 
-    \code
-    #include <QtQuickTest/quicktest.h>
-    QUICK_TEST_MAIN(example)
-    \endcode
+    \snippet src_qmltest_qquicktest.cpp 1
 
     Where "example" is the identifier to use to uniquely identify
     this set of tests. Finally, add \c{CONFIG += qmltestcase} to the project
@@ -139,7 +138,7 @@
     \section1 Executing C++ Before QML Tests
 
     To execute C++ code before any of the QML tests are run, the
-    \c QUICK_TEST_MAIN_WITH_SETUP macro can be used. This can be useful for
+    \l QUICK_TEST_MAIN_WITH_SETUP macro can be used. This can be useful for
     setting context properties on the QML engine, amongst other things.
 
     The macro is identical to \c QUICK_TEST_MAIN, except that it takes an
@@ -152,13 +151,13 @@
             \li Purpose
             \li Since
         \row
-            \li void applicationAvailable()
+            \li \c {void applicationAvailable()}
             \li Called right after the QApplication object was instantiated.
                 Use this function to perform setup that does not require a
                 \l QQmlEngine instance.
             \li Qt 5.12
         \row
-            \li void qmlEngineAvailable(QQmlEngine*)
+            \li \c {void qmlEngineAvailable(QQmlEngine *)}
             \li Called when the QML engine is available.
                 Any \l {QQmlEngine::addImportPath}{import paths},
                 \l {QQmlEngine::addPluginPath}{plugin paths},
@@ -175,7 +174,7 @@
                 amongst other things.
             \li Qt 5.11
         \row
-            \li void cleanupTestCase()
+            \li \c {void cleanupTestCase()}
             \li Called right after the test execution has finished.
                 Use this function to clean up before everything will start to be destructed.
             \li Qt 5.12
@@ -184,29 +183,7 @@
     The following example demonstrates how the macro can be used to set context
     properties on the QML engine:
 
-    \code
-    #include <QtQuickTest>
-    #include <QQmlEngine>
-    #include <QQmlContext>
-
-    class Setup : public QObject
-    {
-        Q_OBJECT
-
-    public:
-        Setup() {}
-
-    public slots:
-        void qmlEngineAvailable(QQmlEngine *engine)
-        {
-            engine->rootContext()->setContextProperty("myContextProperty", QVariant(true));
-        }
-    };
-
-    QUICK_TEST_MAIN_WITH_SETUP(mytest, Setup)
-
-    #include "tst_mytest.moc"
-    \endcode
+    \snippet src_qmltest_qquicktest.cpp 2
 
     The \c .moc include is based on the file name of the \c .cpp file.
     For example, in the example above, the \c .cpp file is named
@@ -217,6 +194,13 @@
     #include "MyTest.moc"
     \endcode
 
+    \section1 Reference
+
+    \list
+      \li \l{Qt Quick Test QML Types}{QML Types}
+      \li \l{Qt Quick Test C++ API}{C++ API}
+    \endlist
+
     \section1 Licenses
 
     Qt Quick Tests is available under commercial licenses from \l{The Qt Company}.