summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'find_item-validation-function'Brad King2022-06-152-0/+27
|\ | | | | | | | | | | | | f3b5a7d6df find_(program,library,file,path): add validation function Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7364
| * find_(program,library,file,path): add validation functionMarc Chevrier2022-06-142-0/+27
| | | | | | | | Fixes: #23603
* | Merge topic 'doctop'Brad King2022-06-142-6/+20
|\ \ | |/ |/| | | | | | | | | 75aedb1204 Help: Clarify PROJECT_IS_TOP_LEVEL behavior w.r.t. add_subdirectory Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7362
| * Help: Clarify PROJECT_IS_TOP_LEVEL behavior w.r.t. add_subdirectoryMichael Hirsch2022-06-142-6/+20
| | | | | | | | | | | | | | | | Clarify documentation added by commit 2df4badc5f (Help: Note PROJECT_IS_TOP_LEVEL behavior w.r.t. ExternalProject, 2021-07-05, v3.21.0-rc3~1^2). Fixes: #23511
| * Merge topic 'fetchcontent-global-targets' into release-3.24Brad King2022-06-111-4/+5
| |\ | | | | | | | | | | | | | | | | | | | | | | | | f19b48e0b8 FetchContent: Honor CMAKE_FIND_PACKAGE_TARGETS_GLOBAL 1305bade56 Help: Add missing version directive for find_package() GLOBAL keyword Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !7347
* | \ Merge topic 'fetchcontent-global-targets'Brad King2022-06-111-4/+5
|\ \ \ | | |/ | |/| | | | | | | | | | | | | | | | | | | f19b48e0b8 FetchContent: Honor CMAKE_FIND_PACKAGE_TARGETS_GLOBAL 1305bade56 Help: Add missing version directive for find_package() GLOBAL keyword Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !7347
| * | Help: Add missing version directive for find_package() GLOBAL keywordCraig Scott2022-06-101-4/+5
| | |
* | | Merge topic 'doc-3.24-release-notes-cleanup'Brad King2022-06-112-24/+26
|\ \ \ | | |/ | |/| | | | | | | | | | | | | | | | ce0be99b30 Help: Minor cleanups of 3.24 release notes 35ecc6e39b Help: Trivial grammar fixup in LINK_GROUPS genex Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7342
| * | Help: Minor cleanups of 3.24 release notesCraig Scott2022-06-101-23/+25
| | |
| * | Help: Trivial grammar fixup in LINK_GROUPS genexCraig Scott2022-06-101-1/+1
| | |
* | | Merge topic 'CheckIPOSupported-honor-flags'Brad King2022-06-103-2/+25
|\ \ \ | |/ / | | | | | | | | | | | | | | | | | | ec08bc1752 CheckIPOSupported: Compile check using flags of calling project Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7343
| * | CheckIPOSupported: Compile check using flags of calling projectBrad King2022-06-103-2/+25
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Forward `CMAKE_<LANG>_FLAGS` and `CMAKE_<LANG>_FLAGS_DEBUG` from the calling project into the test project. The set of flags may affect the availability of IPO support. Since this may change the result of the check for existing projects, add a policy for compatibility. This was discovered after commit 5fcadc481e (MSVC: Default to -ZI instead of /Zi for x86 and x64, 2022-05-24) introduced policy CMP0138 to switch our default for MSVC's debug info flag. The `-ZI` flag is incompatible with the `-GL` flag used for IPO, so CMP0138 was reverted pending future work on an alternative solution. Re-use the CMP0138 policy number for this change to CheckIPOSupported instead. Fixes: #23607
* | | Merge topic 'revert-msvc-compilers-default-to-ZI'Brad King2022-06-103-35/+2
|\ \ \ | |/ / | | | | | | | | | | | | | | | | | | 7d73e88d3a MSVC: Revert "Default to -ZI instead of /Zi for x86 and x64" Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7344
| * | MSVC: Revert "Default to -ZI instead of /Zi for x86 and x64"Brad King2022-06-093-35/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Revert commit 5fcadc481e (MSVC: Default to -ZI instead of /Zi for x86 and x64, 2022-05-24). The `-ZI` flag is incompatible with the `-GL` flag used for IPO, and so is not an unconditionally better default. Revert the change pending future design of a first-class setting for MSVC debug info format that can be automatically reconciled with IPO settings. That commit introduced policy CMP0138, but we already have later policy numbers used too. Leave placeholder text to avoid policy renumbering. Issue: #23607, #10189
| * | Merge topic 'doc-using-deps-guide' into release-3.24Brad King2022-06-094-173/+398
| |\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 92e93f5c9e Help: Overhaul and expand the Using Dependencies Guide Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Alex <leha-bot@yandex.ru> Merge-request: !7332
* | \ \ Merge topic 'doc-using-deps-guide'Brad King2022-06-094-173/+398
|\ \ \ \ | | |/ / | |/| | | | | | | | | | | | | | | | | | | | | | 92e93f5c9e Help: Overhaul and expand the Using Dependencies Guide Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Alex <leha-bot@yandex.ru> Merge-request: !7332
| * | | Help: Overhaul and expand the Using Dependencies GuideCraig Scott2022-06-094-173/+398
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The guide previously only focused on the find_package() command, with a bias towards libraries. FetchContent was not mentioned at all. Reorganise and update the existing content. Add new sections to cover providing dependencies with FetchContent and dependency providers. Improve discoverability of the guide by mentioning it at the beginning of the find_package(), FetchContent and dependency provider docs.
* | | | Begin post-3.24 developmentBrad King2022-06-082-0/+9
| |/ / |/| |
* | | Help: Drop development topic notes to prepare releaseBrad King2022-06-082-9/+0
| |/ |/| | | | | | | Release versions do not have the development topic section of the CMake Release Notes index page.
* | Merge topic 'doc-3.24-relnotes'Brad King2022-06-0860-406/+353
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | 253941634c Help: Update Sphinx versionadded directives for 3.24 release a811489b35 Help: Organize and revise 3.24 release notes a3fc469882 Help: Consolidate 3.24 release notes Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7338
| * | Help: Update Sphinx versionadded directives for 3.24 releaseBrad King2022-06-084-0/+8
| | | | | | | | | | | | | | | | | | Run the script: Utilities/Sphinx/update_versions.py --since v3.23.0 --overwrite
| * | Help: Organize and revise 3.24 release notesBrad King2022-06-081-205/+243
| | | | | | | | | | | | | | | Add section headers similar to the 3.23 release notes and move each individual bullet into an appropriate section. Revise a few bullets.
| * | Help: Consolidate 3.24 release notesBrad King2022-06-0756-406/+307
| | | | | | | | | | | | | | | Run the `Utilities/Release/consolidate-relnotes.bash` script to move notes from `Help/release/dev/*` into `Help/release/3.24.rst`.
* | | Help: Fix typo with misnamed set_source_files_property() in exampleDan Walsh2022-06-081-1/+1
|/ /
* | Merge topic 'if-command-PATH_EQUAL'Brad King2022-06-064-1/+52
|\ \ | | | | | | | | | | | | | | | | | | | | | be4b9e10af if command: Add PATH_EQUAL operator Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7321
| * | if command: Add PATH_EQUAL operatorMarc Chevrier2022-06-034-1/+52
| | |
* | | Help: Fix formatting and missing cross-reference for find_package()Craig Scott2022-06-051-3/+3
| |/ |/| | | | | Amends 42f7e39789 (Find: Support per call disabling of CMAKE_INSTALL_PREFIX, 2022-03-21)
* | Merge topic 'help-genex-updates'Brad King2022-06-041-19/+22
|\ \ | | | | | | | | | | | | | | | | | | 6427902713 Help: genex: layout updates Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7324
| * | Help: genex: layout updatesMarc Chevrier2022-06-031-19/+22
| |/ | | | | | | | | * create section for version comparisons * move $<LINK_LIBRARY> and $<LINK_GROUP> to "Output-Related Expressions" section
* | Help: State behavior for add_custom_command(TARGET) without event typeCraig Scott2022-06-041-0/+5
|/ | | | | | | | | | Projects should always have specified one of PRE_BUILD, PRE_LINK or POST_BUILD, and the documentation has always shown that one must be given. But the argument parsing logic was such that if none was given, POST_BUILD would be used and no error or warning would be raised. Projects may be relying on this behavior, so document it as formally supported, but not recommended. Fixes: #23488
* Merge topic 'genex-PATH_EQUAL'Brad King2022-06-033-0/+19
|\ | | | | | | | | | | | | | | 4d1883df11 Genex-PATH_EQUAL: path comparison Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7309
| * Genex-PATH_EQUAL: path comparisonMarc Chevrier2022-06-013-0/+19
| | | | | | | | To complete issue #23498
* | Merge topic 'doc-RULE_LAUNCH_COMPILE'Brad King2022-06-026-8/+44
|\ \ | | | | | | | | | | | | | | | | | | e281ba27b7 Help: Clarify that RULE_LAUNCH_COMPILE is meant for internal use Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7317
| * | Help: Clarify that RULE_LAUNCH_COMPILE is meant for internal useCraig Scott2022-06-026-8/+44
| | | | | | | | | Fixes: #22405
* | | Merge topic 'doc-preset-versionadded'Brad King2022-06-021-1/+16
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 5a9c7f76c0 Help: Document CMake version adding each preset version in cmake-presets(7) Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7313
| * | | Help: Document CMake version adding each preset version in cmake-presets(7)Brad King2022-06-011-1/+16
| |/ / | | | | | | | | | Fixes: #23485
* | | Merge topic 'tutorial-cmath'Brad King2022-06-023-19/+19
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | 5c84eca210 Tutorial: Simplify logic checking for cmath functions Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !7314
| * | Tutorial: Simplify logic checking for cmath functionsBrad King2022-06-013-19/+19
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since commit 07223c5c27 (Tutorial: Update Step 5 to work on Windows, 2020-02-18, v3.18.0-rc1~655^2) the logic does not work on non-Windows platforms when cmake is re-run on an existing build tree. It is also more complicated than we'd like for a tutorial example. Avoid the need to consider the `m` library case by performing the check as C++. Since `check_cxx_symbol_exists` cannot handle overloaded functions like `exp` and `log`, check with `check_cxx_source_compiles` instead. This also presents a more general-purpose example in the tutorial. Fixes: #23524
| * | Merge branch 'release-3.22' into release-3.23Brad King2022-06-011-3/+3
| |\ \
| * \ \ Merge branch 'release-3.22' into release-3.23Brad King2022-06-011-2/+2
| |\ \ \
* | \ \ \ Merge branch 'release-3.22'Brad King2022-06-011-3/+3
|\ \ \ \ \ | | |_|/ / | |/| | |
| * | | | CMake 3.22.5v3.22.5Brad King2022-06-011-3/+3
| | |/ / | |/| |
| * | | Merge branch 'release-3.21' into release-3.22Brad King2022-06-011-2/+2
| |\ \ \
* | \ \ \ Merge branch 'release-3.21'Brad King2022-06-011-2/+2
|\ \ \ \ \ | | |/ / / | |/| | / | |_|_|/ |/| | |
| * | | CMake 3.21.7v3.21.7Brad King2022-06-011-2/+2
| | | |
* | | | Genex-PATH: path handlingMarc Chevrier2022-05-313-1/+227
| | | | | | | | | | | | | | | | Fixes: #23498
* | | | Merge topic 'msvc-compilers-default-to-ZI'Brad King2022-05-273-0/+49
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5fcadc481e MSVC: Default to -ZI instead of /Zi for x86 and x64 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7295
| * | | | MSVC: Default to -ZI instead of /Zi for x86 and x64Glen Chung2022-05-263-0/+49
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a policy for compatibility. For more information, see [1]. [1] https://docs.microsoft.com/en-us/cpp/build/reference/z7-zi-zi-debug-information-format?view=msvc-170 Fixes: #10189
* | | | | MSYS/MinGW Makfiles: Select the compiler occurring first in PATHBrad King2022-05-261-0/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Extend the change from commit e01990999a (Ninja: On Windows, select the compiler occurring first in PATH, 2020-04-17, v3.18.0-rc1~291^2) to apply to the MSYS/MinGW Makefiles generators too. Drop the implied `gcc` and `g++` default compilers. This allows MinGW/Clang environments to work out of the box. Inspired-by: Mehdi Chinoune <mehdi.chinoune@hotmail.com> Fixes: #23542
* | | | | Merge topic 'verify-interface-header-sets-list'Brad King2022-05-264-0/+20
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | aadaac7f6d VERIFY_INTERFACE_HEADER_SETS: Add property for list of header sets Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7298