mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-02-19 05:30:59 -06:00
Code Issues Packages Projects Releases Wiki Activity

Merge topic 'ExternalProject-list-separator-docs-example' into release-3.29

Browse Source 
5d33f41e23 ExternalProject: reword `LIST_SEPARATOR` to indicate what it *does*
611ffce98c ExternalProject: add an example of `LIST_SEPARATOR` usage

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !9376
This commit is contained in:
Brad King
2024-03-28 15:50:44 +00:00
committed by Kitware Robot
parent 9dc7d28f70 5d33f41e23
commit c5c524394e
1 changed files with 15 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
Modules/ExternalProject.cmake
View File

@@ -906,10 +906,21 @@ 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).
``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
ExternalProject_Add(example
... # Download options, etc.
LIST_SEPARATOR ","
CMAKE_ARGS "-DCMAKE_PREFIX_PATH:STRING=${first_prefix},${second_prefix}"
)
``COMMAND <cmd>...``
Any of the other ``..._COMMAND`` options can have additional commands