mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-01-06 05:40:54 -06:00
Code Issues Packages Projects Releases Wiki Activity

ExternalProject: reword LIST_SEPARATOR to indicate what it *does*

Browse Source 
Also remove the (IMO) confusing suggestion to have ` ` as a separator as
it interferes with things like spaces in argument values (e.g., paths)
or generated arguments such as `-GUnix Makefiles`. The new example is
likely more common usage of the facility.
This commit is contained in:
Ben Boeckel
2024-03-27 06:59:44 -04:00
parent 611ffce98c
commit 5d33f41e23
1 changed files with 7 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
Modules/ExternalProject.cmake
View File

@@ -906,13 +906,13 @@ Miscellaneous Options
``LIST_SEPARATOR <sep>``
For any of the various ``..._COMMAND`` options, and ``CMAKE_ARGS``,
replace ``;`` with ``<sep>`` in the specified command lines.
This can be useful where list variables may be given in commands where
they should end up as space-separated arguments (``<sep>`` would be a
single space character string in this case). Note that the separator should
be chosen to avoid being confused for non-list-separator usages of the
sequence. For example, using ``LIST_SEPARATOR`` allows for passing list
values to CMake cache variables on the command line:
``ExternalProject`` will replace ``<sep>`` with ``;`` in the specified
command lines. This can be used to ensure a command has a literal ``;`` in it
where direct usage would otherwise be interpreted as argument separators to
CMake APIs instead. Note that the separator should be chosen to avoid being
confused for non-list-separator usages of the sequence. For example, using
``LIST_SEPARATOR`` allows for passing list values to CMake cache variables on
the command line:
.. code-block:: cmake