summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'doc-if-PATH_EQUAL'Brad King2022-07-262-9/+15
|\ | | | | | | | | | | | | 37e01773e4 Help: Clarify behavior of path-based equality conditions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7503
| * Help: Clarify behavior of path-based equality conditionsCraig Scott2022-07-242-9/+15
| | | | | | | | | | | | | | | | | | | | | | | | The docs for if(PATH_EQUAL) did not mention the component-wise nature of the checks. It also claimed no normalization was performed, but multiple separators are effectively collapsed (part of normalization). Improve the wording to clarify both of these points. Also update the corresponding description of cmake_path(COMPARE), which had the same inaccuracy. Fixes: #23758
* | Merge topic 'verify-interface-header-sets-interface-libraries'Brad King2022-07-261-7/+7
|\ \ | | | | | | | | | | | | | | | | | | f5dd1817d1 Help: Clarify that VERIFY_INTERFACE_HEADER_SETS supports interface libraries Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7507
| * | Help: Clarify that VERIFY_INTERFACE_HEADER_SETS supports interface librariesKyle Edwards2022-07-251-7/+7
| | |
| * | Merge topic 'doc-find_package-BYPASS_PROVIDER' into release-3.24Brad King2022-07-252-3/+13
| |\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 4f7a0c25d2 Help: Document BYPASS_PROVIDER keyword for find_package() 76370e06b8 Help: Minor grammar fix for the Using Dependencies manual Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7501
| * \ \ Merge topic 'doc-CMP0097-FetchContent' into release-3.24Craig Scott2022-07-251-2/+4
| |\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 1796ffbde9 Help: CMP0097 applies to FetchContent as well Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7504
* | \ \ \ Merge branch 'backport-3.24-FindVulkan-relnotes'Brad King2022-07-251-0/+4
|\ \ \ \ \
| * | | | | FindVulkan: Add missing 3.24 release notesMACHIZAUD Andréa2022-07-251-0/+4
| | |_|_|/ | |/| | |
* | | | | Merge topic 'doc-find_package-BYPASS_PROVIDER'Brad King2022-07-252-3/+13
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | 4f7a0c25d2 Help: Document BYPASS_PROVIDER keyword for find_package() 76370e06b8 Help: Minor grammar fix for the Using Dependencies manual Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7501
| * | | | Help: Document BYPASS_PROVIDER keyword for find_package()Craig Scott2022-07-231-2/+12
| | | | | | | | | | | | | | | Fixes: #23669
| * | | | Help: Minor grammar fix for the Using Dependencies manualCraig Scott2022-07-231-1/+1
| |/ / /
* | | | Merge topic 'doc-CMP0097-FetchContent'Craig Scott2022-07-251-2/+4
|\ \ \ \ | | |_|/ | |/| | | | | | | | | | | | | | | | | | 1796ffbde9 Help: CMP0097 applies to FetchContent as well Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7504
| * | | Help: CMP0097 applies to FetchContent as wellCraig Scott2022-07-241-2/+4
| |/ / | | | | | | | | | The omission of FetchContent_Declare() in the original policy docs was just an oversight.
* | | Merge topic 'doc-path-genex-corrections'Craig Scott2022-07-251-1/+1
|\ \ \ | | |/ | |/| | | | | | | | | | | | | c7ab76e0ff Help: Fix wrong syntax for $<PATH:REPLACE_EXTENSION,...> Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7505
| * | Help: Fix wrong syntax for $<PATH:REPLACE_EXTENSION,...>Craig Scott2022-07-241-1/+1
| |/
* | Merge topic 'FindVulkan-dxc'Brad King2022-07-221-0/+5
|\ \ | | | | | | | | | | | | | | | | | | 1277b873c9 FindVulkan: Add `dxc` (DirectX Shader Compiler) component Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7474
| * | FindVulkan: Add `dxc` (DirectX Shader Compiler) componentHellsingDarge2022-07-201-0/+5
| | |
* | | Merge topic 'try_run_split_output'Brad King2022-07-222-0/+19
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | a2cd0687db try_run: Add RUN_OUTPUT_STDOUT_VARIABLE and RUN_OUTPUT_STDERR_VARIABLE. Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !7453
| * | | try_run: Add RUN_OUTPUT_STDOUT_VARIABLE and RUN_OUTPUT_STDERR_VARIABLE.Patrick Northon2022-07-082-0/+19
| | | |
* | | | Merge topic 'tutorial_cdash_rearrange'Brad King2022-07-2218-121/+81
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6c77ccec51 Tutorial: Move step 8 to step 5. Shift steps 5-7 to 6-8. Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7480
| * | | | Tutorial: Move step 8 to step 5. Shift steps 5-7 to 6-8.Markus Ferrell2022-07-1918-121/+81
| | | | |
* | | | | Merge topic 'doc-execute_process'Brad King2022-07-201-2/+9
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | 70c26a65b7 Help: Clarify execute_process OS-specific command-line encoding Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7492
| * | | | Help: Clarify execute_process OS-specific command-line encodingBrad King2022-07-201-2/+9
| | | | | | | | | | | | | | | | | | | | Issue: #23557
| * | | | Merge topic 'doc-example-target-sources' into release-3.24Brad King2022-07-201-2/+2
| |\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | c7c5a50b97 Help: Add missing PRIVATE keyword to target_sources() example Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7490
| * \ \ \ \ Merge topic 'doc-restructure-genex-manual' into release-3.24Brad King2022-07-201-915/+1007
| |\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | d6af935467 Help: Add Whitespace And Quoting section to genex manual 044c22e121 Help: Restructure reference sections of genex manual 3666486c28 Help: Move reference content to its own section at end of genex manual 22f8a626c3 Help: Add missing versionadded for CUDA genexes c57c3dbbec Help: Genex manual typo, grammar, formatting, wording fixes 2b102438f8 Help: Boolean genex conditions must evaluate to 1 or 0 d2cb36861f Help: Fix cross-references in genex manual that linked to wrong genexes Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7479
* | \ \ \ \ \ Merge topic 'doc_command_links'Brad King2022-07-204-0/+29
|\ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 033c066543 Help: Add see-also refs for flow control commands Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7467
| * | | | | | | Help: Add see-also refs for flow control commandsMarkus Ferrell2022-07-194-0/+29
| | |_|_|/ / / | |/| | | | |
* | | | | | | Merge topic 'tutorial_documentation'Brad King2022-07-201-7/+19
|\ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | bc0aef31ee Tutorial: Add reference links for step 1 commands Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7464
| * | | | | | | Tutorial: Add reference links for step 1 commandsMarkus Ferrell2022-07-191-7/+19
| |/ / / / / /
* | | | | | | Merge topic 'doc-example-target-sources'Brad King2022-07-201-2/+2
|\ \ \ \ \ \ \ | | |_|_|/ / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | c7c5a50b97 Help: Add missing PRIVATE keyword to target_sources() example Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7490
| * | | | | | Help: Add missing PRIVATE keyword to target_sources() exampleCraig Scott2022-07-201-2/+2
| | |/ / / / | |/| | | | | | | | | | Fixes: #23746
* | | | | | Merge topic 'doc-restructure-genex-manual'Brad King2022-07-201-915/+1007
|\ \ \ \ \ \ | | |_|/ / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | d6af935467 Help: Add Whitespace And Quoting section to genex manual 044c22e121 Help: Restructure reference sections of genex manual 3666486c28 Help: Move reference content to its own section at end of genex manual 22f8a626c3 Help: Add missing versionadded for CUDA genexes c57c3dbbec Help: Genex manual typo, grammar, formatting, wording fixes 2b102438f8 Help: Boolean genex conditions must evaluate to 1 or 0 d2cb36861f Help: Fix cross-references in genex manual that linked to wrong genexes Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7479
| * | | | | Help: Add Whitespace And Quoting section to genex manualCraig Scott2022-07-191-0/+87
| | | | | |
| * | | | | Help: Restructure reference sections of genex manualCraig Scott2022-07-191-872/+866
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | As part of the general restructuring, also move the notes of a more introductory nature out of what was the "String-Valued Generator Expressions" section and up to the dedicated Introduction. This gives the reader a bit more of a foundation before they get to the heavier detail of the reference section.
| * | | | | Help: Move reference content to its own section at end of genex manualCraig Scott2022-07-191-49/+53
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This involves moving the Debugging section up to just after the introduction. The content of that section is unchanged. The reference section then follows, and since it is a dedicated section, all existing sections thereunder were demoted one level. Move the note about deviating from the usual CMake docs convention of using angle brackets around placeholders out of the Introduction and to the start of the reference section. No placeholders are used before that point, so that content no longer belongs in the introduction. Apply some minor wording cleanup to the content in the Introduction that remained.
| * | | | | Help: Add missing versionadded for CUDA genexesCraig Scott2022-07-191-0/+4
| | | | | |
| * | | | | Help: Genex manual typo, grammar, formatting, wording fixesCraig Scott2022-07-191-35/+35
| | | | | |
| * | | | | Help: Boolean genex conditions must evaluate to 1 or 0Craig Scott2022-07-191-5/+8
| | | | | |
| * | | | | Help: Fix cross-references in genex manual that linked to wrong genexesCraig Scott2022-07-191-4/+4
| | | | | |
* | | | | | Merge topic 'doc-LINK_LIBRARIES_ONLY_TARGETS_direct_deps'Brad King2022-07-181-0/+2
|\ \ \ \ \ \ | | |/ / / / | |/| | | / | |_|_|_|/ |/| | | | | | | | | | | | | | f585c61667 Help: LINK_LIBRARIES_ONLY_TARGETS also checks injected direct libraries Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7466
| * | | | Help: LINK_LIBRARIES_ONLY_TARGETS also checks injected direct librariesCraig Scott2022-07-101-0/+2
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | The INTERFACE_LINK_LIBRARIES_DIRECT property can add direct link dependencies to the target at the head of the dependency chain. The checks associated with LINK_LIBRARIES_ONLY_TARGETS also apply to these link items, but the documentation wasn't updated to reflect this when the INTERFACE_LINK_LIBRARIES_DIRECT support was added.
* | | | Merge topic 'better_doxy_ver_check'Marc Chevrier2022-07-101-0/+11
|\ \ \ \ | |_|/ / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | eaec9cf65d FindDoxygen: Implement more complete version checking Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Acked-by: Alex Turbov <i.zaufi@gmail.com> Merge-request: !7442
| * | | FindDoxygen: Implement more complete version checkingChristian Heimlich2022-07-071-0/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The foundation of the Doxygen Find Module's detection methodology is the command `find_program`, which has inhibited the module from properly handling user version restrictions when provided. Because `find_program` historically has always returned after the first match and does not consider version constraints, users of this module are inadvertently at the mercy of the command's search procedure. Essentially, `find_package(Doxygen ...)` will always provide the first Doxygen build found through said procedure, even if it conflicts with the user's version requirements, and even if another build exists on the system that would satisfy those requirements (i.e. shadowing). Utilizes the new `VALIDATOR` option of `find_program` to ensure all otherwise detectable builds of Doxygen on a given system are evaluated and that only a build in compliance with `Doxygen_FIND_VERSION` et. al., when defined, will be matched against. Also enables handling of version ranges specified within `find_package` via the **FindPackageHandleStandardArgs** module. Finally, ensures that only the major, minor, and patch components of Doxygen's `--version` output are captured for comparison in cases where it contains additional information, such as a git commit hash. Fixes: #23692
* | | | Merge topic 'doc-INTERFACE_LINK_LIBRARIES_DIRECT'Brad King2022-07-081-15/+15
|\ \ \ \ | | |/ / | |/| | | | | | | | | | | | | | | | | | 6b103dd58a Help: Fix wrong property name INTERFACE_PROPERTY_LINK_DIRECT Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7461
| * | | Help: Fix wrong property name INTERFACE_PROPERTY_LINK_DIRECTCraig Scott2022-07-081-15/+15
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is the name of a placeholder used for some documentation in `Help/prop_tgt/INTERFACE_LINK_LIBRARIES_DIRECT.txt` that is included in multiple documents. During development iterations, much of the content was moved to just `Help/prop_tgt/INTERFACE_LINK_LIBRARIES_DIRECT.rst`, but the placeholder was not correctly replaced by its property name.
* | | | Merge topic 'install-destination-docs'Brad King2022-07-081-3/+9
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 52164be691 Help: Clarify behavior of install(TARGETS) for DLLs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7457
| * | | | Help: Clarify behavior of install(TARGETS) for DLLsKyle Edwards2022-07-061-3/+9
| | | | | | | | | | | | | | | | | | | | Fixes: #23695
* | | | | Merge topic 'cpp-named-module-export-infra'Brad King2022-07-074-8/+45
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | f62c3c3c72 RunCMake/CXXModules: test public modules requiring private modules c5d4dd713f RunCMake/CXXModules: add tests which export BMIs 4d55f1422e RunCMake/CXXModules: test installation of BMIs and interfaces eff45f790d RunCMake/CXXModules: fix example follow-on case names a87c39dad1 RunCMake/CXXModules: output example test output upon failure 727e3db07a RunCMake/CXXModules: append to the test options f899563ae4 cmGlobalNinjaGenerator: verify that private sources stay private 9ecd3e771b cmGlobalNinjaGenerator: generate install rules for BMI files ... Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Acked-by: Alex <leha-bot@yandex.ru> Merge-request: !7224
| * | | | | cmExperimental: update `CXX_MODULE_CMAKE_API` UUIDBen Boeckel2022-07-061-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | The set of features available has been expanded, so update the UUID.
| * | | | | exports: support `CXX_MODULES_DIRECTORY`Ben Boeckel2022-07-062-4/+29
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This directory will be used to store build-discovered information about targets such as the modules provided by the files in the relevant `FILE_SET` types. A directory is used because basing the name on a `<FILE_NAME>-*.cmake` pattern makes it end up being globbed in the configuration-dependent information mechanism. Since old modules and targets may be around, unconditionally including them may refer to targets that do not actually exist.