summaryrefslogtreecommitdiffstats
path: root/Help/variable
Commit message (Collapse)AuthorAgeFilesLines
* Merge branch 'backport-4.0-xcode-macos-deployment-target'Brad King2025-10-261-10/+34
|\
| * Xcode: Restore default CMAKE_OSX_DEPLOYMENT_TARGET to run on hostBrad King2025-10-261-10/+34
| | | | | | | | | | | | | | | | | | | | | | Xcode by default targets the SDK's macOS version rather than the host's macOS version. In commit 7b19531291 (macOS: Do not pass any SDK/-isysroot to compilers by default, 2024-11-06, v4.0.0-rc1~511^2) we reverted commit 24aafbde11 (Xcode: Adjust deployment target SDK version to host version, 2015-10-11, v3.4.0-rc2~6^2), but it is still needed for Xcode. Restore the behavior so binaries run on the host by default. Fixes: #27309
* | Merge topic 'doc-generator-xrefs'Brad King2025-06-172-2/+2
|\ \ | | | | | | | | | | | | | | | | | | | | | 98837b42c3 Help: minor reference and markup fixes b634998727 Help: add and make references to generators consistent Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10877
| * | Help: add and make references to generators consistentBen Boeckel2025-06-122-2/+2
| | |
* | | Help: Fix CMAKE_PROJECT_COMPAT_VERSION documentationMatthew Woehlke2025-06-121-1/+1
| | | | | | | | | | | | | | | Fix a minor error in the explanatory example in the documentation of the CMAKE_PROJECT_COMPAT_VERSION property.
* | | Merge topic 'suppress-implicit-find-events'Brad King2025-06-121-0/+26
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | c42d82d569 find_*: support suppressing implicit transition events 64f429cc4f Help/dev: add release note for implicit configure log find events 4cd83339f1 cmFindCommon: fix comment after renaming the `FullDebugMode` member Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !10874
| * | | find_*: support suppressing implicit transition eventsBen Boeckel2025-06-111-0/+26
| |/ / | | | | | | | | | | | | | | | | | | When projects explicitly unset variables, the transition detection can end up reporting events when they are not desired. See: #24833
* | | Help: Note when `<project>_COMPAT_VERSION` were addedMatthew Woehlke2025-06-113-0/+6
|/ / | | | | | | | | | | | | | | Tweak documentation of project `_COMPAT_VERSION` variables to note when they were added. Note that, while these are "experimental" for now, they are always set; the experimental gate is only required for them to be set to non-empty values (and since they are optional, they may be empty regardless).
* | HIP: Add support for [CMAKE_]HIP_LINKER_LAUNCHERMaximilian Sander2025-05-301-0/+4
| | | | | | | | | | | | | | `CMAKE_<LANG>_LINKER_LAUNCHER` and `<LANG>_LINKER_LAUNCHER` are already support for C, CXX, CUDA, OBJC, OBJCXX, and Fortran. Add HIP. Closes: #26967
* | CUDA: Add support for [CMAKE_]CUDA_LINKER_LAUNCHERMaximilian Sander2025-05-301-0/+8
| | | | | | | | | | | | | | `CMAKE_<LANG>_LINKER_LAUNCHER` and `<LANG>_LINKER_LAUNCHER` are already support for C, CXX, OBJC, OBJCXX, and Fortran. Add CUDA. Issue: #26967
* | Merge topic 'renesas-compiler'Brad King2025-05-292-0/+19
|\ \ | | | | | | | | | | | | | | | | | | 514135f563 Renesas: Add support for Renesas compilers Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10669
| * | Renesas: Add support for Renesas compilersHirofumi Nakamura2025-05-282-0/+19
| | | | | | | | | | | | | | | | | | | | | | | | - CC-RX for RX architecture - CC-RL for RL78 architecture - CC-RH for RH850 architecture Closes: #26880
* | | Linker: Generate per-language module -DEF: flags on WindowsBrad King2025-05-282-0/+20
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | With IntelLLVM on Windows, we link using the compiler driver. With MSVC on Windows, we invoke the linker directly. If we use both in a single build tree, for separate languages, the value of `CMAKE_LINK_DEF_FILE_FLAG` conflicts. Add a per-language `CMAKE_<LANG>_LINK_DEF_FILE_FLAG` variable to avoid the conflict. Preserve the language-agnostic variable for compatibility with projects that reference it. Fixes: #26005
* | | Fortran: Add support for [CMAKE_]Fortran_LINKER_LAUNCHERMaximilian Sander2025-05-271-1/+9
|/ / | | | | | | | | | | | | `CMAKE_<LANG>_LINKER_LAUNCHER` and `<LANG>_LINKER_LAUNCHER` are already support for C, CXX, OBJC, and OBJCXX. Add Fortran. Closes: #26951
* | Merge topic 'automoc-specific-include-dirs'Brad King2025-05-211-0/+15
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | 39677f4cc6 AUTOMOC: Add option to specify moc include directories explicitly Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: Osyotr <zhenchik35026@gmail.com> Merge-request: !10640
| * | AUTOMOC: Add option to specify moc include directories explicitlyDavid Worley2025-05-201-0/+15
| | | | | | | | | | | | | | | | | | | | | | | | | | | Add a `AUTOMOC_INCLUDE_DIRECTORIES` target property and a corresponding `CMAKE_AUTOMOC_INCLUDE_DIRECTORIES` variable to initialize it. This is useful for targets that do not need moc to search include directories from all dependencies. Closes: #26414
* | | Merge topic 'patch-CheckIPOSupported'Brad King2025-05-202-0/+10
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 294b30b27e CheckIPOSupported: Extend documentation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10796
| * | | CheckIPOSupported: Extend documentationPeter Kokot2025-05-182-0/+10
| |/ / | | | | | | | | | | | | | | | | | | | | | | | | | | | - Added intro code block showing how to include this module. - Added brief description about IPO and LTO and how it is enabled in CMake. - Used "command" instead of "function". - Reworded few descriptions. - Synced indentation for items related to the command section. - Added "See Also" sections to related target properties and variables.
* | | Help: Document when CMAKE_FIND_LIBRARY_{PREFIXES,SUFFIXES} are providedBrad King2025-05-193-0/+6
|/ / | | | | | | Issue: #26943
* | Optionally exclude implicit link libraries via environmentBrad King2025-05-051-4/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | CMake detects libraries that the compiler driver implicitly passes to the linker, and stores them in `CMAKE_<LANG>_IMPLICIT_LINK_LIBRARIES` for use in constructing mixed-language link lines. Some compiler driver flags add implicitly linked libraries that should not be used during mixed-language linking because they are handled by similar flags passed to the other language's compiler driver. Add an environment variable that users can set to avoid undesired implicit link libraries in such scenarios. Follow the pattern from commit 023de565d3 (Optionally exclude implicit link directories via environment, 2023-05-25, v3.27.0-rc1~54^2). Fixes: #26911
* | Merge topic 'clang-macos-sdk'Brad King2025-05-031-11/+16
|\ \ | |/ | | | | | | | | | | bf1bb62e74 macOS: Restore support for LLVM/Clang without explicit CMAKE_OSX_SYSROOT Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10734
| * macOS: Restore support for LLVM/Clang without explicit CMAKE_OSX_SYSROOTBrad King2025-05-021-11/+16
| | | | | | | | | | | | | | | | | | | | In commit 7b19531291 (macOS: Do not pass any SDK/-isysroot to compilers by default, 2024-11-06, v4.0.0-rc1~511^2) we broke support for using upstream LLVM/Clang to build for macOS because the compiler has no default sysroot. Handle empty `CMAKE_OSX_SYSROOT` with LLVM/Clang by falling back to the macOS SDK reported by `xcrun --show-sdk-path` . Fixes: #26863
* | Merge topic 'patch-FindMFC'Brad King2025-04-291-3/+15
|\ \ | | | | | | | | | | | | | | | | | | bc9faec5e5 FindMFC, CMAKE_MFC_FLAG: Update documentation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10720
| * | FindMFC, CMAKE_MFC_FLAG: Update documentationPeter Kokot2025-04-281-3/+15
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | FindMFC: - Synced module documentation with other similar find modules. - Added examples section. - Added reference link to CMAKE_MFC_FLAG variable. CMAKE_MFC_FLAG: - Added separate examples section. - Mentioned FindMFC module. - Used target_compile_definitions() instead of add_definitions().
* | | project: add COMPAT_VERSION keywordVito Gamberini2025-04-253-0/+58
|/ / | | | | | | Fixes: #26893
* | Merge topic 'doc-include-rst'Brad King2025-04-1568-65/+65
|\ \ | | | | | | | | | | | | | | | | | | 9784834b4c Help: Use `*.rst` extension for included files Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10615
| * | Help: Use `*.rst` extension for included filesAlex Turbov2025-04-1368-65/+65
| | | | | | | | | | | | So, editor(s) can correctly highlight the RST syntax in the included files.
* | | Merge topic 'cmake-parent-list-file'Brad King2025-04-141-2/+8
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | | | | | | | | | | a9ea55f0d7 Fix CMAKE_PARENT_LIST_FILE after return from include() or find_package() 41708398eb cmMakefile: Factor out base class for list file scope RAII ce8be3da80 cmMakefile: De-duplicate CMAKE_CURRENT_LIST_FILE variable names 0b85f8f137 Tests: Add cases for CMAKE_PARENT_LIST_FILE with include() and find_package() 002979e145 Tests/RunCMake/include: Match incidental line numbers more robustly Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10505
| * | Fix CMAKE_PARENT_LIST_FILE after return from include() or find_package()Benjamin Buch2025-04-121-2/+8
| | | | | | | | | | | | | | | | | | | | | Fix the implementation, clarify the documentation, and add tests. Fixes: #25026 Co-authored-by: Brad King <brad.king@kitware.com>
* | | Merge topic 'doc-macos-usr-local'Brad King2025-04-101-0/+8
|\ \ \ | | |/ | |/| | | | | | | | | | | | | c69add958a Help: Add note about /usr/local/include on macOS without CMAKE_OSX_SYSROOT Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10636
| * | Help: Add note about /usr/local/include on macOS without CMAKE_OSX_SYSROOTBrad King2025-04-101-0/+8
| | | | | | | | | | | | Issue: #19180
* | | Merge topic 'iar-add-icstat-support'Brad King2025-04-101-0/+8
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | c7d2a17253 IAR: Add support for C-STAT static analysis Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !10624
| * | | IAR: Add support for C-STAT static analysisFelipe Torrezan2025-04-091-0/+8
| | |/ | |/| | | | | | | | | | | | | | | | The IAR platform offers an integrated static analysis tool named IAR C-STAT. Closes: #26844
* | | Merge topic 'doc-CMAKE_OSX_SYSROOT'Brad King2025-04-091-3/+8
|\ \ \ | |/ / |/| / | |/ | | | | | | 2164da0ae6 Help: Document CMAKE_OSX_SYSROOT default change in 4.0 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10623
| * Help: Document CMAKE_OSX_SYSROOT default change in 4.0Brad King2025-04-081-3/+8
| | | | | | | | | | | | | | | | In commit 7b19531291 (macOS: Do not pass any SDK/-isysroot to compilers by default, 2024-11-06, v4.0.0-rc1~511^2) we forgot to update the documentation of `CMAKE_OSX_SYSROOT`. Fixes: #26846
* | Merge topic 'patch-CMAKE_COMPILER_IS_GNU-docs'Brad King2025-04-013-9/+117
|\ \ | | | | | | | | | | | | | | | | | | 7db3f983b3 CMAKE_COMPILER_IS_*: Add RST deprecation directives and update docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10550
| * | CMAKE_COMPILER_IS_*: Add RST deprecation directives and update docsPeter Kokot2025-03-283-9/+117
| | | | | | | | | | | | | | | | | | | | | | | | The `CMAKE_COMPILER_IS_*` variables have been documented as deprecated since CMake 3.24, without emitting warnings. This commit updates their documentation to help users safely migrate to `CMAKE_<LANG>_COMPILER_ID` variables. Also a RST deprecation directive is added to clarify their status.
* | | Merge topic 'unity-relative-paths'Brad King2025-04-011-0/+9
|\ \ \ | | |/ | |/| | | | | | | | | | | | | | | | | | | f706d8064b Help: Clarify wording of UNITY_BUILD_RELOCATABLE path alternatives 20412690fb Help: Add 4.0 release note for UNITY_BUILD_RELOCATABLE 89cea1c642 Help: Document CMAKE_UNITY_BUILD_RELOCATABLE variable Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10570
| * | Help: Document CMAKE_UNITY_BUILD_RELOCATABLE variableBrad King2025-03-311-0/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | In commit 84996a65aa (Unity: Add option to use relative paths for unity files, 2024-10-15, v4.0.0-rc1~637^2) we added support for this variable to initialize the `UNITY_BUILD_RELOCATABLE` target property, but forgot to document it. Issue: #26352
* | | Merge topic 'iar-help-compiler-arch-id'Brad King2025-03-311-10/+10
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 775e532afb IAR: Update documentation for CMAKE_<LANG>_COMPILER_ARCHITECTURE_ID Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10548
| * | | IAR: Update documentation for CMAKE_<LANG>_COMPILER_ARCHITECTURE_IDFelipe Torrezan2025-03-281-10/+10
| | |/ | |/|
* | | Merge topic 'doc-4.0-release-cleanup'Craig Scott2025-03-306-8/+8
|\ \ \ | |/ / |/| / | |/ | | | | | | | | | | 5dff5e2f7f Help: Fix typo in 4.0 release notes for CPack archive generator 713968c280 Help: Improve wording of docs related to MSVC runtime checks 316aaa6cdd Help: Fix inaccurate wording for CMAKE_XCODE_SCHEME_... variables Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10545
| * Help: Fix inaccurate wording for CMAKE_XCODE_SCHEME_... variablesCraig Scott2025-03-286-8/+8
| |
* | Merge topic 'compiler-architecture-id'Brad King2025-03-271-4/+300
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 7f0f382c55 Provide CMAKE_<LANG>_COMPILER_ARCHITECTURE_ID on more compilers 019f0f8b32 ARCHITECTURE_ID: Save persistently even if empty 8e46672b29 Fortran: Detect pointer size on sparc architectures eddf66eaef CMakeDetermineASMCompiler: De-duplicate list of compiler info variables c0224f5aa1 CMakeDetermineCompilerABI: Make ABI info string more robust 67ab580804 Windows/Clang: Fix indentation in platform information module 1c9f8eeb4f Help: Document CMAKE_<LANG>_COMPILER_ARCHITECTURE_ID Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !10516
| * | Provide CMAKE_<LANG>_COMPILER_ARCHITECTURE_ID on more compilersBrad King2025-03-251-2/+140
| | | | | | | | | | | | | | | | | | | | | | | | | | | Provide it whenever we can detect a target architecture from the compiler during compiler inspection. In order to avoid changing existing IDs, do this only for compilers where we don't already detect a target architecture during compiler identification. Fixes: #17702
| * | Help: Document CMAKE_<LANG>_COMPILER_ARCHITECTURE_IDBrad King2025-03-241-4/+162
| | | | | | | | | | | | Issue: #17702
* | | Merge topic 'fix-CMAKE_PKG_CONFIG_PC_PATH-doc-typo-error'Brad King2025-03-271-1/+1
|\ \ \ | | |/ | |/| | | | | | | | | | | | | a57eec57e5 Help: Fix typo in CMAKE_PKG_CONFIG_PC_PATH docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10530
| * | Help: Fix typo in CMAKE_PKG_CONFIG_PC_PATH docs權少2025-03-261-1/+1
| | |
* | | Merge topic 'patch-CTEST_CVS_CHECKOUT'Brad King2025-03-251-2/+2
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 77d23eaa8f CTEST_CVS_CHECKOUT: Add deprecated directive to docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !10512
| * | | CTEST_CVS_CHECKOUT: Add deprecated directive to docsPeter Kokot2025-03-241-2/+2
| | |/ | |/| | | | | | | | | | This variable got introduced in CMake 2.4 and was documented as deprecated in CMake 3.1.