ExternalProject: add an example of LIST_SEPARATOR usage

This commit is contained in:
Ben Boeckel
2024-03-27 06:43:15 -04:00
parent d26526a36f
commit 611ffce98c

View File

@@ -909,7 +909,18 @@ Miscellaneous Options
replace ``;`` with ``<sep>`` in the specified command lines. replace ``;`` with ``<sep>`` in the specified command lines.
This can be useful where list variables may be given in commands where 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 they should end up as space-separated arguments (``<sep>`` would be a
single space character string in this case). 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:
.. code-block:: cmake
ExternalProject_Add(example
... # Download options, etc.
LIST_SEPARATOR ","
CMAKE_ARGS "-DCMAKE_PREFIX_PATH:STRING=${first_prefix},${second_prefix}"
)
``COMMAND <cmd>...`` ``COMMAND <cmd>...``
Any of the other ``..._COMMAND`` options can have additional commands Any of the other ``..._COMMAND`` options can have additional commands