summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* WriteCompilerDetectionHeader: Add policy to remove moduleBrad King2020-12-055-1/+56
| | | | | | 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-044-1/+49
|\ | | | | | | | | | | | | | | 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-024-1/+49
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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 'versionadded'Brad King2020-12-0315-28/+39
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5000f93a91 Help: Fix grammar in `.. versionadded` directives 8fea95319b Help: Add `.. versionadded` directives to module docs 8634561dca Help: Improve formatting for FindBoost and FindCUDA ea59b0cd34 Help: Fix version note for CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE 05c3060b10 Help: Fix cmake_parse_arguments version note dafcef8b50 Help: Improve styling for versionadded/deprecated directives 6ae216daef Tests: Make RunCMake.CMP0106 expected output robust to line number changes Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5560
| * | Help: Fix grammar in `.. versionadded` directivesNikita Nemkin2020-12-0212-23/+24
| | | | | | | | | | | | Issue: #19715
| * | Help: Add `.. versionadded` directives to module docsNikita Nemkin2020-12-022-2/+9
| | | | | | | | | | | | Issue: #19715
| * | Help: Fix version note for CMAKE_PROJECT_<PROJECT-NAME>_INCLUDENikita Nemkin2020-12-021-2/+3
| | | | | | | | | | | | | | | | | | This variable predates 3.0. Fixes: #21522
| * | Help: Fix cmake_parse_arguments version noteNikita Nemkin2020-12-021-2/+4
| | | | | | | | | | | | Don't imply that cmake_parse_arguments() requires CMake 3.5+.
* | | Merge topic 'cpackifw-package-wizard-show-page-list'Brad King2020-12-022-0/+13
|\ \ \ | |/ / |/| | | | | | | | | | | | | | 8b5a0e0fef CPackIFW: Add CPACK_IFW_PACKAGE_WIZARD_SHOW_PAGE_LIST variable Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5545
| * | CPackIFW: Add CPACK_IFW_PACKAGE_WIZARD_SHOW_PAGE_LIST variableKonstantin Podsvirov2020-11-272-0/+13
| | | | | | | | | | | | | | | | | | Add CPACK_IFW_PACKAGE_WIZARD_SHOW_PAGE_LIST variable to control visibility of the widget listing installer pages on the left side of the wizard. This feature available only since QtIFW 4.0.
* | | Merge topic 'cuda_env_archs'Brad King2020-12-014-1/+22
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-304-1/+22
| | | | | | | | | | | | | | | | | | | | | | | | | | | | 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 'compile_def_doc'Brad King2020-12-011-0/+9
|\ \ \ \ | |_|_|/ |/| | | | | | | | | | | | | | | | | | | 4b9fcadc9a Help: Describe definition values in target_compile_definitions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5547
| * | | Help: Describe definition values in target_compile_definitionsJuan Ramos2020-11-301-0/+9
| | |/ | |/| | | | | | | Fixes: #20573
* | | Merge topic 'makefiles-compiler-deps-optims'Brad King2020-11-303-0/+15
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-293-0/+15
| |/ / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-308-0/+56
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-248-0/+56
| | | | | | | | | | | | | | | 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-301-0/+9
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 7c7b879e1f Help: Add missing release note for XCODE_EMBED_* Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5550
| * | | Help: Add missing release note for XCODE_EMBED_*Craig Scott2020-11-291-0/+9
| | | | | | | | | | | | | | | | | | | | In 5651901c54 (Xcode: add support for embedding frameworks, 2020-10-24) we neglected to add a release note for the new target properties that were added.
* | | | Merge topic 'xcode-embed-frameworks'Craig Scott2020-11-295-0/+43
|\ \ \ \ | |/ / / | | | | | | | | | | | | | | | | | | | | | | | | 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
| * | | Xcode: add support for embedding frameworksGusts Kaksis2020-11-285-0/+43
| | |/ | |/| | | | | | | | | | | | | This commit also prepares for embedding things other than frameworks. In the future, we may want to embed resources and other types supported by Xcode, so the target properties have been documented in a way that clearly signals the future intent.
* | | Merge topic 'presets-docs-bug'Craig Scott2020-11-291-1/+1
|\ \ \ | |/ / |/| | | | | | | | | | | | | | ca289abea5 Help: Fix presets typo (longDescription to displayName) Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5541
| * | Help: Fix presets typo (longDescription to displayName)Sam Freed2020-11-281-1/+1
| | |
| * | Merge topic 'ctest_custom_versions' into release-3.19Brad King2020-11-2317-34/+0
| |\ \ | | | | | | | | | | | | | | | | | | | | | | | | 6e7625989c Help: Fix `.. versionadded` directives for CTEST_CUSTOM_* variables Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5524
* | | | Help/dev: Add a CMake Experimental Features GuideBrad King2020-11-242-0/+12
| | | | | | | | | | | | | | | | | | | | | | | | Initialize it with placeholder content. This document will serve to contain documentation for experimental features that are under development and not yet included in official documentation.
* | | | Merge topic 'doc-removed-UseJava-modules'Brad King2020-11-233-0/+14
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 51ee82ddc6 Help: Restore documentation placeholder for removed modules Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5523
| * | | | Help: Restore documentation placeholder for removed modulesBrad King2020-11-203-0/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In commit cb28d9af1f (UseJava: Move helper scripts to subdirectory, 2020-11-12) we removed modules that were not meant to be documented publicly. In order to keep links from older versions on `cmake.org` to the "latest" documentation working for those modules, add placeholder documents describing the change.
* | | | | Merge topic 'ctest_custom_versions'Brad King2020-11-2317-34/+0
|\ \ \ \ \ | | |_|/ / | |/| | | | | | | | | | | | | | | | | | | | | | | 6e7625989c Help: Fix `.. versionadded` directives for CTEST_CUSTOM_* variables Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5524
| * | | | Help: Fix `.. versionadded` directives for CTEST_CUSTOM_* variablesNikita Nemkin2020-11-2117-34/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | CTEST_CUSTOM_* variables predate 3.0, but the docs were only added in 3.4. Issue: #19715
* | | | | Merge topic 'cuda_11'Brad King2020-11-231-0/+2
|\ \ \ \ \ | |_|/ / / |/| | / / | | |/ / | |/| | | | | | | | | | | | | | 046e454fdd CUDA: Error if can't determine toolkit library root 440dc98b07 CUDA: Clang CUDA 11.1 support Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5525
| * | | CUDA: Clang CUDA 11.1 supportRaul Tambre2020-11-221-0/+2
| |/ / | | | | | | | | | | | | | | | | | | | | | | | | version.txt is gone from CUDA 11.1 installations, but the rest is the same. Instead of looking for version.txt look for <CUDA path>/nvvm/libdevice, which is the main thing that Clang requires (though it also checks for the existence of bin and include). Fixes #21353.
* | | Merge topic 'revert-explicit-LANGUAGE-flag'Brad King2020-11-201-0/+16
|\ \ \ | |/ / | | | | | | | | | | | | | | | 30aa715fac Revert "specify language flag when source LANGUAGE property is set" Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5519
| * | Revert "specify language flag when source LANGUAGE property is set"Brad King2020-11-191-0/+16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Revert commit 74b1c9fc8e (Explicitly specify language flag when source LANGUAGE property is set, 2020-06-01, v3.19.0-rc1~722^2) and the lookup tables from its two immediate ancestors. The purpose of that change was to convert an explicit `LANGUAGE` source file property into an explicit language specification compiler flag like `-x c`. This seems reasonable since the property is documented as meaning "indicate what programming language the source file is". It is also needed to help compilers deal with non-standard source file extensions they don't recognize. However, some projects have been setting `LANGUAGE C` on `.S` assembler source files to mean "use the C compiler". Passing `-x c` for them breaks the build because the `.S` sources are not written in C. These projects should be updated to use `enable_language(ASM)`, for which CMake often chooses the C compiler as the assembler when using toolchains that support it (which would have to be the case for projects using the approach). Revert the change for now to preserve the old behavior for such projects. We can re-introduce it with a policy in a future version of CMake. Fixes: #21469 Issue: #14516, #20716
* | | Merge topic 'rename_cuda_memcheck'Brad King2020-11-182-6/+6
|\ \ \ | |/ / | | / | |/ |/| | | | | fea49b2df0 CTest: Rename CudaMemcheck to CudaSanitizer Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5514
| * CTest: Rename CudaMemcheck to CudaSanitizerTobias Ribizel2020-11-172-6/+6
| |
| * Merge topic 'qtifw-archivegen' into release-3.19Brad King2020-11-131-0/+4
| |\ | | | | | | | | | | | | | | | | | | 5ab75dd7dd CPack/IFW: Locate the archivegen utility Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5503
| * \ Merge topic 'doc-cstd' into release-3.19Brad King2020-11-132-4/+4
| |\ \ | | | | | | | | | | | | | | | | | | | | | | | | 48645cabe3 Help: MSVC now has C standard level flags Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5500
* | \ \ Merge topic 'msvc-no-GR'Brad King2020-11-163-0/+51
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | c00a6d3967 MSVC: Do not add /GR to CMAKE_CXX_FLAGS by default 6114c8e994 MSVC: Factor out initialization of /GR flag Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5508
| * | | | MSVC: Do not add /GR to CMAKE_CXX_FLAGS by defaultBrad King2020-11-133-0/+51
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The `/GR` flag has been on by default since MSVC cl 14.0 from VS 2005. Remove it from the default flags to make it easier for projects to pass `/GR-` themselves to turn it off. Projects may be using string processing to replace `/GR` with another flag, so we cannot simply drop it. Add a policy to drop it in a compatible way. Fixes: #21428
* | | | | Merge topic 'cmake_path-enhancements'Craig Scott2020-11-141-74/+58
|\ \ \ \ \ | |/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | ed21ad181e cmake_path: various enhancements to subcommands/keywords Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5457
| * | | | cmake_path: various enhancements to subcommands/keywordsMarc Chevrier2020-11-111-74/+58
| | | | | | | | | | | | | | | | | | | | This change address partly the remarks done in issue #21385
* | | | | Merge topic 'usejava_helpers'Brad King2020-11-133-4/+0
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | cb28d9af1f UseJava: Move helper scripts to subdirectory Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5501
| * | | | | UseJava: Move helper scripts to subdirectoryNikita Nemkin2020-11-123-4/+0
| |/ / / / | | | | | | | | | | | | | | | Also, exclude them from the help module index.
* | | | | Merge topic 'versionadded'Brad King2020-11-1340-149/+565
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | c43e845d09 Help: Add `.. versionadded` directives to generator docs f6fd769ae9 Help: Add `.. versionadded` directives to CPack generator docs a19058d7d8 Help: Replace some `versionadded` directives with `versionchanged` Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5495
| * | | | | Help: Add `.. versionadded` directives to generator docsNikita Nemkin2020-11-1213-83/+156
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | More `.. versionadded` could be added later when the features, variables and properties relevant to each generator are properly documented. Issue: #19715
| * | | | | Help: Add `.. versionadded` directives to CPack generator docsNikita Nemkin2020-11-1214-47/+390
| | | | | | | | | | | | | | | | | | | | | | | | Issue: #19715
| * | | | | Help: Replace some `versionadded` directives with `versionchanged`Nikita Nemkin2020-11-1213-19/+19
| |/ / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | `.. versionchanged` directive might be more appropriate when documentation refers to previous CMake version, old behavior or a policy, and there's no new parameter or a variable involved. Issue: #19715
* | | | | Merge topic 'qtifw-archivegen'Brad King2020-11-131-0/+4
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | 5ab75dd7dd CPack/IFW: Locate the archivegen utility Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5503