summaryrefslogtreecommitdiffstats
path: root/Help/variable
Commit message (Collapse)AuthorAgeFilesLines
* Experimental: Restore `import std` gateBrad King2026-02-263-3/+13
| | | | | | | | | | | | | | | | | | Several problems with this feature came up while testing 4.3.0-rc1. These include both broken stdlib distributions and regressions in our implementation of the feature since CMake 4.2. Revert commit 70c1f0f43d (Experimental: Remove import std experimental gate, 2026-02-04, v4.3.0-rc1~61^2) except for its incidental fixes. Remove the 4.3 release notes related to `import std`. Rotate the experimental gate's UUID. Issue: #27426 Issue: #27597 Issue: #27626 Issue: #27635
* Help: Tweak CMAKE_INSTALL_EXPORTS_AS_PACKAGE_INFOMatthew Woehlke2026-02-241-2/+4
| | | | | | | | The format example for CMAKE_INSTALL_EXPORTS_AS_PACKAGE_INFO is quite long and, in its prior state, was likely to force a line wrap before it, which could lead to non-optimal spacing of the preceding line. As there is no easy way to break in the middle of the example, instead break it out into a separate element.
* Merge topic 'remove-cps-experimental-gate'Brad King2026-02-136-41/+17
|\ | | | | | | | | | | | | | | f5c515cbf2 CPS: Remove experimental gate (mostly) Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !11683
| * CPS: Remove experimental gate (mostly)Matthew Woehlke2026-02-116-41/+17
| | | | | | | | | | | | | | | | Remove basic CPS import and export from 'experimental' status. Update documentation and tests accordingly. Note that mapped exports (CMAKE_EXPERIMENTAL_MAPPED_PACKAGE_INFO) are still experimental.
* | Merge topic 'doc-ctest-link'Brad King2026-02-1154-54/+54
|\ \ | |/ |/| | | | | | | | | | | 01a47a790b Help: Link `CTEST_*` variables to dashboard client 12a0ebe96a Help/CTest: Improve formatting and grammar Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !11677
| * Help: Link `CTEST_*` variables to dashboard clientTyler Yankee2026-02-1054-54/+54
| |
* | Experimental: Remove import std experimental gateVito Gamberini2026-02-073-13/+3
|/ | | | Fixes: #27571
* cmake: Add per-language link flags for all target typesTyler Yankee2026-02-012-0/+61
| | | | | | | | | | | | | | | | | Previously, `CMAKE_<LANG>_LINK_FLAGS` was an undocumented variable used for linking executables only. Re-spell that variable mirroring the existing spellings for shared and module libraries, and add policy CMP0210 to preserve compatibility. Then, repurpose `CMAKE_<LANG>_LINK_FLAGS` to provide a variable to be used for per-language link flags for all target types, along with a per-configuration variant. These are added to the `<LINK_FLAGS>` rule placeholder in the generators. Fixes: #21934 Relates: #25620 Co-authored-by: Brad King <brad.king@kitware.com>
* Help: Fix description of `CMAKE_*_LINKER_FLAGS` variablesTyler Yankee2026-01-296-8/+42
| | | | | | | | | | | | Improve the wording on the behavior of the per-configuration variants of `CMAKE_*_LINKER_FLAGS`. In particular, note that these variables only apply to the specified build configuration, and replace the ambiguous reference to `CMAKE_C_FLAGS_*` with a precise description. Clarify that the "default" variants of these variables apply for all build configurations. Add links between pages for the default and per-configuration variables.
* HIP: Add support for SPIR-V platformPaulius Velesko2026-01-202-0/+9
| | | | | | | Add `spirv` as a known value for `CMAKE_HIP_PLATFORM`. Default `CMAKE_HIP_ARCHITECTURES` to `OFF` for `spirv`. Fixes: #27410
* Merge topic 'pvs-analyze'Brad King2026-01-191-0/+15
|\ | | | | | | | | | | | | | | | | | | ef12ef1bd6 pvs-studio: Add support for linting with PVS-Studio 8f722e0fac cmList: Expose container reserve 5d1f269658 cmcmd: Allow passing object file to co_compile commands Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Alex Overchenko <aleksandr9809@gmail.com> Merge-request: !11323
| * pvs-studio: Add support for linting with PVS-StudioMartin Duffy2026-01-161-0/+15
| |
* | File sets: Add verification of private file setsCraig Scott2026-01-163-34/+54
|/ | | | | | | | | | | | | Add support for PRIVATE header sets, analogous to the existing INTERFACE header sets support. A key difference between the two is the way they handle build and usage requirements. INTERFACE header sets rely on the original target's INTERFACE, whereas PRIVATE header sets copy across various properties from the original target. Generated files need special handling for PRIVATE header sets. Add a dependency on the original target to the verification target to ensure such generated files will exist. Fixes: #23448
* Merge topic 'doc-cleanup-4.2'Craig Scott2025-12-241-3/+3
|\ | | | | | | | | | | | | | | a7fc57ed1c Help: Restore correct sort order for property and variable manuals e73307957e Help: Fix minor grammar problems Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !11546
| * Help: Fix minor grammar problemsCraig Scott2025-12-211-3/+3
| |
* | Merge topic 'emscripten-arch-id'Brad King2025-11-261-0/+6
|\ \ | |/ | | | | | | | | | | 5ec87b2ba7 Emscripten: Provide CMAKE_<LANG>_COMPILER_ARCHITECTURE_ID Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !11452
| * Emscripten: Provide CMAKE_<LANG>_COMPILER_ARCHITECTURE_IDBrad King2025-11-251-0/+6
| | | | | | | | | | | | | | | | | | Extend commit 96d9b94a98 (Emscripten: Add platform modules, 2025-05-16, v4.2.0-rc1~607^2~3) to account for commit 7f0f382c55 (Provide CMAKE_<LANG>_COMPILER_ARCHITECTURE_ID on more compilers, 2025-03-24, v4.1.0-rc1~499^2). Fixes: #27425
* | Merge topic 'autogen-tgt-intdir-strategy-docs'Brad King2025-11-191-0/+6
|\ \ | |/ | | | | | | | | | | 7d871d7857 Help/CMAKE_AUTOGEN_INTERMEDIATE_DIR_STRATEGY: document supported generators Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !11429
| * Help/CMAKE_AUTOGEN_INTERMEDIATE_DIR_STRATEGY: document supported generatorsBen Boeckel2025-11-181-0/+6
| | | | | | | | Fixes: #27388
| * Merge topic 'xcode-macos-deployment-target' into release-4.2Brad King2025-10-271-10/+34
| |\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | de53a46a91 Help: Add 4.1 release note for restored Xcode default deployment target 85ba6f5d1b Merge branch 'backport-4.0-xcode-macos-deployment-target' 884260ced6 Help: Add 4.0 release note for restored Xcode default deployment target 1a37c83c7e Xcode: Restore default CMAKE_OSX_DEPLOYMENT_TARGET to run on host e927408047 Apple: Initialize deployment target after SDK Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !11361
* | \ Merge topic 'package-info-from-install-export'Brad King2025-11-121-0/+122
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 34343922a5 install: Add ability to generate CPS from install(EXPORT) Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !11315
| * | | install: Add ability to generate CPS from install(EXPORT)Matthew Woehlke2025-11-111-0/+122
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add the ability to generate CPS package information when install(EXPORT) is used. This relies on additional information to be passed to CMake, and is intended as a way of getting CPS out of existing projects without needing to make changes to the projects' CMakeLists.txt. (Particularly, this feature is intended for package distributors, not project authors.)
* | | | GNUInstallDirs: Add notice about --prefix optionPeter Kokot2025-11-101-0/+18
|/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When setting the installation prefix at the installation phase (`cmake --install`) using the `--prefix` option, the GNU special cases aren't applicable. This also adds a small clarification when to use the `--prefix` option at the installation phase. Briefly mentioned also the CMake presets installDir field, the CPACK_PACKAGING_INSTALL_PREFIX variable, and the $<INSTALL_PREFIX> generator expression so user has a better overview. Fixes #27343 Fixes #26338
* | | CPack/Archive: Add support for setting UID/GID in archiveClinton Stimpson2025-11-081-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | Add `CPACK_ARCHIVE_UID` and `CPACK_ARCHIVE_GID` options. Add a policy to change the default to 0/0 to enable ownership by root if unpacking as root. Fixes: #12901
* | | CMAKE_ENABLE_EXPORTS: Deprecate variablePeter Kokot2025-11-043-6/+19
| | | | | | | | | | | | | | | | | | This makes it more clear which variable should be used. Fixes #27357
* | | Merge topic 'xcode-macos-deployment-target'Brad King2025-10-271-10/+34
|\ \ \ | |/ / |/| / | |/ | | | | | | | | | | | | | | de53a46a91 Help: Add 4.1 release note for restored Xcode default deployment target 85ba6f5d1b Merge branch 'backport-4.0-xcode-macos-deployment-target' 884260ced6 Help: Add 4.0 release note for restored Xcode default deployment target 1a37c83c7e Xcode: Restore default CMAKE_OSX_DEPLOYMENT_TARGET to run on host e927408047 Apple: Initialize deployment target after SDK Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !11361
| * 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
* | | FASTbuild: allow setting custom IDE argsEduard Voronkin2025-10-171-0/+17
| | | | | | | | | | | | | | | Allow users to set custom args when FBuild is invoked via IDE.
* | | Merge topic 'doc-apple-arch-default' into release-4.2Brad King2025-10-101-0/+4
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6055a12d36 Help: Document default architecture when CMAKE_OSX_ARCHITECTURES is not set Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: rumgot rumgotov <rumgot@gmail.com> Merge-request: !11296
| * | | Help: Document default architecture when CMAKE_OSX_ARCHITECTURES is not setBrad King2025-10-091-0/+4
| | | | | | | | | | | | | | | | Issue: #27293
* | | | Help: Update Sphinx versionadded directives for 4.2 releaseBrad King2025-10-0914-0/+28
|/ / / | | | | | | | | | | | | | | | Run the script: Utilities/Sphinx/update_versions.py --since v4.1.0 --overwrite
* | | Help: Document generators supporting CMAKE_INTERMEDIATE_DIR_STRATEGYBrad King2025-10-011-0/+6
| | | | | | | | | | | | Move this information from the release note to the actual docs.
* | | FASTBuild: expose more optionsEduard Voronkin2025-09-177-0/+55
| | | | | | | | | | | | Expose more options for compiler configuration as well as adding unit test
* | | Merge topic 'vs-ifx'Brad King2025-09-171-1/+8
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | eae0a053f5 VS: Default Intel Fortran projects to ifx in VS 18 and above Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !11197
| * | | VS: Default Intel Fortran projects to ifx in VS 18 and aboveBrad King2025-09-161-1/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Intel oneAPI distributions no longer include the `ifort` compiler, but its Visual Studio Integration defaults to `ifort` if `ifx` is not explicitly specified in the `.vfproj` file. We cannot change the default Fortran compiler in VS 17 and older, but since the VS 18 generator is new, we can establish `ifx` as its default. This establishes working defaults on new versions of VS and oneAPI while retaining existing behavior on older versions. Issue: #26415
* | | | Merge topic 'vs2026'Brad King2025-09-162-0/+2
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 47c784ba8a Help: Add release note for Visual Studio 18 2026 generator cd46d8ec84 Merge branch 'backport-vs2026' into vs2026 3392b371e2 VS: Add Visual Studio 18 2026 generator 7f0883ac04 VS: Remove unused generator code 6f0d245083 VS: Fix `/dynamicdeopt` flag table entry order for v145 toolset 398ce8af72 VS: Remove `/guard:cf` from v145 link flag table 5c9085d876 VS: Remove `/MERGE` from v145 link flag table fe5c78310c VS: Map the link `/debug` flag for v145 toolset ... Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !11168
| * \ \ \ Merge branch 'backport-vs2026' into vs2026Brad King2025-09-152-0/+2
| |\ \ \ \ | | |/ / /
| | * | | VS: Add Visual Studio 18 2026 generatorBrad King2025-09-152-0/+2
| | |/ / | | | | | | | | | | | | Closes: #27213
* | | | Merge topic 'cxxmodules-custom-import-std-metadata-file'Brad King2025-09-151-0/+11
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 85e536b5eb gitlab-ci: test `CMAKE_CXX_STDLIB_MODULES_JSON` in CI 42621a232b Tests/CXXModules: add a label 2f101b2c8c Tests/CXXModules: support testing with custom stdlib json locations 6c178a4ae3 Tests/RunCMake: add newlines in CXXModules options 2b85541e39 cxximportstd: support setting the `import std` metadata location Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !11175
| * | | | cxximportstd: support setting the `import std` metadata locationBen Boeckel2025-09-111-0/+11
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | Some deployments may not be able to discover the metadata file reliably (e.g., custom `clang` builds on macOS while using the SDK's stdlib or distribution bugs). Allow users to force the location so that compiler-driven detection doesn't have to bend over backwards for unforeseen bugs.
* | | | Merge topic 'fbuild_cache_path'Brad King2025-09-121-3/+4
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | f77628e0af FASTBuild: don't set default cache path Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !11157
| * | | FASTBuild: don't set default cache pathEduard Voronkin2025-09-111-3/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Leave only 2 option to set cache path: 1. CMake variable 2. Environment variable Update docs to reflect the changes.
* | | | Merge topic 'object-name-properties'Brad King2025-09-101-1/+2
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | b53837a1bd prop_sf/INSTALL_OBJECT_NAME: support custom install object names 08f1a0fbc6 cmLocalGenerator: get the configuration when building object paths 168e55be41 cmObjectLocation: support install-specific object locations 84372ce0b5 prop_sf/OBJECT_NAME: no-op for the FASTBuild and Xcode generators 9ef99353cb prop_sf/OBJECT_NAME: support custom object names 7aff0d37b5 cmSourceFile: add accessors for PCH source files bbdc2fd908 cmSourceFile: internally track CMake-managed source files 388923818d cmGeneratorTarget: return the source file added ... Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !11144
| * | | | prop_sf/OBJECT_NAME: support custom object namesBen Boeckel2025-09-091-1/+2
| |/ / / | | | | | | | | | | | | | | | | | | | | Projects which ship object files as artifacts may want to control the object names as much as possible. Support setting explicit object names as source file properties to support such use cases.
* | | | Merge topic 'target-SKIP_LINTING'Brad King2025-09-101-0/+9
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | f100769d72 Add `SKIP_LINTING` target property and `CMAKE_SKIP_LINTING` variable 0d6b5d54b2 Tests/RunCMake/MultiLint: Extract test preparation code into separate file 3a21092d75 Tests/RunCMake/MultiLint: Refactor test runs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !11139
| * | | Add `SKIP_LINTING` target property and `CMAKE_SKIP_LINTING` variableAlex Turbov2025-09-091-0/+9
| | | | | | | | | | | | | | | | | | | | | | | | These offer target-wide settings to disable lints. Closes: #27191
* | | | install: support using `DESTINATION` as-is for object installationBen Boeckel2025-09-061-0/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | CMake historically has forced an `objects[-<CONFIG>]/<TARGET_NAME>` subdirectory under an `OBJECT` library installation's `OBJECTS DESTINATION` which may be unwanted. Support skipping this component with a target property.
* | | | Help/CMAKE_INSTALL_OBJECT_NAME_STRATEGY: add `versionadded` directiveBen Boeckel2025-09-031-0/+2
|/ / /
* | | FASTBuild: Add generatorEduard Voronkin2025-08-267-0/+92
| | | | | | | | | | | | Fixes: #15294
generated by cgit v0.12 at 2026-04-04 20:17:45 (GMT)