summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
...
* | | | Help: Fix signature of add_library(<name> INTERFACE EXCLUDE_FROM_ALL)namniav2023-12-041-1/+1
| |/ / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This signature was added by commit 4391913133 (Add INTERFACE libraries to generated buildsystem if they have SOURCES, 2020-07-20, v3.19.0-rc1~346^2~1) with incorrect documentation. Previously the documented signature as: add_library(<name> INTERFACE [<source>...] [EXCLUDE_FROM_ALL]) which is incorrect. CMake would recognize `EXCLUDE_FROM_ALL` as a source file and report an error that it doesn't exists. The correct signature is: add_library(<name> INTERFACE [EXCLUDE_FROM_ALL] [<source>...]) which places `EXCLUDE_FROM_ALL` in the same position used by the documentation of other signatures. Fixes: #25463
* | | Merge branch 'backport-ci-fedora-39' into ci-fedora-39Brad King2023-11-172-2/+2
|\ \ \ | |/ /
| * | codespell: Fix typosBrad King2023-11-172-2/+2
| | |
* | | Merge topic 'install-export-xcframework'Brad King2023-11-161-0/+13
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 37bc3400cd CMakePackageConfigHelpers: Add generate_apple_platform_selection_file() 256bb0cc40 install(EXPORT): Add ability to point to .xcframework file a90968e044 cmExportBuildFileGenerator: Add structs for target exports Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Jason Juang <jasjuang@gmail.com> Merge-request: !8969
| * | | install(EXPORT): Add ability to point to .xcframework fileKyle Edwards2023-11-151-0/+13
| | | | | | | | | | | | | | | | Issue: #25262
* | | | Help: Clarify file() command multi-value argument placeholdersBrad King2023-11-151-34/+34
|/ / / | | | | | | | | | Use `<placeholder>...` syntax to imply "zero or more", as we do elsewhere.
* | | install(EXPORT): Export find_dependency() callsKyle Edwards2023-11-132-2/+84
| | | | | | | | | | | | | | | | | | Issue: #20511 Co-Authored-by: Brad King <brad.king@kitware.com> Co-Authored-by: Robert Maynard <rmaynard@nvidia.com>
* | | Help/export: Add signature directivesKyle Edwards2023-11-131-8/+8
| | |
* | | Merge topic 'Ninja-use-depslog'Brad King2023-11-071-0/+5
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | bb7a0497ef cmTransformDepfile: warn when a depfile is not written to c22c473bde Tests/Ninja*/CustomCommandDepfile: check that deps are in the database b0177003e1 cmGlobalNinjaGenerator: tell `ninja` to actually read the depfile 45eff9145e cmAddCustomCommandCommand: use `cmStrCat` c6445c615b Tests/RunCMake/Ninja: fix subdir prefix check Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8911
| * | | cmGlobalNinjaGenerator: tell `ninja` to actually read the depfileBen Boeckel2023-11-011-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | But only do so if the depfile is not specified as an output of the command. Otherwise the command will out-of-date itself as `ninja` deletes depfiles that it incorporates into the database and a missing output will cause the command to run again.
* | | | if(): add operators IS_READABLE, IS_WRITABLE and IS_EXECUTABLE.Marc Chevrier2023-11-011-0/+41
|/ / / | | | | | | | | | Offers possibility to check for file or directory permissions.
* | | Help: Replace link with its http redirectBrad King2023-10-191-1/+1
| | |
* | | Merge topic 'try_compile-alias-targets'Brad King2023-10-171-0/+3
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 8f9f371668 try_compile: Add support for using ALIAS targets 9f8aa94192 Add missing `OUTPUT` in ExportImport test Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !8877
| * | | try_compile: Add support for using ALIAS targetsCristian Le2023-10-161-0/+3
| |/ / | | | | | | | | | | | | Fixes: #25337 Signed-off-by: Cristian Le <cristian.le@mpsd.mpg.de>
* | | try_{compile,run}: add LINKER_LANGUAGE optionscivision2023-10-162-0/+10
|/ / | | | | | | Fixes: #25326
* | 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