diff options
Diffstat (limited to 'Help/variable/CMAKE_USER_MAKE_RULES_OVERRIDE.rst')
| -rw-r--r-- | Help/variable/CMAKE_USER_MAKE_RULES_OVERRIDE.rst | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/Help/variable/CMAKE_USER_MAKE_RULES_OVERRIDE.rst b/Help/variable/CMAKE_USER_MAKE_RULES_OVERRIDE.rst new file mode 100644 index 0000000..5a4c86b --- /dev/null +++ b/Help/variable/CMAKE_USER_MAKE_RULES_OVERRIDE.rst @@ -0,0 +1,23 @@ +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 project() or 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 include() will work. Use +it only as a last resort for behavior that cannot be achieved any +other way. For example, one may set CMAKE_C_FLAGS_INIT to change the +default value used to initialize CMAKE_C_FLAGS 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 +CMAKE_RUNTIME_OUTPUT_DIRECTORY that affect the placement of binaries. +Information set in the file will be used for try_compile and try_run +builds too. |