mirror of
https://github.com/Kitware/CMake.git
synced 2026-02-26 02:38:37 -06:00
Merge topic 'cmake-toolchains-manual'
c45b5ceHelp: Add cmake-toolchains.7 manual3e3f8b4Help: Document the CMAKE_FIND_ROOT_PATH* variables.531c108Help: Document the CMAKE_TOOLCHAIN_FILE.
This commit is contained in:
8
Help/variable/CMAKE_FIND_ROOT_PATH.rst
Normal file
8
Help/variable/CMAKE_FIND_ROOT_PATH.rst
Normal file
@@ -0,0 +1,8 @@
|
||||
CMAKE_FIND_ROOT_PATH
|
||||
--------------------
|
||||
|
||||
List of root paths to search on the filesystem.
|
||||
|
||||
This variable is most useful when cross-compiling. CMake uses the paths in
|
||||
this list as alternative roots to find filesystem items with :command:`find_package`,
|
||||
:command:`find_library` etc.
|
||||
6
Help/variable/CMAKE_FIND_ROOT_PATH_MODE_INCLUDE.rst
Normal file
6
Help/variable/CMAKE_FIND_ROOT_PATH_MODE_INCLUDE.rst
Normal file
@@ -0,0 +1,6 @@
|
||||
CMAKE_FIND_ROOT_PATH_MODE_INCLUDE
|
||||
---------------------------------
|
||||
|
||||
.. |FIND_XXX| replace:: :command:`find_file` and :command:`find_path`
|
||||
|
||||
.. include:: CMAKE_FIND_ROOT_PATH_MODE_XXX.txt
|
||||
6
Help/variable/CMAKE_FIND_ROOT_PATH_MODE_LIBRARY.rst
Normal file
6
Help/variable/CMAKE_FIND_ROOT_PATH_MODE_LIBRARY.rst
Normal file
@@ -0,0 +1,6 @@
|
||||
CMAKE_FIND_ROOT_PATH_MODE_LIBRARY
|
||||
---------------------------------
|
||||
|
||||
.. |FIND_XXX| replace:: :command:`find_library`
|
||||
|
||||
.. include:: CMAKE_FIND_ROOT_PATH_MODE_XXX.txt
|
||||
6
Help/variable/CMAKE_FIND_ROOT_PATH_MODE_PACKAGE.rst
Normal file
6
Help/variable/CMAKE_FIND_ROOT_PATH_MODE_PACKAGE.rst
Normal file
@@ -0,0 +1,6 @@
|
||||
CMAKE_FIND_ROOT_PATH_MODE_PACKAGE
|
||||
---------------------------------
|
||||
|
||||
.. |FIND_XXX| replace:: :command:`find_package`
|
||||
|
||||
.. include:: CMAKE_FIND_ROOT_PATH_MODE_XXX.txt
|
||||
6
Help/variable/CMAKE_FIND_ROOT_PATH_MODE_PROGRAM.rst
Normal file
6
Help/variable/CMAKE_FIND_ROOT_PATH_MODE_PROGRAM.rst
Normal file
@@ -0,0 +1,6 @@
|
||||
CMAKE_FIND_ROOT_PATH_MODE_PROGRAM
|
||||
---------------------------------
|
||||
|
||||
.. |FIND_XXX| replace:: :command:`find_program`
|
||||
|
||||
.. include:: CMAKE_FIND_ROOT_PATH_MODE_XXX.txt
|
||||
8
Help/variable/CMAKE_FIND_ROOT_PATH_MODE_XXX.txt
Normal file
8
Help/variable/CMAKE_FIND_ROOT_PATH_MODE_XXX.txt
Normal file
@@ -0,0 +1,8 @@
|
||||
This variable controls whether the :variable:`CMAKE_FIND_ROOT_PATH` and
|
||||
:variable:`CMAKE_SYSROOT` are used by |FIND_XXX|.
|
||||
|
||||
If set to ``ONLY``, then only the roots in :variable:`CMAKE_FIND_ROOT_PATH`
|
||||
will be searched. If set to ``NEVER``, then the roots in
|
||||
:variable:`CMAKE_FIND_ROOT_PATH` will be ignored and only the host system
|
||||
root will be used. If set to ``BOTH``, then the host system paths and the
|
||||
paths in :variable:`CMAKE_FIND_ROOT_PATH` will be searched.
|
||||
@@ -10,4 +10,4 @@ may be set to a path to a path to the external toolchain and will be passed
|
||||
to the compiler driver if supported.
|
||||
|
||||
This variable may only be set in a toolchain file specified by
|
||||
the ``CMAKE_TOOLCHAIN_FILE`` variable.
|
||||
the :variable:`CMAKE_TOOLCHAIN_FILE` variable.
|
||||
|
||||
@@ -8,4 +8,4 @@ QNX qcc. These compiler drivers support a command-line argument to specify
|
||||
the target to cross-compile for.
|
||||
|
||||
This variable may only be set in a toolchain file specified by
|
||||
the ``CMAKE_TOOLCHAIN_FILE`` variable.
|
||||
the :variable:`CMAKE_TOOLCHAIN_FILE` variable.
|
||||
|
||||
@@ -9,4 +9,4 @@ necessary on installation. The ``CMAKE_SYSROOT`` is also used to prefix
|
||||
paths searched by the ``find_*`` commands.
|
||||
|
||||
This variable may only be set in a toolchain file specified by
|
||||
the ``CMAKE_TOOLCHAIN_FILE`` variable.
|
||||
the :variable:`CMAKE_TOOLCHAIN_FILE` variable.
|
||||
|
||||
9
Help/variable/CMAKE_TOOLCHAIN_FILE.rst
Normal file
9
Help/variable/CMAKE_TOOLCHAIN_FILE.rst
Normal file
@@ -0,0 +1,9 @@
|
||||
CMAKE_TOOLCHAIN_FILE
|
||||
--------------------
|
||||
|
||||
Path to toolchain file supplied to :manual:`cmake(1)`.
|
||||
|
||||
This variable is specified on the command line when cross-compiling with CMake.
|
||||
It is the path to a file which is read early in the CMake run and which specifies
|
||||
locations for compilers and toolchain utilities, and other target platform and
|
||||
compiler related information.
|
||||
Reference in New Issue
Block a user