CMAKE_USER_MAKE_RULES_OVERRIDE | |
------------------------------ | |
Specify a CMake file that overrides platform information. | |
CMake loads the specified file while enabling support for each | |
language from either the :command:`project` or :command:`enable_language` | |
commands. It is loaded after CMake's builtin compiler and platform information | |
modules have been loaded but before the information is used. The file | |
may set platform information variables to override CMake's defaults. | |
This feature is intended for use only in overriding information | |
variables that must be set before CMake builds its first test project | |
to check that the compiler for a language works. It should not be | |
used to load a file in cases that a normal :command:`include` will work. Use | |
it only as a last resort for behavior that cannot be achieved any | |
other way. For example, one may set the | |
:variable:`CMAKE_C_FLAGS_INIT <CMAKE_<LANG>_FLAGS_INIT>` variable | |
to change the default value used to initialize the | |
:variable:`CMAKE_C_FLAGS <CMAKE_<LANG>_FLAGS>` variable | |
before it is cached. The override file should NOT be used to set anything | |
that could be set after languages are enabled, such as variables like | |
:variable:`CMAKE_RUNTIME_OUTPUT_DIRECTORY` that affect the placement of | |
binaries. Information set in the file will be used for :command:`try_compile` | |
and :command:`try_run` builds too. |