mirror of
https://github.com/reactos/CMake.git
synced 2024-12-13 22:58:41 +00:00
a66004bee0
Document these variables.
Change our convention for setting these variables from:
set(CMAKE_C_FLAGS_INIT "...")
to
string(APPEND CMAKE_C_FLAGS_INIT " ...")
so that any value previously set by a toolchain file will be used.
Automate the conversion with:
sed -i 's/set *(\(CMAKE_\(C\|CXX\|Fortran\|RC\|ASM\|${[^}]\+}\)_FLAGS\(_[^_]\+\)\?_INIT \+"\)/string(APPEND \1 /' \
Modules/Compiler/*.cmake Modules/Platform/*.cmake
and follow up with some manual fixes (e.g. to cases that already
meant to append). Also revert the automated changes to contexts
that are not protected from running multiple times.
26 lines
1.3 KiB
ReStructuredText
26 lines
1.3 KiB
ReStructuredText
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.
|