Commit 24fa0401 authored by Joachim Wuttke's avatar Joachim Wuttke

Help: Spell out ";-list" as "semicolon-separated list"

parent bba42bb9
...@@ -96,7 +96,7 @@ If ``NO_DEFAULT_PATH`` is not specified, the search process is as follows: ...@@ -96,7 +96,7 @@ If ``NO_DEFAULT_PATH`` is not specified, the search process is as follows:
2. Search paths specified in cmake-specific cache variables. 2. Search paths specified in cmake-specific cache variables.
These are intended to be used on the command line with a ``-DVAR=value``. These are intended to be used on the command line with a ``-DVAR=value``.
The values are interpreted as :ref:`;-lists <CMake Language Lists>`. The values are interpreted as :ref:`semicolon-separated lists <CMake Language Lists>`.
This can be skipped if ``NO_CMAKE_PATH`` is passed. This can be skipped if ``NO_CMAKE_PATH`` is passed.
* |CMAKE_PREFIX_PATH_XXX| * |CMAKE_PREFIX_PATH_XXX|
......
...@@ -56,7 +56,7 @@ Options: ...@@ -56,7 +56,7 @@ Options:
``RESULTS_VARIABLE <variable>`` ``RESULTS_VARIABLE <variable>``
The variable will be set to contain the result of all processes as a The variable will be set to contain the result of all processes as a
:ref:`;-list <CMake Language Lists>`, in order of the given ``COMMAND`` :ref:`semicolon-separated list <CMake Language Lists>`, in order of the given ``COMMAND``
arguments. Each entry will be an integer return code from the arguments. Each entry will be an integer return code from the
corresponding child or a string describing an error condition. corresponding child or a string describing an error condition.
......
...@@ -290,7 +290,7 @@ enabled. ...@@ -290,7 +290,7 @@ enabled.
2. Search paths specified in cmake-specific cache variables. These 2. Search paths specified in cmake-specific cache variables. These
are intended to be used on the command line with a ``-DVAR=value``. are intended to be used on the command line with a ``-DVAR=value``.
The values are interpreted as :ref:`;-lists <CMake Language Lists>`. The values are interpreted as :ref:`semicolon-separated lists <CMake Language Lists>`.
This can be skipped if ``NO_CMAKE_PATH`` is passed:: This can be skipped if ``NO_CMAKE_PATH`` is passed::
CMAKE_PREFIX_PATH CMAKE_PREFIX_PATH
......
...@@ -8,7 +8,7 @@ and cache entries. ...@@ -8,7 +8,7 @@ and cache entries.
Signatures of this command that specify a ``<value>...`` placeholder Signatures of this command that specify a ``<value>...`` placeholder
expect zero or more arguments. Multiple arguments will be joined as expect zero or more arguments. Multiple arguments will be joined as
a :ref:`;-list <CMake Language Lists>` to form the actual variable a :ref:`semicolon-separated list <CMake Language Lists>` to form the actual variable
value to be set. Zero arguments will cause normal variables to be value to be set. Zero arguments will cause normal variables to be
unset. See the :command:`unset` command to unset variables explicitly. unset. See the :command:`unset` command to unset variables explicitly.
......
...@@ -92,7 +92,7 @@ Each ``<item>`` may be: ...@@ -92,7 +92,7 @@ Each ``<item>`` may be:
* **A generator expression**: A ``$<...>`` :manual:`generator expression * **A generator expression**: A ``$<...>`` :manual:`generator expression
<cmake-generator-expressions(7)>` may evaluate to any of the above <cmake-generator-expressions(7)>` may evaluate to any of the above
items or to a :ref:`;-list <CMake Language Lists>` of them. items or to a :ref:`semicolon-separated list <CMake Language Lists>` of them.
If the ``...`` contains any ``;`` characters, e.g. after evaluation If the ``...`` contains any ``;`` characters, e.g. after evaluation
of a ``${list}`` variable, be sure to use an explicitly quoted of a ``${list}`` variable, be sure to use an explicitly quoted
argument ``"$<...>"`` so that this command receives it as a argument ``"$<...>"`` so that this command receives it as a
......
...@@ -2,7 +2,7 @@ BUILDSYSTEM_TARGETS ...@@ -2,7 +2,7 @@ BUILDSYSTEM_TARGETS
------------------- -------------------
This read-only directory property contains a This read-only directory property contains a
:ref:`;-list <CMake Language Lists>` of buildsystem targets added in the :ref:`semicolon-separated list <CMake Language Lists>` of buildsystem targets added in the
directory by calls to the :command:`add_library`, :command:`add_executable`, directory by calls to the :command:`add_library`, :command:`add_executable`,
and :command:`add_custom_target` commands. The list does not include any and :command:`add_custom_target` commands. The list does not include any
:ref:`Imported Targets` or :ref:`Alias Targets`, but does include :ref:`Imported Targets` or :ref:`Alias Targets`, but does include
......
...@@ -3,7 +3,7 @@ COMPILE_OPTIONS ...@@ -3,7 +3,7 @@ COMPILE_OPTIONS
List of options to pass to the compiler. List of options to pass to the compiler.
This property holds a :ref:`;-list <CMake Language Lists>` of options This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of options
given so far to the :command:`add_compile_options` command. given so far to the :command:`add_compile_options` command.
This property is used to initialize the :prop_tgt:`COMPILE_OPTIONS` target This property is used to initialize the :prop_tgt:`COMPILE_OPTIONS` target
......
...@@ -3,7 +3,7 @@ LINK_DIRECTORIES ...@@ -3,7 +3,7 @@ LINK_DIRECTORIES
List of linker search directories. List of linker search directories.
This property holds a :ref:`;-list <CMake Language Lists>` of directories This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of directories
and is typically populated using the :command:`link_directories` command. and is typically populated using the :command:`link_directories` command.
It gets its initial value from its parent directory, if it has one. It gets its initial value from its parent directory, if it has one.
......
...@@ -4,7 +4,7 @@ LINK_OPTIONS ...@@ -4,7 +4,7 @@ LINK_OPTIONS
List of options to use for the link step of shared library, module List of options to use for the link step of shared library, module
and executable targets. and executable targets.
This property holds a :ref:`;-list <CMake Language Lists>` of options This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of options
given so far to the :command:`add_link_options` command. given so far to the :command:`add_link_options` command.
This property is used to initialize the :prop_tgt:`LINK_OPTIONS` target This property is used to initialize the :prop_tgt:`LINK_OPTIONS` target
......
...@@ -2,7 +2,7 @@ SUBDIRECTORIES ...@@ -2,7 +2,7 @@ SUBDIRECTORIES
-------------- --------------
This read-only directory property contains a This read-only directory property contains a
:ref:`;-list <CMake Language Lists>` of subdirectories processed so far by :ref:`semicolon-separated list <CMake Language Lists>` of subdirectories processed so far by
the :command:`add_subdirectory` or :command:`subdirs` commands. Each entry is the :command:`add_subdirectory` or :command:`subdirs` commands. Each entry is
the absolute path to the source directory (containing the ``CMakeLists.txt`` the absolute path to the source directory (containing the ``CMakeLists.txt``
file). This is suitable to pass to the :command:`get_property` command file). This is suitable to pass to the :command:`get_property` command
......
...@@ -3,5 +3,5 @@ TESTS ...@@ -3,5 +3,5 @@ TESTS
List of tests. List of tests.
This read-only property holds a :ref:`;-list <CMake Language Lists>` of tests This read-only property holds a :ref:`semicolon-separated list <CMake Language Lists>` of tests
defined so far, in the current directory, by the :command:`add_test` command. defined so far, in the current directory, by the :command:`add_test` command.
...@@ -3,7 +3,7 @@ COMPILE_OPTIONS ...@@ -3,7 +3,7 @@ COMPILE_OPTIONS
List of additional options to pass to the compiler. List of additional options to pass to the compiler.
This property holds a :ref:`;-list <CMake Language Lists>` of options This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of options
and will be added to the list of compile flags when this and will be added to the list of compile flags when this
source file builds. Use :prop_sf:`COMPILE_DEFINITIONS` to pass source file builds. Use :prop_sf:`COMPILE_DEFINITIONS` to pass
additional preprocessor definitions and :prop_sf:`INCLUDE_DIRECTORIES` to pass additional preprocessor definitions and :prop_sf:`INCLUDE_DIRECTORIES` to pass
......
...@@ -3,7 +3,7 @@ INCLUDE_DIRECTORIES ...@@ -3,7 +3,7 @@ INCLUDE_DIRECTORIES
List of preprocessor include file search directories. List of preprocessor include file search directories.
This property holds a :ref:`;-list <CMake Language Lists>` of paths This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of paths
and will be added to the list of include directories when this and will be added to the list of include directories when this
source file builds. These directories will take precedence over directories source file builds. These directories will take precedence over directories
defined at target level except for :generator:`Xcode` generator due to technical defined at target level except for :generator:`Xcode` generator due to technical
......
...@@ -3,7 +3,7 @@ OBJECT_DEPENDS ...@@ -3,7 +3,7 @@ OBJECT_DEPENDS
Additional files on which a compiled object file depends. Additional files on which a compiled object file depends.
Specifies a :ref:`;-list <CMake Language Lists>` of full-paths to Specifies a :ref:`semicolon-separated list <CMake Language Lists>` of full-paths to
files on which any object files compiled from this source file depend. files on which any object files compiled from this source file depend.
On :ref:`Makefile Generators` and the :generator:`Ninja` generator an On :ref:`Makefile Generators` and the :generator:`Ninja` generator an
object file will be recompiled if any of the named files is newer than it. object file will be recompiled if any of the named files is newer than it.
......
AUTOMOC_MACRO_NAMES AUTOMOC_MACRO_NAMES
------------------- -------------------
A :ref:`;-list <CMake Language Lists>` list of macro names used by A :ref:`semicolon-separated list <CMake Language Lists>` list of macro names used by
:prop_tgt:`AUTOMOC` to determine if a C++ file needs to be processed by ``moc``. :prop_tgt:`AUTOMOC` to determine if a C++ file needs to be processed by ``moc``.
This property is only used if the :prop_tgt:`AUTOMOC` property is ``ON`` This property is only used if the :prop_tgt:`AUTOMOC` property is ``ON``
......
BUILD_RPATH BUILD_RPATH
----------- -----------
A :ref:`;-list <CMake Language Lists>` specifying runtime path (``RPATH``) A :ref:`semicolon-separated list <CMake Language Lists>` specifying runtime path (``RPATH``)
entries to add to binaries linked in the build tree (for platforms that entries to add to binaries linked in the build tree (for platforms that
support it). The entries will *not* be used for binaries in the install support it). The entries will *not* be used for binaries in the install
tree. See also the :prop_tgt:`INSTALL_RPATH` target property. tree. See also the :prop_tgt:`INSTALL_RPATH` target property.
......
...@@ -3,7 +3,7 @@ COMPILE_OPTIONS ...@@ -3,7 +3,7 @@ COMPILE_OPTIONS
List of options to pass to the compiler. List of options to pass to the compiler.
This property holds a :ref:`;-list <CMake Language Lists>` of options This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of options
specified so far for its target. Use the :command:`target_compile_options` specified so far for its target. Use the :command:`target_compile_options`
command to append more options. command to append more options.
......
IMPORTED_OBJECTS IMPORTED_OBJECTS
---------------- ----------------
:ref:`;-list <CMake Language Lists>` of absolute paths to the object A :ref:`semicolon-separated list <CMake Language Lists>` of absolute paths to the object
files on disk for an :ref:`imported <Imported targets>` files on disk for an :ref:`imported <Imported targets>`
:ref:`object library <object libraries>`. :ref:`object library <object libraries>`.
......
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
This property is implemented only when ``<LANG>`` is ``C`` or ``CXX``. This property is implemented only when ``<LANG>`` is ``C`` or ``CXX``.
Specify a :ref:`;-list <CMake Language Lists>` containing a command Specify a :ref:`semicolon-separated list <CMake Language Lists>` containing a command
line for the ``clang-tidy`` tool. The :ref:`Makefile Generators` line for the ``clang-tidy`` tool. The :ref:`Makefile Generators`
and the :generator:`Ninja` generator will run this tool along with the and the :generator:`Ninja` generator will run this tool along with the
compiler and report a warning if the tool reports any problems. compiler and report a warning if the tool reports any problems.
......
...@@ -4,7 +4,7 @@ ...@@ -4,7 +4,7 @@
This property is implemented only when ``<LANG>`` is ``C``, ``CXX``, This property is implemented only when ``<LANG>`` is ``C``, ``CXX``,
``Fortran``, or ``CUDA``. ``Fortran``, or ``CUDA``.
Specify a :ref:`;-list <CMake Language Lists>` containing a command line Specify a :ref:`semicolon-separated list <CMake Language Lists>` containing a command line
for a compiler launching tool. The :ref:`Makefile Generators` and the for a compiler launching tool. The :ref:`Makefile Generators` and the
:generator:`Ninja` generator will run this tool and pass the compiler and :generator:`Ninja` generator will run this tool and pass the compiler and
its arguments to the tool. Some example tools are distcc and ccache. its arguments to the tool. Some example tools are distcc and ccache.
......
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
This property is supported only when ``<LANG>`` is ``C`` or ``CXX``. This property is supported only when ``<LANG>`` is ``C`` or ``CXX``.
Specify a :ref:`;-list <CMake Language Lists>` containing a command line Specify a :ref:`semicolon-separated list <CMake Language Lists>` containing a command line
for the ``cppcheck`` static analysis tool. The :ref:`Makefile Generators` for the ``cppcheck`` static analysis tool. The :ref:`Makefile Generators`
and the :generator:`Ninja` generator will run ``cppcheck`` along with the and the :generator:`Ninja` generator will run ``cppcheck`` along with the
compiler and report any problems. If the command-line specifies the compiler and report any problems. If the command-line specifies the
......
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
This property is supported only when ``<LANG>`` is ``C`` or ``CXX``. This property is supported only when ``<LANG>`` is ``C`` or ``CXX``.
Specify a :ref:`;-list <CMake Language Lists>` containing a command line Specify a :ref:`semicolon-separated list <CMake Language Lists>` containing a command line
for the ``cpplint`` style checker. The :ref:`Makefile Generators` and the for the ``cpplint`` style checker. The :ref:`Makefile Generators` and the
:generator:`Ninja` generator will run ``cpplint`` along with the compiler :generator:`Ninja` generator will run ``cpplint`` along with the compiler
and report any problems. and report any problems.
......
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
This property is implemented only when ``<LANG>`` is ``C`` or ``CXX``. This property is implemented only when ``<LANG>`` is ``C`` or ``CXX``.
Specify a :ref:`;-list <CMake Language Lists>` containing a command Specify a :ref:`semicolon-separated list <CMake Language Lists>` containing a command
line for the ``include-what-you-use`` tool. The :ref:`Makefile Generators` line for the ``include-what-you-use`` tool. The :ref:`Makefile Generators`
and the :generator:`Ninja` generator will run this tool along with the and the :generator:`Ninja` generator will run this tool along with the
compiler and report a warning if the tool reports any problems. compiler and report a warning if the tool reports any problems.
......
...@@ -4,7 +4,7 @@ LINK_DIRECTORIES ...@@ -4,7 +4,7 @@ LINK_DIRECTORIES
List of directories to use for the link step of shared library, module List of directories to use for the link step of shared library, module
and executable targets. and executable targets.
This property holds a :ref:`;-list <CMake Language Lists>` of directories This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of directories
specified so far for its target. Use the :command:`target_link_directories` specified so far for its target. Use the :command:`target_link_directories`
command to append more search directories. command to append more search directories.
......
...@@ -6,7 +6,7 @@ and executable targets. Targets that are static libraries need to use ...@@ -6,7 +6,7 @@ and executable targets. Targets that are static libraries need to use
the :prop_tgt:`STATIC_LIBRARY_OPTIONS` target property. the :prop_tgt:`STATIC_LIBRARY_OPTIONS` target property.
This property holds a :ref:`;-list <CMake Language Lists>` of options This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of options
specified so far for its target. Use the :command:`target_link_options` specified so far for its target. Use the :command:`target_link_options`
command to append more options. command to append more options.
......
...@@ -5,7 +5,7 @@ Archiver (or MSVC librarian) flags for a static library target. ...@@ -5,7 +5,7 @@ Archiver (or MSVC librarian) flags for a static library target.
Targets that are shared libraries, modules, or executables need to use Targets that are shared libraries, modules, or executables need to use
the :prop_tgt:`LINK_OPTIONS` target property. the :prop_tgt:`LINK_OPTIONS` target property.
This property holds a :ref:`;-list <CMake Language Lists>` of options This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of options
specified so far for its target. Use :command:`set_target_properties` or specified so far for its target. Use :command:`set_target_properties` or
:command:`set_property` commands to set its content. :command:`set_property` commands to set its content.
......
...@@ -2,6 +2,6 @@ VS_SDK_REFERENCES ...@@ -2,6 +2,6 @@ VS_SDK_REFERENCES
----------------- -----------------
Visual Studio project SDK references. Visual Studio project SDK references.
Specify a :ref:`;-list <CMake Language Lists>` of SDK references Specify a :ref:`semicolon-separated list <CMake Language Lists>` of SDK references
to be added to a generated Visual Studio project, e.g. to be added to a generated Visual Studio project, e.g.
``Microsoft.AdMediatorWindows81, Version=1.0``. ``Microsoft.AdMediatorWindows81, Version=1.0``.
...@@ -251,7 +251,7 @@ Deprecated and Removed Features ...@@ -251,7 +251,7 @@ Deprecated and Removed Features
Users that keep some ``<prefix>/bin`` directories in the ``PATH`` just for Users that keep some ``<prefix>/bin`` directories in the ``PATH`` just for
their tools do not necessarily want any supporting ``<prefix>/lib`` their tools do not necessarily want any supporting ``<prefix>/lib``
directories searched. One may set the ``CMAKE_PREFIX_PATH`` environment directories searched. One may set the ``CMAKE_PREFIX_PATH`` environment
variable with a :ref:`;-list <CMake Language Lists>` of prefixes that are variable with a :ref:`semicolon-separated list <CMake Language Lists>` of prefixes that are
to be searched. to be searched.
* The :generator:`Visual Studio 7 .NET 2003` generator is now * The :generator:`Visual Studio 7 .NET 2003` generator is now
......
CMAKE_APPBUNDLE_PATH CMAKE_APPBUNDLE_PATH
-------------------- --------------------
:ref:`;-list <CMake Language Lists>` of directories specifying a search path :ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
for macOS application bundles used by the :command:`find_program`, and for macOS application bundles used by the :command:`find_program`, and
:command:`find_package` commands. :command:`find_package` commands.
CMAKE_AUTOMOC_MACRO_NAMES CMAKE_AUTOMOC_MACRO_NAMES
---------------------------- ----------------------------
A :ref:`;-list <CMake Language Lists>` list of macro names used by :ref:`Semicolon-separated list <CMake Language Lists>` list of macro names used by
:variable:`CMAKE_AUTOMOC` to determine if a C++ file needs to be :variable:`CMAKE_AUTOMOC` to determine if a C++ file needs to be
processed by ``moc``. processed by ``moc``.
......
CMAKE_BUILD_RPATH CMAKE_BUILD_RPATH
----------------- -----------------
A :ref:`;-list <CMake Language Lists>` specifying runtime path (``RPATH``) :ref:`Semicolon-separated list <CMake Language Lists>` specifying runtime path (``RPATH``)
entries to add to binaries linked in the build tree (for platforms that entries to add to binaries linked in the build tree (for platforms that
support it). The entries will *not* be used for binaries in the install support it). The entries will *not* be used for binaries in the install
tree. See also the :variable:`CMAKE_INSTALL_RPATH` variable. tree. See also the :variable:`CMAKE_INSTALL_RPATH` variable.
......
...@@ -2,6 +2,6 @@ CMAKE_CUDA_TOOLKIT_INCLUDE_DIRECTORIES ...@@ -2,6 +2,6 @@ CMAKE_CUDA_TOOLKIT_INCLUDE_DIRECTORIES
-------------------------------------- --------------------------------------
When the ``CUDA`` language has been enabled, this provides a When the ``CUDA`` language has been enabled, this provides a
:ref:`;-list <CMake Language Lists>` of include directories provided :ref:`semicolon-separated list <CMake Language Lists>` of include directories provided
by the CUDA Toolkit. The value may be useful for C++ source files by the CUDA Toolkit. The value may be useful for C++ source files
to include CUDA headers. to include CUDA headers.
CMAKE_FIND_ROOT_PATH CMAKE_FIND_ROOT_PATH
-------------------- --------------------
:ref:`;-list <CMake Language Lists>` of root paths to search on the filesystem. :ref:`Semicolon-separated list <CMake Language Lists>` of root paths to search on the filesystem.
This variable is most useful when cross-compiling. CMake uses the paths in This variable is most useful when cross-compiling. CMake uses the paths in
this list as alternative roots to find filesystem items with this list as alternative roots to find filesystem items with
......
CMAKE_FRAMEWORK_PATH CMAKE_FRAMEWORK_PATH
-------------------- --------------------
:ref:`;-list <CMake Language Lists>` of directories specifying a search path :ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
for macOS frameworks used by the :command:`find_library`, for macOS frameworks used by the :command:`find_library`,
:command:`find_package`, :command:`find_path`, and :command:`find_file` :command:`find_package`, :command:`find_path`, and :command:`find_file`
commands. commands.
CMAKE_IGNORE_PATH CMAKE_IGNORE_PATH
----------------- -----------------
:ref:`;-list <CMake Language Lists>` of directories to be *ignored* by :ref:`Semicolon-separated list <CMake Language Lists>` of directories to be *ignored* by
the :command:`find_program`, :command:`find_library`, :command:`find_file`, the :command:`find_program`, :command:`find_library`, :command:`find_file`,
and :command:`find_path` commands. This is useful in cross-compiling and :command:`find_path` commands. This is useful in cross-compiling
environments where some system directories contain incompatible but environments where some system directories contain incompatible but
......
CMAKE_INCLUDE_PATH CMAKE_INCLUDE_PATH
------------------ ------------------
:ref:`;-list <CMake Language Lists>` of directories specifying a search path :ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
for the :command:`find_file` and :command:`find_path` commands. By default it for the :command:`find_file` and :command:`find_path` commands. By default it
is empty, it is intended to be set by the project. See also is empty, it is intended to be set by the project. See also
:variable:`CMAKE_SYSTEM_INCLUDE_PATH` and :variable:`CMAKE_PREFIX_PATH`. :variable:`CMAKE_SYSTEM_INCLUDE_PATH` and :variable:`CMAKE_PREFIX_PATH`.
...@@ -5,7 +5,7 @@ Defines the syntax of compiler driver option to pass options to the linker ...@@ -5,7 +5,7 @@ Defines the syntax of compiler driver option to pass options to the linker
tool. It will be used to translate the ``LINKER:`` prefix in the link options tool. It will be used to translate the ``LINKER:`` prefix in the link options
(see :command:`add_link_options` and :command:`target_link_options`). (see :command:`add_link_options` and :command:`target_link_options`).
This variable holds a :ref:`;-list <CMake Language Lists>` of tokens. This variable holds a :ref:`semicolon-separated list <CMake Language Lists>` of tokens.
If a space (i.e. " ") is specified as last token, flag and ``LINKER:`` If a space (i.e. " ") is specified as last token, flag and ``LINKER:``
arguments will be specified as separate arguments to the compiler driver. arguments will be specified as separate arguments to the compiler driver.
The :variable:`CMAKE_<LANG>_LINKER_WRAPPER_FLAG_SEP` variable can be specified The :variable:`CMAKE_<LANG>_LINKER_WRAPPER_FLAG_SEP` variable can be specified
......
CMAKE_LIBRARY_PATH CMAKE_LIBRARY_PATH
------------------ ------------------
:ref:`;-list <CMake Language Lists>` of directories specifying a search path :ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
for the :command:`find_library` command. By default it is empty, it is for the :command:`find_library` command. By default it is empty, it is
intended to be set by the project. See also intended to be set by the project. See also
:variable:`CMAKE_SYSTEM_LIBRARY_PATH` and :variable:`CMAKE_PREFIX_PATH`. :variable:`CMAKE_SYSTEM_LIBRARY_PATH` and :variable:`CMAKE_PREFIX_PATH`.
CMAKE_MODULE_PATH CMAKE_MODULE_PATH
----------------- -----------------
:ref:`;-list <CMake Language Lists>` of directories specifying a search path :ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
for CMake modules to be loaded by the :command:`include` or for CMake modules to be loaded by the :command:`include` or
:command:`find_package` commands before checking the default modules that come :command:`find_package` commands before checking the default modules that come
with CMake. By default it is empty, it is intended to be set by the project. with CMake. By default it is empty, it is intended to be set by the project.
CMAKE_PREFIX_PATH CMAKE_PREFIX_PATH
----------------- -----------------
:ref:`;-list <CMake Language Lists>` of directories specifying installation :ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying installation
*prefixes* to be searched by the :command:`find_package`, *prefixes* to be searched by the :command:`find_package`,
:command:`find_program`, :command:`find_library`, :command:`find_file`, and :command:`find_program`, :command:`find_library`, :command:`find_file`, and
:command:`find_path` commands. Each command will add appropriate :command:`find_path` commands. Each command will add appropriate
......
CMAKE_PROGRAM_PATH CMAKE_PROGRAM_PATH
------------------ ------------------
:ref:`;-list <CMake Language Lists>` of directories specifying a search path :ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
for the :command:`find_program` command. By default it is empty, it is for the :command:`find_program` command. By default it is empty, it is
intended to be set by the project. See also intended to be set by the project. See also
:variable:`CMAKE_SYSTEM_PROGRAM_PATH` and :variable:`CMAKE_PREFIX_PATH`. :variable:`CMAKE_SYSTEM_PROGRAM_PATH` and :variable:`CMAKE_PREFIX_PATH`.
CMAKE_SYSTEM_IGNORE_PATH CMAKE_SYSTEM_IGNORE_PATH
------------------------ ------------------------
:ref:`;-list <CMake Language Lists>` of directories to be *ignored* by :ref:`Semicolon-separated list <CMake Language Lists>` of directories to be *ignored* by
the :command:`find_program`, :command:`find_library`, :command:`find_file`, the :command:`find_program`, :command:`find_library`, :command:`find_file`,
and :command:`find_path` commands. This is useful in cross-compiling and :command:`find_path` commands. This is useful in cross-compiling
environments where some system directories contain incompatible but environments where some system directories contain incompatible but
......
CMAKE_SYSTEM_INCLUDE_PATH CMAKE_SYSTEM_INCLUDE_PATH
------------------------- -------------------------
:ref:`;-list <CMake Language Lists>` of directories specifying a search path :ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
for the :command:`find_file` and :command:`find_path` commands. By default for the :command:`find_file` and :command:`find_path` commands. By default
this contains the standard directories for the current system. It is *not* this contains the standard directories for the current system. It is *not*
intended to be modified by the project; use :variable:`CMAKE_INCLUDE_PATH` for intended to be modified by the project; use :variable:`CMAKE_INCLUDE_PATH` for
......
CMAKE_SYSTEM_LIBRARY_PATH CMAKE_SYSTEM_LIBRARY_PATH
------------------------- -------------------------
:ref:`;-list <CMake Language Lists>` of directories specifying a search path :ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
for the :command:`find_library` command. By default this contains the for the :command:`find_library` command. By default this contains the
standard directories for the current system. It is *not* intended to be standard directories for the current system. It is *not* intended to be
modified by the project; use :variable:`CMAKE_LIBRARY_PATH` for this. modified by the project; use :variable:`CMAKE_LIBRARY_PATH` for this.
......
CMAKE_SYSTEM_PREFIX_PATH CMAKE_SYSTEM_PREFIX_PATH
------------------------ ------------------------
:ref:`;-list <CMake Language Lists>` of directories specifying installation :ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying installation
*prefixes* to be searched by the :command:`find_package`, *prefixes* to be searched by the :command:`find_package`,
:command:`find_program`, :command:`find_library`, :command:`find_file`, and :command:`find_program`, :command:`find_library`, :command:`find_file`, and
:command:`find_path` commands. Each command will add appropriate :command:`find_path` commands. Each command will add appropriate
......
CMAKE_SYSTEM_PROGRAM_PATH CMAKE_SYSTEM_PROGRAM_PATH
------------------------- -------------------------
:ref:`;-list <CMake Language Lists>` of directories specifying a search path :ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
for the :command:`find_program` command. By default this contains the for the :command:`find_program` command. By default this contains the
standard directories for the current system. It is *not* intended to be standard directories for the current system. It is *not* intended to be
modified by the project; use :variable:`CMAKE_PROGRAM_PATH` for this. modified by the project; use :variable:`CMAKE_PROGRAM_PATH` for this.
......
...@@ -9,6 +9,6 @@ prefixes specified in the ``Foo_ROOT`` CMake variable (if set). ...@@ -9,6 +9,6 @@ prefixes specified in the ``Foo_ROOT`` CMake variable (if set).
See policy :policy:`CMP0074`. See policy :policy:`CMP0074`.
This variable may hold a single prefix or a This variable may hold a single prefix or a
:ref:`;-list <CMake Language Lists>` of multiple prefixes. :ref:`semicolon-separated list <CMake Language Lists>` of multiple prefixes.
See also the :envvar:`<PackageName>_ROOT` environment variable. See also the :envvar:`<PackageName>_ROOT` environment variable.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment