summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* Help: Add build and test preset to examples in cmake-presets(7)Michael Hirsch2021-02-181-2/+16
| | | | Co-Author: Brad King <brad.king@kitware.com>
* Help: Clarify preset name conflict rules in cmake-presets(7)Michael Hirsch2021-02-181-8/+9
|
* Merge topic 'preset-json-comments' into release-3.20Brad King2021-02-181-1/+4
|\ | | | | | | | | | | | | 8f1e607ed9 Help: Document JSON comment support in cmake-presets(7) Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5830
| * Help: Document JSON comment support in cmake-presets(7)Michael Hirsch2021-02-181-1/+4
| |
* | Help: Clarify role of binaryDir inheritance in cmake-presets(7)Brad King2021-02-181-4/+6
| | | | | | | | Suggested-by: Michael Hirsch
* | Help: Link to tool-specific preset arguments from cmake-presets(7)Brad King2021-02-182-6/+9
| | | | | | | | Fixes: #21835
* | Help: Mention version 2 in cmake-presets(7)Brad King2021-02-181-2/+5
|/ | | | | | Version 2 is required for build and test presets. Fixes: #21829
* presets: Remove unintended rerunFailed option from test presetsSam Freed2021-02-151-5/+0
| | | | | | | This was accidentally included after discussion in #21391 had decided to leave it out. It was never included in a release. Issue: #21391
* AddFileDependencies: Deprecate this unnecessary moduleBrad King2021-02-081-1/+1
| | | | Document that one can call `set_property` directly instead.
* Help: Add documentation for buildPresets and testPresetsSam Freed2021-02-013-4/+523
|
* Help: Add buildPresets and testPresets to JSON schemaSam Freed2021-01-271-13/+472
|
* Help: Convert genex documentation to sphinx domain objectsBrad King2021-01-181-102/+282
| | | | This makes them linkable, indexed, and enables cross-references.
* Help: Remove extra blank line from cmake-generator-expressions(7)Brad King2021-01-181-1/+0
|
* Help: Fix layout of architecture/toolset fields in cmake-presets(7) manualBrad King2021-01-141-2/+1
| | | | | | | These two fields share common documentation and so should be a single entry in the definition list. Fixes: #21642
* Help: Add section heading for configure presets in cmake-presets(7)Brad King2021-01-141-149/+154
| | | | | | Cross-reference it from the main `configurePresets` field. This removes an extra layer of indentation and makes the section linkable.
* Help: Add section heading for macro expansion in cmake-presets(7)Brad King2021-01-141-5/+8
| | | | Also cross-reference it from the prose.
* Help: Remove unnecessary indentation in cmake-presets(7)Brad King2021-01-141-226/+226
| | | | The entire "Format" section had an extra 2 spaces of indentation.
* Merge topic 'fileapi-toolchains'Brad King2021-01-141-0/+157
|\ | | | | | | | | | | | | | | | | | | 6418dabb87 Tests: Add test for toolchains-v1 File API object 1c5bd1bed5 Tests: Add toolchains kind to capabilities test f72bb2ee0d Help: Add documentation for "toolchains" object kind bb069c0857 cmFileAPI: Add "toolchains" object kind. Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5678
| * Tests: Add test for toolchains-v1 File API objectBen McMorran2021-01-121-54/+45
| |
| * Help: Add documentation for "toolchains" object kindBen McMorran2021-01-121-0/+166
| |
* | Help: Clarify standard module variable namingAnakin Skywalker2021-01-121-43/+93
| | | | | | Co-Authored-By: Craig Scott <craig.scott@crascit.com>
* | CMAKE_EXPORT_COMPILE_COMMANDS: allow configuration per targetShannon Booth2021-01-051-0/+1
|/ | | | | | | | The new target property `EXPORT_COMPILE_COMMANDS` associated with the existing global variable can be used to optionally configure targets for their compile commands to be exported. Fixes: #19462
* Merge topic 'ctest-test-dir'Brad King2020-12-211-0/+3
|\ | | | | | | | | | | | | dbcf86d24d Ctest: Support build tree on command line Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5623
| * Ctest: Support build tree on command lineAsit Dhal2020-12-171-0/+3
| | | | | | | | Fixes: #21268
* | Merge topic 'qt-autogen-per-config'Brad King2020-12-171-2/+5
|\ \ | |/ |/| | | | | | | | | | | | | 20e4db4a66 cmGeneratorTarget: Make GetConfigCommonSourceFiles Xcode-specific 92d7b456e5 Autogen: Add support for per-config sources 3ffebbaefb Tests/QtAutogen: Forward build configuration in multi-config generators Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5624
| * Autogen: Add support for per-config sourcesBrad King2020-12-161-2/+5
| | | | | | | | Fixes: #20682
* | Merge topic 'unity-anon-ns'Craig Scott2020-12-162-0/+2
|\ \ | |/ |/| | | | | | | | | 0fe9c40494 Unity Build: Add option for generating per-file unique id Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4784
| * Unity Build: Add option for generating per-file unique idStephen Kelly2020-12-152-0/+2
| | | | | | | | Fixes: #21477
* | Merge topic 'custom-command-output-genex-nmc'Brad King2020-12-161-0/+18
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 1526ae3aba Tests: Add cases for Ninja Multi-Config cross-config custom commands dcf9f4d2f7 Ninja Multi-Config: Add support for cross-config custom commands 15467f12f7 cmLocalGenerator: Adopt custom target 'force' output name generation 7b64b0cd5a cmLocalGenerator: Refactor custom command generator construction d29da8ed3e cmMakefile: Simplify custom target 'force' output name generation 2b1cc175ee Help: Clarify version adding add_custom_{command,target} OUTPUT genex support Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5612
| * | Ninja Multi-Config: Add support for cross-config custom commandsKyle Edwards2020-12-151-0/+18
| |/ | | | | | | Co-Author: Brad King <brad.king@kitware.com>
* | Merge topic 'ispc_control_header_suffixes'Brad King2020-12-152-0/+2
|\ \ | |/ |/| | | | | | | | | c9a50f3556 ISPC: Generated Headers suffix configurable with a better default Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5597
| * ISPC: Generated Headers suffix configurable with a better defaultRobert Maynard2020-12-142-0/+2
| | | | | | | | | | | | | | | | | | The target property `ISPC_HEADER_SUFFIX` and associated global variable now can control the suffix used when generating the C/C++ interoperability ISPC headers. In addition the default suffix is now "_ispc.h" which matches the common convention that the ISPC compiler team uses and recommends.
| * Merge topic 'apple-silicon-host-arch' into release-3.19Brad King2020-12-112-0/+2
| |\ | | | | | | | | | | | | | | | | | | | | | b7f0327dcd Tests: Cover macOS host architecture selection on Apple Silicon hosts 5f882f6ce5 macOS: Offer control over host architecture on Apple Silicon hosts Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5589
* | \ Merge topic 'apple-silicon-host-arch'Brad King2020-12-112-0/+2
|\ \ \ | | |/ | |/| | | | | | | | | | | | | | | | b7f0327dcd Tests: Cover macOS host architecture selection on Apple Silicon hosts 5f882f6ce5 macOS: Offer control over host architecture on Apple Silicon hosts Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5589
| * | macOS: Offer control over host architecture on Apple Silicon hostsBrad King2020-12-102-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since commit b6c60f14b6 (macOS: Default to arm64 architecture on Apple Silicon hosts, 2020-09-28, v3.19.0-rc1~63^2) we use `sysctl` to detect that we are running on Apple Silicon in a way that pierces Rosetta. This always sets `CMAKE_HOST_SYSTEM_PROCESSOR` to be `arm64` on such hosts. However, macOS offers strong support for running processes under an emulated `x86_64` architecture. Teach CMake to select either `arm64` or `x86_64` as the host architecture on Apple Silicon based on the architecture of its own process. When CMake is built as a universal binary, macOS will select whichever slice (architecture) is appropriate under the user's shell, and `CMAKE_HOST_SYSTEM_PROCESSOR` will match. Also offer a `CMAKE_APPLE_SILICON_PROCESSOR` variable and environment variable to provide users with explicit control over the host architecture selection regardless of CMake's own architecture. Finally, if `CMAKE_OSX_ARCHITECTURES` is not set, pass explicit flags to the toolchain to use selected host architecture instead of letting the toolchain pick. Fixes: #21554
* | | Merge branch 'master' into doc-3_19_release-fixesBrad King2020-12-1110-745/+34
|\ \ \ | |_|/ |/| |
| * | Merge topic 'android-docs'Brad King2020-12-091-2/+2
| |\ \ | | | | | | | | | | | | | | | | | | | | | | | | 1a4b1cca1c Android: update documentation for NDK integration Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5586
| | * | Android: update documentation for NDK integrationHaibo Huang2020-12-081-2/+2
| | | |
| * | | Merge topic 'update_cmp112'Brad King2020-12-081-0/+3
| |\ \ \ | | |/ / | |/| | | | | | | | | | | | | | | | | | cf0c71dae3 Document CMP0112 covers $<TARGET_FILE_NAME,tgt> Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5582
| * | | WriteCompilerDetectionHeader: Add policy to remove moduleBrad King2020-12-053-1/+4
| | | | | | | | | | | | | | | | | | | | | | | | See justification in the policy documentation. Closes: #17842
| * | | Help: Move Documentation module to list of deprecated modulesBrad King2020-12-041-1/+1
| | | | | | | | | | | | | | | | | | | | The module has been deprecated since commit 306a1ba960 (Modules/Documentation: remove, 2020-04-16, v3.18.0-rc1~290^2).
| * | | Merge topic 'explicit-LANGUAGE-flag'Brad King2020-12-041-0/+1
| |\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 48aac247e9 Compile with explicit language flag when source LANGUAGE property is set 2e67a75acd Embarcadero: Simplify addition of -P flag for C++ Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5522
| | * | | Compile with explicit language flag when source LANGUAGE property is setBrad King2020-12-021-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This change was originally made by commit 74b1c9fc8e (Explicitly specify language flag when source LANGUAGE property is set, 2020-06-01, v3.19.0-rc1~722^2), but it was reverted by commit 30aa715fac (Revert "specify language flag when source LANGUAGE property is set", 2020-11-19) to restore compatibility with pre-3.19 behavior. Implement the change again, but add policy CMP0119 to make this change while preserving compatibility with existing projects. Note that the `Compiler/{Clang,Intel,MSVC}-CXX` modules do not need to specify `-TP` for their MSVC-like variants because we already use the flag in `CMAKE_CXX_COMPILE_OBJECT`. Similarly for `Compiler/XL-CXX` and `Platform/Windows-Embarcadero`. Note also that this does not seem possible to implement for XL C. Even with `-qsourcetype=c`, `xlc` complains about an unknown suffix: `1501-218 (W) file /.../AltExtC.zzz contains an incorrect file suffix`. It returns non-zero even with `-qsuppress=1501-218`. Co-Author: Robert Maynard <robert.maynard@kitware.com> Fixes: #14516, #20716
| * | | | Merge topic 'cuda_env_archs'Brad King2020-12-011-0/+1
| |\ \ \ \ | | |/ / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | c57541d874 CUDA: Fix tests with CUDAARCHS set c4ae9384ff CUDA: Initialize CMAKE_CUDA_ARCHITECTURES using $ENV{CUDAARCHS} Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5533
| | * | | CUDA: Initialize CMAKE_CUDA_ARCHITECTURES using $ENV{CUDAARCHS}Raul Tambre2020-11-301-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | NVCC's default architecture may be newer than the one supported by the machine's GPU. In such cases it's useful to have an environment variable for initializing CMAKE_CUDA_ARCHITECTURES to avoid specifying it for every invocation.
| * | | | Merge topic 'makefiles-compiler-deps-optims'Brad King2020-11-301-0/+1
| |\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2c71d051fa Makefiles Generators: use compiler for dependencies generation afd0f6785d Refactoring: Abstract Makefile line continuation format b6068ce407 Refactoring: enhance include file filtering 3401403f69 Refactoring: Introduce place-holder for dependency target. a97c41bf8b Refactoring: Makefiles Generators: Add support for various depends scanners Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Brad King <brad.king@kitware.com> Merge-request: !5528
| | * | | | Makefiles Generators: use compiler for dependencies generationMarc Chevrier2020-11-291-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Each source compilation generates a dependencies file. These dependencies files are consolidated in one file per target. This consolidation is done as part of command 'cmake -E cmake_depends` launched before evaluation of makefile dependency graph. The consolidation uses the same approach as `CMake` dependencies management. Fixes: #21321
| * | | | | Merge topic 'make-GENERATED-visible-from-any-scope'Brad King2020-11-301-0/+1
| |\ \ \ \ \ | | |_|/ / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 573d51201a GENERATED prop: Set CMP0118 to NEW for some (unrelated) tests 6624b65b3f GENERATED prop: Add implementation for policy CMP0118 being set to NEW b14fe704f8 GENERATED prop: Simplify determining the language of a source file ca4ce458a3 GENERATED prop: Check CMP0118 policy and warn in certain situations 0eb30f175e GENERATED prop: Introducing policy CMP0118 and its documentation 78c8d95605 GENERATED prop: Add some tests before introducing changes with CMP0118 e01527619f Simplify code by calling a function directly instead of duplicating it 75cb8615e9 Fix typo in function name Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5308
| | * | | | GENERATED prop: Introducing policy CMP0118 and its documentationDeniz Bahadir2020-11-241-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Note: This is currently only defining the CMP0118 policy and providing its documentation, however, the implementation is still not using it.
| * | | | | Merge topic 'xcode-embed-frameworks'Craig Scott2020-11-291-0/+4
| |\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5651901c54 Xcode: add support for embedding frameworks Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Cameron Lowell Palmer <cameron.palmer@icloud.com> Merge-request: !5418