1CMAKE_<LANG>_COMPILER
2---------------------
3
4The full path to the compiler for ``LANG``.
5
6This is the command that will be used as the ``<LANG>`` compiler.  Once
7set, you can not change this variable.
8
9Usage
10^^^^^
11
12This variable can be set by the user during the first time a build tree is configured.
13
14If a non-full path value is supplied then CMake will resolve the full path of
15the compiler.
16
17The variable could be set in a user supplied toolchain file or via `-D` on the command line.
18
19.. note::
20  Options that are required to make the compiler work correctly can be included
21  as items in a list; they can not be changed.
22
23.. code-block:: cmake
24
25  #set within user supplied toolchain file
26  set(CMAKE_C_COMPILER /full/path/to/qcc --arg1 --arg2)
27
28or
29
30.. code-block:: console
31
32  $ cmake ... -DCMAKE_C_COMPILER='qcc;--arg1;--arg2'
33