CMake/Help/variable/CMAKE_LANG_COMPILER_EXTERNAL_TOOLCHAIN.rst

CMAKE_<LANG>_COMPILER_EXTERNAL_TOOLCHAIN
----------------------------------------

The external toolchain for cross-compiling, if supported.

Some compiler toolchains do not ship their own auxiliary utilities such as
archivers and linkers.  The compiler driver may support a command-line argument
to specify the location of such tools.
``CMAKE_<LANG>_COMPILER_EXTERNAL_TOOLCHAIN`` 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 :variable:`CMAKE_TOOLCHAIN_FILE` variable.
Allow toolchain files to specify an external toolchain. Clang can compile code, but uses the gcc tools for other tasks such as linking. The -gcc-toolchain option can be used for that, but generalize so that other compilers can be treated the same. If such a location is specified, use it as a hint for finding the binutils executables. 2013-08-08 17:36:36 +02:00			`CMAKE_<LANG>_COMPILER_EXTERNAL_TOOLCHAIN`
			`----------------------------------------`

			`The external toolchain for cross-compiling, if supported.`

Fix spelling typos in comments and documentation (#16037) The Debian package checker tool (lintian) detected several typos in CMake. 2016-03-29 14:24:20 -04:00			`Some compiler toolchains do not ship their own auxiliary utilities such as`
Allow toolchain files to specify an external toolchain. Clang can compile code, but uses the gcc tools for other tasks such as linking. The -gcc-toolchain option can be used for that, but generalize so that other compilers can be treated the same. If such a location is specified, use it as a hint for finding the binutils executables. 2013-08-08 17:36:36 +02:00			`archivers and linkers. The compiler driver may support a command-line argument`
Help: Improve formatting of variable documentation Improve formatting, primarily by: * Adding links to relevant commands, properties, generators, and so on. * Converting code, symbols, paths, and so on to fixed-width fonts. * Hard wrapping lines to 80 characters or less. 2015-08-18 01:34:01 -04:00			`to specify the location of such tools.`
			``CMAKE_<LANG>_COMPILER_EXTERNAL_TOOLCHAIN`` may be set to a path to a path to
			`the external toolchain and will be passed to the compiler driver if supported.`
Allow toolchain files to specify an external toolchain. Clang can compile code, but uses the gcc tools for other tasks such as linking. The -gcc-toolchain option can be used for that, but generalize so that other compilers can be treated the same. If such a location is specified, use it as a hint for finding the binutils executables. 2013-08-08 17:36:36 +02:00
			`This variable may only be set in a toolchain file specified by`
Help: Document the CMAKE_TOOLCHAIN_FILE. Link to the new docs from existing references to the variable. 2013-11-26 19:48:20 +01:00			the :variable:`CMAKE_TOOLCHAIN_FILE` variable.