1CMP0110
2-------
3
4.. versionadded:: 3.19
5
6:command:`add_test` supports arbitrary characters in test names.
7
8:command:`add_test` can now (officially) create tests with whitespace and
9other special characters in its name.  Before CMake version 3.19 that was not
10allowed, however, it was possible to work around this limitation by explicitly
11putting escaped quotes around the test's name in the ``add_test`` command.
12
13Although never officially supported several projects in the wild found and
14implemented this workaround.  However, the new change which officially allows
15the ``add_test`` command to support whitespace and other special characters in
16test names now breaks that workaround.  In order for these projects to work
17smoothly with newer CMake versions, this policy was introduced.
18
19The ``OLD`` behavior of this policy is to still prevent ``add_test`` from
20handling whitespace and special characters properly (if not using the
21mentioned workaround).  The ``NEW`` behavior on the other hand allows names
22with whitespace and special characters for tests created by ``add_test``.
23
24This policy was introduced in CMake version 3.19.  CMake version |release|
25warns when the policy is not set and uses ``OLD`` behavior. Use the
26:command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
27