dilim/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-08-09 01:01:12 +00: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>`` ``LIST_SEPARATOR <sep>``
For any of the various ``..._COMMAND`` options, and ``CMAKE_ARGS``, For any of the various ``..._COMMAND`` options, and ``CMAKE_ARGS``,
replace ``;`` with ``<sep>`` in the specified command lines. ``ExternalProject`` will replace ``<sep>`` with ``;`` in the specified
This can be useful where list variables may be given in commands where command lines. This can be used to ensure a command has a literal ``;`` in it
they should end up as space-separated arguments (``<sep>`` would be a where direct usage would otherwise be interpreted as argument separators to
single space character string in this case). Note that the separator should CMake APIs instead. Note that the separator should be chosen to avoid being
be chosen to avoid being confused for non-list-separator usages of the confused for non-list-separator usages of the sequence. For example, using
sequence. For example, using ``LIST_SEPARATOR`` allows for passing list ``LIST_SEPARATOR`` allows for passing list values to CMake cache variables on
values to CMake cache variables on the command line: the command line:
.. code-block:: cmake .. code-block:: cmake