summaryrefslogtreecommitdiffstats
path: root/Help/variable
Commit message (Collapse)AuthorAgeFilesLines
* Autogen: Add support for response files for moc predef targetstophoo2023-11-161-0/+10
| | | | | Add support for response files for moc predef targets and make the limit when to use response files for autogen targets configurable.
* install(EXPORT): Export find_dependency() callsKyle Edwards2023-11-131-0/+6
| | | | | | Issue: #20511 Co-Authored-by: Brad King <brad.king@kitware.com> Co-Authored-by: Robert Maynard <rmaynard@nvidia.com>
* Optionally make `test` target depend on `all`William Sciaroni2023-11-102-0/+21
| | | | Fixes: #8774
* Link Step: compute effective linker used by the compilerMarc Chevrier2023-10-244-0/+77
| | | | | | | | | | | | | | | Extract the effective linker during the computation of implicit artifacts delivered by the compiler to the linker. Define various variables describing the linker: * CMAKE_<LANG>_COMPILER_LINKER * CMAKE_<LANG>_COMPILER_LINKER_VERSION * CMAKE_<LANG>_COMPILER_LINKER_ID * CMAKE_<LANG>_COMPILER_LINKER_FRONTEND_VARIANT This is complementary to feature introduced by commit 96a953b1ed (Add options to specify linker tool, 2023-09-27). Fixes: #17596, #18209, #25344
* CMAKE_PROJECT_INCLUDE: Allow to run module filesCristian Le2023-10-185-4/+12
| | | | Signed-off-by: Cristian Le <cristian.le@mpsd.mpg.de>
* CMAKE_PROJECT_INCLUDE: Add support for including multiple filesCristian Le2023-10-184-4/+20
| | | | | Fixes: #25341 Signed-off-by: Cristian Le <cristian.le@mpsd.mpg.de>
* Add options to specify linker toolMarc Chevrier2023-10-134-0/+120
| | | | | | | | | | | | | | | | | | Offer the capability, through variable `CMAKE_LINKER_TYPE`, as well as the target property `LINKER_TYPE` to specify which linker must be used. The implementation of this capability is specified by variables specific to the language and linker type: `CMAKE_<LANG>_USING_LINKER_<TYPE>`. Some definitions are provided as part of `CMake`. For example, to select the `LLVM` linker rather than the standard one, the type `LLD` should be specified through the variable `CMAKE_LINKER_TYPE`. And, on `Apple`, `Linux` and some environments on `Windows`, the variable `CMAKE_<LANG>_USING_LINKER_LLD` has value `-fuse-ld=lld`. And for `Windows` environments based on `MSVC`, where the linker is used directly, the tool `lld-link.exe` will be used rather than `link.exe`. Fixes: #19174, #24254, #24990
* cmExperimental: remove the flag for C++ modulesBen Boeckel2023-10-021-6/+1
| | | | | | | All the major compilers now have scheduled releases with support for scanning, so remove the experimental gate. Fixes: #18355
* Merge topic 'misc-cxxmodule-fixes'Brad King2023-09-271-2/+4
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 3b632f32fa Tests/CXXModules: forward the default build type 5ab6b09691 Tests/CXXModules: fix multi-config and MSVC details 11b62ef118 Tests/CXXModules: add missing `bmi-only` and compiler id fields 5d9631fbdd Tests/CXXModules: fix key set mismatch error messages 86e7fb72cb Tests/CXXModules: use a less generic name for the config 6b940dc590 Tests/CXXModules: replace the object extension as well 1c9f83c8ec Tests/CXXModules: fix error detection propagation 7a4c02cb38 cmGlobalGenerator: factor out messaging for CMP0037 ... Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Acked-by: Pavel Solodovnikov <hellyeahdominate@gmail.com> Merge-request: !8834
| * Help/CMAKE_EXPORT_COMPILE_COMMANDS: mention the `output` fieldBen Boeckel2023-09-251-2/+4
| | | | | | | | | | Added in 887a8874c3 (EXPORT_COMPILE_COMMANDS: add `output` field, 2022-10-28) via !7844. Sync the docs with this addition.
* | Merge topic 'hip-nvidia'Brad King2023-09-262-31/+47
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | fd982eec10 HIP: Add tests for special NVIDIA values of CMAKE_HIP_ARCHITECTURES 8c8b3f1bfa HIP: Fix support for -DCMAKE_HIP_ARCHITECTURES=native with NVCC b3e92775ab HIP: Add CMAKE_HIP_HOST_COMPILER when compiler is NVCC e43918b4ca HIP: Fix linking mixed-lang binary with CXX compiler and Makefile generators 4794505122 HIP: Do not require hip-lang package for NVIDIA platform 09d759dc7f HIP: Simplify exclusion of AMD device runtime with NVIDIA GPUs 2a60663670 HIP: Simplify CMAKE_GENERATOR references for determining compiler 8124950f6c CUDA: Generalize CMAKE_{CUDA => <LANG>}_HOST_COMPILER variable docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8836
| * | HIP: Add CMAKE_HIP_HOST_COMPILER when compiler is NVCCBrad King2023-09-251-5/+8
| | | | | | | | | | | | Also add `HIPHOSTCXX` environment variable.
| * | CUDA: Generalize CMAKE_{CUDA => <LANG>}_HOST_COMPILER variable docsBrad King2023-09-252-31/+44
| | |
* | | OrangeC: Add support for OrangeC compilerDavid Lindauer2023-09-251-0/+2
|/ / | | | | | | | | | | | | Add compiler information modules. Update the test suite. Fixes: #25032 Co-authored-by: Brad King <brad.king@kitware.com>
* | CrayClang: Add support for this compilerRyan Krattiger2023-09-221-0/+1
|/ | | | | | Add `CrayClang` compiler ID for newer Cray compilers. Fixes: #25102
* Merge topic 'hip-nvidia'Brad King2023-09-222-3/+29
|\ | | | | | | | | | | | | | | | | | | | | | | | | 6546aa2a2a ci: Add HIP job using CUDA on NVIDIA GPUs 18158bf81c HIP: Add support for NVIDIA GPUs 127b6fa06b HIP: Add CMAKE_HIP_PLATFORM variable to specify GPU platform 90e23f40ee Tests/HIP/WithDefs: Clean up test case 9ebdf3281f Tests/HIP/ArchitectureOff: Cover HIP_ARCHITECTURES initialization cfec29196e ci: Add CUDA 11.8 to HIP 5.5 image 26470eb987 ci: Put HIP GPU platform in CMake_TEST_HIP Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8817
| * HIP: Add support for NVIDIA GPUsBrad King2023-09-211-1/+4
| | | | | | | | | | | | Add support for using the CUDA Toolkit's NVCC to compile HIP code. Fixes: #25143
| * HIP: Add CMAKE_HIP_PLATFORM variable to specify GPU platformBrad King2023-09-212-3/+26
| | | | | | | | | | For now, require the value to be `amd`, since that is the only platform we currently support.
* | Help: Clarify requirements for find_package to use lib{64,32,x32} pathsBrad King2023-09-201-2/+2
|/ | | | Issue: #25157
* MinGW: Search for packages in standard MSYSTEM environment prefixesBrad King2023-09-131-0/+6
| | | | | | | | | | | | | | | | MSYS2 and similar MinGW/MSYS distributions define development environments with a `MSYSTEM` environment variable. Each such environment has a documented installation prefix for its packages, often provided by a `MSYSTEM_PREFIX` environment variable. Since commit 84a25fc263 (cmake_host_system_information: Add MSYSTEM_PREFIX query, 2023-09-08) we can look up this prefix. Add `$MSYSTEM_PREFIX/local` and `$MSYSTEM_PREFIX` to our system search prefixes when targeting MinGW under `MSYSTEM` environments. This is their equivalent to `/usr/local` and `/usr`, which we search by default on UNIX systems. Issue: #24216
* Xcode: reject legacy buildsystem for Xcode 14Gregor Jasny2023-08-311-1/+2
| | | | | | | | | | | With Xcode 14 support for the Legacy Build System has been removed and the BuildSystemType in the WorkspaceSettings is ignored. If CMake still generates projects targeted to the Lecacy Build System the build preparation phase will likely fail because Xcode for example misses any declared outputs from script invocations. This is a hard to debug problem and CMake should reject the invalid configuration instead.
* Help:ENV: note escaping needed for special charactersscivision2023-08-171-0/+11
|
* Merge branch 'backport-vs-sdk-selection' into vs-sdk-selectionBrad King2023-08-101-1/+5
|\
| * VS: Teach CMAKE_GENERATOR_PLATFORM to support Windows 8.1 SDK selectionBrad King2023-08-101-0/+4
| | | | | | | | | | | | | | Honor an explicit `version=8.1` field value regardless of the Windows target version. Issue: #25170
| * VS: Teach CMAKE_GENERATOR_PLATFORM to use Windows 10 SDKs for older versionsBrad King2023-08-101-1/+1
| | | | | | | | | | | | | | Honor an explicit `version=` field selecting a Windows 10 SDK regardless of the Windows target version. Issue: #25170
* | Merge topic 'doc-fixups-release-3.27'Craig Scott2023-08-072-6/+9
|\ \ | |/ | | | | | | | | | | | | | | | | 78e7ea598d cmLocalGenerator: Fix trivial spelling error in code comment 1285fe27ff Help: Improve formatting and fix wording for ENABLE_EXPORTS 91336d061c Help: Improve formatting and cross-references for DEPENDS_EXPLICIT_ONLY 03208d9e18 Help: Fix indenting within TARGET_RUNTIME_DLLS genex docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8688
| * Help: Improve formatting and fix wording for ENABLE_EXPORTSCraig Scott2023-08-061-3/+4
| |
| * Help: Improve formatting and cross-references for DEPENDS_EXPLICIT_ONLYCraig Scott2023-08-041-3/+5
| |
* | Help: Explicitly note that projects should not set CMAKE_CUDA_HOST_COMPILERBrad King2023-07-311-0/+7
| | | | | | | | Issue: #25093
* | Help: Document IOS_INSTALL_COMBINED as deprecatedMárton Marczell2023-07-201-0/+3
| | | | | | | | | | | | | | The approach has not made sense since the introduction of Apple Silicon and macOS arm64. Issue: #24957
* | apple: add preliminary visionOS supportGregor Jasny2023-07-113-3/+3
| |
* | Merge topic 'link-depends-is-OFF'Brad King2023-06-261-0/+8
|\ \ | |/ | | | | | | | | | | | | 5945a98ced link dependencies: deactivate the feature Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8587
| * link dependencies: deactivate the featureMarc Chevrier2023-06-231-0/+8
| | | | | | | | | | | | | | Unfortunately it breaks in combination with LTO due to a bug in the GNU linker. Fixes: #25014
* | Merge topic 'cross-compiling-emulator-env-var'Brad King2023-06-141-0/+4
|\ \ | | | | | | | | | | | | | | | | | | | | | 7005dea005 CrossCompiling: Load CMAKE_CROSSCOMPILING_EMULATOR from environment Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !8543
| * | CrossCompiling: Load CMAKE_CROSSCOMPILING_EMULATOR from environmentMatt McCormick2023-06-131-0/+4
| |/ | | | | | | | | | | | | | | | | | | | | Read `CMAKE_CROSSCOMPILING_EMULATOR` from an environment variable of the same name if not specified with `-D` or an initial cache value. Along with existing environment variable settings such as `CMAKE_TOOLCHAIN_FILE`, cross compilation configuration can be more completely set via environment variables. Suggested-by: Henry Schreiner <henryschreineriii@gmail.com>
* | Drop Visual Studio 11 2012 generatorBrad King2023-06-133-3/+3
|/ | | | This generator has been deprecated since CMake 3.25. Remove it.
* Optionally exclude implicit link directories via environmentBrad King2023-05-251-1/+6
| | | | | | | | A misconfigured compiler may pass extraneous implicit link directories to its linker. If they are in `CMAKE_<LANG>_IMPLICIT_LINK_DIRECTORIES`, CMake may generate extra `-L` flags on mixed-language link lines that break linking. Add an environment variable that users can set to work around such misconfiguration of their compilers.
* Help: Clarify meaning of MINGW variableBrad King2023-05-191-2/+3
| | | | Fixes: #24928
* Merge topic 'use-linker-depfile'Brad King2023-05-041-0/+12
|\ | | | | | | | | | | | | | | 375e6fdbbe Link step: use linker dependency linker file 24a3e5cda0 cmLocalGenerator::MayBeRelativeToWorkDir: take care of all cases Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8443
| * Link step: use linker dependency linker fileMarc Chevrier2023-05-031-0/+12
| | | | | | | | | | | | Based on work done by @ben.boeckel (!8051) Fixes: #22217
* | Merge topic 'autogen-system-include'Brad King2023-05-041-0/+10
|\ \ | |/ |/| | | | | | | | | | | | | | | 7bf4e30090 Autogen: Default AUTOGEN_USE_SYSTEM_INCLUDE to ON if it is not set 033dc7ee2f Autogen: Add AUTOGEN_USE_SYSTEM_INCLUDE target property 8ba16db163 Tests/RunCMake: Add option for dynamic expected output Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8400
| * Autogen: Add AUTOGEN_USE_SYSTEM_INCLUDE target propertyOrkun Tokdemir2023-05-031-0/+10
| | | | | | | | | | | | | | `AUTOGEN_USE_SYSTEM_INCLUDE` was added. `AUTOGEN_USE_SYSTEM_INCLUDE` is a boolean property that can be set on a target to indicate that the autogen target include directory should be added as a system include directory or normal include directory to the target.
* | Merge topic 'vs-debugger-init'Brad King2023-05-024-0/+32
|\ \ | | | | | | | | | | | | | | | | | | 35566b48b4 VS: Add variables to initialize debugger-related properties Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8445
| * | VS: Add variables to initialize debugger-related propertiesAlex Neundorf2023-05-014-0/+32
| |/ | | | | | | | | | | Add variables to initialize target properties `VS_DEBUGGER_COMMAND`, `VS_DEBUGGER_COMMAND_ARGUMENTS`, `VS_DEBUGGER_ENVIRONMENT`, and `VS_DEBUGGER_WORKING_DIRECTORY`.
* | Merge topic 'doc-xref-find-env-vars'Brad King2023-05-026-6/+28
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | c584882b26 Help: change links to point to the env.vars, not to the cmake vars e40d4eb644 Help: add documentation for some CMAKE_XXX_PATH env.vars 73ce0b792f Help: minor improvement for the CMAKE_PREFIX_PATH docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8444
| * | Help: add documentation for some CMAKE_XXX_PATH env.varsAlex Neundorf2023-05-016-7/+26
| | | | | | | | | | | | | | | | | | | | | This patch adds basic documentation for the CMAKE_INCLUDE_PATH, CMAKE_LIBRARY_PATH, CMAKE_PROGRAM_PATH, CMAKE_APPBUNDLE_PATH and CMAKE_FRAMEWORK_PATH environment variables and links to the respective cmake variables and vice versa.
| * | Help: minor improvement for the CMAKE_PREFIX_PATH docsAlex Neundorf2023-04-291-0/+3
| |/ | | | | | | | | With this patch the CMAKE_PREFIX_PATH env. var. is now mentioned in the help for the CMAKE_PREFIX_PATH cmake var.
* | Help: Remove outdated link to Absoft FortranBrad King2023-05-011-2/+1
|/ | | | | | | | Absoft ceased operations on 2022-09-22 [1] [2]. The website is no longer available. [1] https://web.archive.org/web/20220816070730/https://www.absoft.com/ [2] https://fortran-lang.discourse.group/t/4274
* VS: Select Windows SDK matching WindowsSDKVersion env varBrad King2023-04-051-0/+8
| | | | | | | | | | In an environment established by `vcvarsall.bat` or similar, this environment variable may be set to select a Windows SDK version. If the VS generator is used in such an environment, use that SDK. This is similar to how `CMAKE_GENERATOR_INSTANCE` defaults using a `VS##0COMNTOOLS` environment variable. Fixes: #17992
* VS: Select latest available Windows SDK version by defaultBrad King2023-04-051-0/+3
| | | | | | | Add policy `CMP0149` to stop preferring SDKs exactly matching `CMAKE_SYSTEM_VERSION` over the latest SDK. Fixes: #16202