Doc: Describe new testing preferences

- Timeout can now be turned off and on
- Limit Files to Path Patterns adds filters for scanning
  for tests

Task-number: QTCREATORBUG-30604
Change-Id: Ia0ab109c2dd2958804fea6f6faa1eb9a80377fe3
Reviewed-by: Christian Stenger <christian.stenger@qt.io>

dist/changelog/changes-14.0.0.md

@@ -246,10 +246,12 @@ Version Control Systems
 Test Integration
 ----------------
 
-* Made the test timeout optional
+* Made the test timeout optional in `Preferences` > `Testing` > `General`
   ([QTCREATORBUG-30668](https://bugreports.qt.io/browse/QTCREATORBUG-30668))
-* Added a project specific option `Limit Files to Path Patterns` for restricting
-  the search for tests
+  ([Documentation](https://doc-snapshots.qt.io/qtcreator-14.0/creator-preferences-testing.html))
+* Added the project specific `Limit Files to Path Patterns` option in `Projects` >
+  `Project Settings` > `Testing` for restricting the search for tests
+  ([Documentation](https://doc-snapshots.qt.io/qtcreator-14.0/creator-how-to-limit-files-to-path-patterns.html))
 
 ### Qt Test
 

doc/qtcreator/src/howto/creator-only/creator-autotest.qdoc

@@ -515,7 +515,7 @@
             By default, \QC groups tests that are in the same directory.
     \endtable
 
-    To select the testing framework for the current project, go to
+    To override some preferences for the current project, go to
     \uicontrol Projects > \uicontrol {Project Settings} > \uicontrol {Testing}.
 
     \section1 Qt Tests
@@ -715,7 +715,7 @@
         \li Disable statistical analysis and bootstrapping.
     \endtable
 
-    \section2 Specifying Settings for Running CTest-Based Tests
+    \section1 CTest-Based Tests
 
     To specify settings for running CTest-based tests, go to \preferences >
     \uicontrol {Testing} > \uicontrol {CTest}.

doc/qtcreator/src/projects/creator-only/creator-projects-settings-overview.qdoc

@@ -96,7 +96,7 @@
                 \li \l{Link projects with GitLab}{GitLab}
                 \li \l{Configure language server workspace}{Language Server}
                 \li \l{Specify settings for quick fixes}{Quick Fixes}
-                \li \l{Testing}
+                \li \l{Apply filters before scanning for tests}{Testing}
                 \li \l{Exclude files from to-do lists}{To-Do} (experimental)
             \endlist
 

doc/qtcreator/src/projects/creator-only/creator-testing-how-to-limit-files-to-path-patterns.qdoc

@@ -0,0 +1,32 @@
+// Copyright (C) 2024 The Qt Company Ltd.
+// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
+
+/*!
+    \page creator-how-to-limit-files-to-path-patterns.html
+    \previouspage creator-how-tos.html
+
+    \ingroup creator-how-to-test
+    \ingroup creator-how-to-projects-configure
+
+    \title Apply filters before scanning for tests
+
+    To override testing preferences for the current project:
+
+    \list 1
+        \li Go to \uicontrol Projects > \uicontrol {Project Settings} >
+            \uicontrol {Testing}.
+            \image qtcreator-projects-settings-testing.webp {Testing settings in Projects mode}
+        \li Clear \uicontrol {Use global settings} to select the tests to handle
+            for the project.
+        \li To automatically run all or selected tests after successfully
+            building the current project, select \uicontrol All or
+            \uicontrol Selected in \uicontrol {Automatically run tests after build}.
+        \li To apply path filters before scanning for tests, select
+            \uicontrol {Limit Files to Path Patterns}.
+        \li Select \uicontrol Add to add the filters as wildcard expressions.
+    \endlist
+
+    To remove the selected filter, select \uicontrol Remove.
+
+    \sa {Test}{How To: Test}, {Test Results}, {Testing}
+*/