From cdde9e5a10f22caa925d5391f406c6eaf3333f70 Mon Sep 17 00:00:00 2001 From: Craig Scott Date: Sun, 25 Jul 2021 21:31:48 +1000 Subject: Help: Improve wording and cross-referencing for ctest JUnit output --- Help/command/ctest_test.rst | 6 +++--- Help/manual/ctest.1.rst | 6 ++++-- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/Help/command/ctest_test.rst b/Help/command/ctest_test.rst index 2104c47..89787d1 100644 --- a/Help/command/ctest_test.rst +++ b/Help/command/ctest_test.rst @@ -155,12 +155,12 @@ The options are: Store in the ```` variable -1 if there are any errors running the command and prevent ctest from returning non-zero if an error occurs. -``OUTPUT_JUNIT`` +``OUTPUT_JUNIT `` .. versionadded:: 3.21 Write test results to ```` in JUnit XML format. If ```` is a - relative path it will be placed in the build directory. If ``>`` - already exists it will be overwritten. Note that the resulting JUnit XML + relative path, it will be placed in the build directory. If ```` + already exists, it will be overwritten. Note that the resulting JUnit XML file is **not** uploaded to CDash because it would be redundant with CTest's ``Test.xml`` file. diff --git a/Help/manual/ctest.1.rst b/Help/manual/ctest.1.rst index ab819f9..03d8bf6 100644 --- a/Help/manual/ctest.1.rst +++ b/Help/manual/ctest.1.rst @@ -137,8 +137,10 @@ Options ``--output-junit `` Write test results in JUnit format. - This option tells CTest to write test results to a ```` JUnit XML file. - If ```` already exists it will be overwritten. + This option tells CTest to write test results to ```` in JUnit XML + format. If ```` already exists, it will be overwritten. If using the + ``-S`` option to run a dashboard script, use the ``OUTPUT_JUNIT`` keyword + with the :command:`ctest_test` command instead. ``-N,--show-only[=]`` Disable actual execution of tests. -- cgit v0.12