From b7f83c37a4aee059d70650fba673ab001bd3c47e Mon Sep 17 00:00:00 2001
From: Daniel Pfeifer <daniel@pfeifer-mail.de>
Date: Mon, 23 Mar 2026 22:17:07 +0100
Subject: [PATCH] create_test_sourcelist: Document command line arguments

---
 Help/command/create_test_sourcelist.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/Help/command/create_test_sourcelist.rst b/Help/command/create_test_sourcelist.rst
index d0b43c466b..92b8193254 100644
--- a/Help/command/create_test_sourcelist.rst
+++ b/Help/command/create_test_sourcelist.rst
@@ -60,3 +60,20 @@ Additionally, some CMake variables affect test driver generation:
 .. variable:: CMAKE_TESTDRIVER_AFTER_TESTMAIN
 
   Code to be placed directly after the call to each test's function.
+
+The generated test driver supports the following command-line arguments:
+
+``<name>``
+  Run the test with the exact name ``<name>`` (case-insensitive).
+
+``-R <substr>``
+  Run the first test whose name contains ``<substr>`` (case-insensitive).
+
+``-A [<skip_test>...]``
+  .. versionadded:: 3.21
+
+    Run all tests and print results in `TAP <https://testanything.org/>`_
+    format.
+
+    Any additional arguments after ``-A`` are interpreted as exact test names
+    to skip.