diff options
| author | Deniz Bahadir <dbahadir@benocs.com> | 2020-05-15 23:52:34 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2020-08-12 14:44:07 (GMT) |
| commit | a20987732bbd8d7e86501e42b2b5a72d60d02805 (patch) | |
| tree | 89f416b8548c649d89e7d1108cc0905058a43ff0 /Help/policy | |
| parent | d6ee9b4a43210553b8f4d3a11413f744e2affb26 (diff) | |
| download | CMake-a20987732bbd8d7e86501e42b2b5a72d60d02805.zip CMake-a20987732bbd8d7e86501e42b2b5a72d60d02805.tar.gz CMake-a20987732bbd8d7e86501e42b2b5a72d60d02805.tar.bz2 | |
add_test: Allow special characters in test name (w/ policy CMP0110)
Restore the change from commit f84af8e270 (add_test: Allow special
characters in test name, 2020-05-16, v3.18.0-rc1~142^2) that had to be
reverted by commit f84af8e270 (add_test: Allow special characters in
test name, 2020-05-16, v3.18.0-rc1~142^2) for compatibility.
Add policy CMP0110 to make the change in a compatible way.
Also, support even more characters than before by generating the
test scripts using bracket arguments around the test names.
Fixes: #19391
Signed-off-by: Deniz Bahadir <dbahadir@benocs.com>
Diffstat (limited to 'Help/policy')
| -rw-r--r-- | Help/policy/CMP0110.rst | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/Help/policy/CMP0110.rst b/Help/policy/CMP0110.rst new file mode 100644 index 0000000..bc198aa --- /dev/null +++ b/Help/policy/CMP0110.rst @@ -0,0 +1,24 @@ +CMP0110 +------- + +:command:`add_test` supports arbitrary characters in test names. + +:command:`add_test` can now (officially) create tests with whitespace and +other special characters in its name. Before CMake version 3.19 that was not +allowed, however, it was possible to work around this limitation by explicitly +putting escaped quotes arount the test's name in the ``add_test`` command. + +Although never officially supported several projects in the wild found and +implemented this workaround. However, the new change which officially allows +the ``add_test`` command to support whitespace and other special characters in +test names now breaks that workaround. In order for these projects to work +smoothly with newer CMake versions, this policy was introduced. + +The ``OLD`` behavior of this policy is to still prevent ``add_test`` from +handling whitespace and special characters properly (if not using the +mentioned workaround). The ``NEW`` behavior on the other hand allows names +with whitespace and special characters for tests created by ``add_test``. + +This policy was introduced in CMake version 3.19. CMake version |release| +warns when the policy is not set and uses ``OLD`` behavior. Use the +:command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly. |