summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* codespell: Fix typosBrad King2023-11-172-2/+2
|
* cmExperimental: remove the flag for C++ modulesBen Boeckel2023-10-024-21/+6
| | | | | | | All the major compilers now have scheduled releases with support for scanning, so remove the experimental gate. Fixes: #18355
* Merge topic 'fileset-private-dep'Brad King2023-09-213-0/+17
|\ | | | | | | | | | | | | | | ec2ba29ac5 Ninja: Allow compilation before generation of dependencies' private sources Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8420
| * Ninja: Allow compilation before generation of dependencies' private sourcesMartin Duffy2023-09-203-0/+17
| | | | | | | | | | | | | | | | | | | | This requires knowing when a generated header is public, which we can model using file sets. Add policy CMP0154 to treat generated sources as private by default in targets with file sets. Generated public headers can be specified in public file sets. Fixes: #24959 Issue: #15555
* | Help: Clarify requirements for find_package to use lib{64,32,x32} pathsBrad King2023-09-201-8/+17
| | | | | | | | Issue: #25157
* | Help: Indent find_package REGISTRY_VIEW paragraphs togetherBrad King2023-09-201-1/+1
| | | | | | | | | | | | In commit 8d7e80cf3d (find_* commands: add control over Windows registry views, 2022-04-16, v3.24.0-rc1~201^2) this indentation was used for the other find commands but was left out for `find_package`.
* | find_(library|file|path): Drop PATH-derived search prefixesBrad King2023-09-145-11/+18
|/ | | | | | | | | | | | | | | | | | | | | | | | | | Since commit ffc06c1239 (Teach find_(library|file|path) to get prefixes from PATH, 2015-02-18, v3.3.0-rc1~430^2) we search in `<prefix>/include` and `<prefix>/lib` directories for prefixes with `bin` directories in the `PATH` environment variable. The motivation was to search the installation prefixes of MSYS and MinGW development environments automatically. This behavior can search undesired prefixes that happen to be in the `PATH` for unrelated reasons. It was reverted for non-Windows hosts within a year by commit b30b32a493 (Drop find_(library|file|path) prefixes from PATH on non-Windows, 2016-05-09, v3.6.0-rc1~82^2) but was kept on Windows hosts to support its motivating use case. However, similar problems have since been observed on Windows. For example, commit 955d6245c1 (MSVC: Revert "Teach find_library to consider the 'libfoo.a' naming convention", 2022-11-28, v3.25.1~6^2) was primarily due to undesired discovery of libraries in `PATH`-derived prefixes. Since commit 5e5132e1b1 (MinGW: Search for packages in standard MSYSTEM environment prefixes, 2023-09-11) we search MSYS and MinGW environments' prefixes explicitly, so `PATH`-derived prefixes are no longer needed for the original motivating use case. Fixes: #24216
* Merge topic 'host-msystem-prefix'Brad King2023-09-111-0/+7
|\ | | | | | | | | | | | | | | | | 84a25fc263 cmake_host_system_information: Add MSYSTEM_PREFIX query cdcff0a0f0 cmCMakeHostSystemInformationCommand: Clarify function names and roles Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8788
| * cmake_host_system_information: Add MSYSTEM_PREFIX queryBrad King2023-09-101-0/+7
| | | | | | | | | | | | | | Add a query on Windows hosts for the installation prefix of a MSYS or MinGW development environment. Issue: #24216
* | Help: Document if() comparison number formatBrad King2023-09-081-10/+10
|/ | | | Fixes: #25237
* Help: Explain block() policy-scope rules more clearlyFeRD (Frank Dana)2023-09-012-5/+5
|
* Help: Remove "this command" ambiguity in set() docsFeRD (Frank Dana)2023-09-011-5/+6
|
* Help: Use signature directive for cmake_policy()FeRD (Frank Dana)2023-09-011-14/+15
|
* Merge topic 'doc-cmake_minimum_required-deprecation'Brad King2023-08-213-0/+19
|\ | | | | | | | | | | | | | | 741755f637 Help: Document cmake_minimum_required deprecation of old versions Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: scivision <michael@scivision.dev> Merge-request: !8742
| * Help: Document cmake_minimum_required deprecation of old versionsBrad King2023-08-193-0/+19
| | | | | | | | | | | | | | | | | | Document the deprecation warnings added by commit 5845c218d7 (Deprecate compatibility with CMake versions older than 2.8.12, 2020-06-12, v3.19.0-rc1~629^2) and commit 3a4791548d (Deprecate compatibility with CMake versions older than 3.5, 2023-02-09, v3.27.0-rc1~508^2). Fixes: #25196
* | Help:try_run: place options in their own sectionscivision2023-08-161-0/+5
| |
* | Help:try_compile: place options in their own sectionscivision2023-08-161-1/+6
| | | | | | | | | | As try_compile interface was enhanced in 3.25, the Help got a lot longer. Make the options its own section for navigability.
* | get_test_property(): Add DIRECTORY optionKyle Edwards2023-08-111-1/+12
| |
* | get_property(TEST): Add DIRECTORY optionKyle Edwards2023-08-111-1/+12
| |
* | set_tests_properties(): Add DIRECTORY optionKyle Edwards2023-08-111-0/+10
| |
* | set_property(TEST): Add DIRECTORY optionKyle Edwards2023-08-101-1/+13
| |
* | Merge topic 'doc-fixups-release-3.27'Craig Scott2023-08-071-1/+5
|\ \ | |/ | | | | | | | | | | | | | | | | 78e7ea598d cmLocalGenerator: Fix trivial spelling error in code comment 1285fe27ff Help: Improve formatting and fix wording for ENABLE_EXPORTS 91336d061c Help: Improve formatting and cross-references for DEPENDS_EXPLICIT_ONLY 03208d9e18 Help: Fix indenting within TARGET_RUNTIME_DLLS genex docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8688
| * Help: Improve formatting and cross-references for DEPENDS_EXPLICIT_ONLYCraig Scott2023-08-041-1/+5
| |
* | Merge topic 'doc-install'Brad King2023-08-071-132/+177
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | b97350a151 Help: Add more install(TARGETS) examples 0827305032 Help: Clarify install(TARGETS) artifact-kind option group ordering 7bd6478dd0 Help: Use argument value placeholders consistently in install(TARGETS) ae381e1075 Help: Reorganize install() sections 5d15231a67 Help: Revert "improve install() documentation of argument ordering" Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8683
| * | Help: Add more install(TARGETS) examplesBrad King2023-08-031-38/+94
| | | | | | | | | | | | | | | | | | | | | Add examples showing per-artifact components and per-configuration destinations. Fixes: #25144
| * | Help: Clarify install(TARGETS) artifact-kind option group orderingBrad King2023-08-031-19/+35
| | | | | | | | | | | | | | | | | | | | | | | | | | | Revise the signature and description to explicitly distinguish the initial group of artifact options from later groups that apply to a specific kind. Issue: #25144 Fixes: #16362
| * | Help: Use argument value placeholders consistently in install(TARGETS)Brad King2023-08-031-45/+46
| | |
| * | Help: Reorganize install() sectionsBrad King2023-08-031-20/+6
| | | | | | | | | | | | | | | | | | After switching to the signature directive we no longer need per-signature sections. Group all the signatures in one section. Add a table of contents since it is no longer redundant with the synopsis.
| * | Help: Revert "improve install() documentation of argument ordering"Brad King2023-08-031-15/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Revert commit f09fda97d8 (Help: improve install() documentation of argument ordering, 2018-01-08, v3.11.0-rc1~126^2). Although the example it added is correct, its explanation is misleading. Revert it to make room for an alternative. Issue: #25144 Issue: #16362
* | | Merge topic 'cxxmodules-try-compile'Brad King2023-08-072-0/+23
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | be53c75852 cmExperimental: recycle the C++ modules API UUID deb1c3cbd5 cmCoreTryCompile: forward module-related binutils variables b768d293c5 cmCoreTryCompile: use the source type context for source files 93993c7ad4 cmArgumentParser: support storing a context value with parsing c9ca5f6326 cmCoreTryCompile: parse `SOURCES_TYPE` argument 07551f35de cmCoreTryCompile: use `target_sources` for `try_compile` targets aad9033b56 cmExperimental: support forwarding associated variables to `try_compile` f6cf433256 cmExperimental: only forward C++ module support to non-ABI checks ... Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !8639
| * | cmCoreTryCompile: parse `SOURCES_TYPE` argumentBen Boeckel2023-07-312-0/+23
| | | | | | | | | | | | | | | | | | This will serve to add context for the source listing in order to properly mark sources as `FILE_SET TYPE CXX_MODULES` in the generated code.
* | | Help: Cross-reference install command signatures as commandsBrad King2023-08-022-34/+19
| | | | | | | | | | | | Replace manual anchors with proper command signature cross-references.
* | | Help: Use signature directive for 'install' commandBrad King2023-08-021-792/+820
|/ / | | | | | | | | Replace manual anchors with signature directives. Indent each signature's documentation inside its directive.
* | Merge topic 'xcframework-find-library'Kyle Edwards2023-07-281-0/+4
|\ \ | | | | | | | | | | | | | | | | | | 9bf8f7de06 find_library(): Add support for .xcframework Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8661
| * | find_library(): Add support for .xcframeworkKyle Edwards2023-07-281-0/+4
| | | | | | | | | | | | Issue: #21752
* | | Merge topic 'ExportTestLabelToJUnit'Brad King2023-07-281-1/+1
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | | | | 2b99e64413 set_test_properties: link to the test properties in the documentation b11e8afbfa ctest: export test labels to junit xml Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8635
| * | set_test_properties: link to the test properties in the documentationAlex Neundorf2023-07-261-1/+1
| | | | | | | | | | | | It was linking to the target properties, this was probably an oversight.
* | | Merge topic 'xcframework-target-link-libraries'Kyle Edwards2023-07-271-0/+6
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 7050ac56a1 macOS: Add support for linking against .xcframework folders 93ed53790c bootstrap: Unconditionally build libjsoncpp Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8619
| * | | macOS: Add support for linking against .xcframework foldersKyle Edwards2023-07-261-0/+6
| | | | | | | | | | | | | | | | Issue: #21752
* | | | Merge topic 'doc-if-exists'Brad King2023-07-271-3/+3
|\ \ \ \ | |/ / / |/| | / | | |/ | |/| | | | | | | 3ab132d86f Help: Document that if(EXISTS) requires paths to be readable Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8656
| * | Help: Document that if(EXISTS) requires paths to be readableBrad King2023-07-261-3/+3
| | | | | | | | | | | | Issue: #25125
* | | exec_program(): Remove by policy CMP0153Kyle Edwards2023-07-251-0/+4
| | |
* | | Merge topic 'file-REAL_PATH-relative'Brad King2023-07-241-0/+5
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6b5f2dbbfe file(REAL_PATH): resolve symlinks before '..' components Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8605
| * | | file(REAL_PATH): resolve symlinks before '..' componentsRobert Maynard2023-07-201-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Previously REAL_PATH would collapse paths before resolving any symlinks so if `..` crossed a symlink the output from `REAL_PATH` would be wrong. It looked like REAL_PATH did this by mistake since it was a side-effect of ensuring we had an absolute path before resolving symlinks.
* | | | Merge topic 'command-job-server-aware'Brad King2023-07-202-0/+28
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | | | | | 95941fd990 add_custom_{target,command}: Add argument JOB_SERVER_AWARE Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8547
| * | | add_custom_{target,command}: Add argument JOB_SERVER_AWAREChris Mahoney2023-07-192-0/+28
| | | | | | | | | | | | | | | | Issue: #16273
* | | | Merge topic 'export-doc-config-map'Brad King2023-07-182-0/+6
|\ \ \ \ | | |/ / | |/| | | | | | | | | | | | | | | | | | 38737e3970 Help: Mention imported config mapping in export() and install() docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8637
| * | | Help: Mention imported config mapping in export() and install() docsBrad King2023-07-182-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Suggest the `CMAKE_MAP_IMPORTED_CONFIG_<CONFIG>` variable for mapping configurations of dependent projects to configurations exported by these commands. Issue: #25096
| * | | Merge topic 'doc-add_custom_command' into release-3.27Brad King2023-06-291-1/+1
| |\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | e588d29eaf Help: add_custom_command(TARGET) does not support USES_TERMINAL Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: William Jones <william.luke.jones@gmail.com> Merge-request: !8602
| * \ \ \ Merge topic 'doc-target_precompile_headers' into release-3.27Brad King2023-06-291-1/+1
| |\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | a3dfaf8a5c Help: Fix wrong command name in target_precompile_headers docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8600