summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* cmake_language: Add EXIT subcommandleha-bot2024-01-161-0/+23
| | | | | | | | | | | | Add tests to cover these cases: * run as regular CMake module, in NORMAL_MODE (expected to fail); * run as CMake script in SCRIPT_MODE (expected to exit with given code); * run as CMake script that `include()`-s another script with EXIT subcommand; * run as CMake script which EVAL-uates EXIT subcommand via `cmake_language(EVAL CODE "<cmake code>")`. Fixes: #23162
* file: `STRINGS` + `REGEX` store match resultsCristian Le2024-01-091-0/+5
| | | | Signed-off-by: Cristian Le <cristian.le@mpsd.mpg.de>
* Merge topic 'doc-get-properties-inherited'Brad King2024-01-057-34/+32
|\ | | | | | | | | | | | | | | | | | | 8086badba4 Help: Fix wrong return values for unset inherited properties 1ca5ec67b0 Help: Add missing DIRECTORY keyword to set_tests_properties() signature 34379f005b Help: Use <variable> consistently in property getter commands 29ccc9a4cd Help: Use <xxx> for non-keyword arguments in property command signatures Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9131
| * Help: Fix wrong return values for unset inherited propertiesCraig Scott2024-01-053-22/+16
| | | | | | | | | | | | | | | | | | | | Since ff6234509e (Help: Clarify behavior of INHERITED properties, 2018-03-21), the docs for some get_..._property() commands incorrectly describe the behavior for inherited properties. When a property is not set, even in a parent scope, the returned result from the get_..._property() command is the same whether the property is inherited or not. The docs incorrectly stated that an empty string would be returned for inherited properties in such cases.
| * Help: Add missing DIRECTORY keyword to set_tests_properties() signatureCraig Scott2024-01-051-0/+1
| |
| * Help: Use <variable> consistently in property getter commandsCraig Scott2024-01-053-14/+14
| | | | | | | | | | | | | | | | Property-related commands used a mix of <VAR>, <var>, or <variable> to specify the variable to store the result in. The <VAR> form is particularly confusing, since being uppercase it looks more like a keyword. Use <variable> consistently across all the commands so that the behavior is clear.
| * Help: Use <xxx> for non-keyword arguments in property command signaturesCraig Scott2024-01-055-12/+15
| |
| * Merge topic 'HELP-string_LENGTH-link-error' into release-3.28Brad King2024-01-041-1/+1
| |\ | | | | | | | | | | | | | | | | | | 9702a01dc9 Help: string(LENGTH): Fix synopsis link to command description Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9113
| * \ Merge topic 'doc-xcframeworks-stubs-apple' into release-3.28Brad King2023-12-131-3/+3
| |\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | e831eef933 Help: Note case where IMPORTED_IMPLIB isn't needed for (xc)frameworks 01735badee Help: XCFrameworks and stubs are supported on all Apple, not just macOS 6ac50df591 Help: Add missing versionadded directives for IMPORTED_IMPLIB Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9058
* | \ \ Merge topic 'HELP-string_LENGTH-link-error'Brad King2024-01-041-1/+1
|\ \ \ \ | | |_|/ | |/| | | | | | | | | | | | | | | | | | 9702a01dc9 Help: string(LENGTH): Fix synopsis link to command description Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9113
| * | | Help: string(LENGTH): Fix synopsis link to command descriptionMarc Chevrier2024-01-031-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | Make the link target explicit to avoid ambiguity with `JSON LENGTH`. Fixes: #25546
* | | | Merge topic 'add_test-CROSSCOMPILING_EMULATOR-exclusive'Brad King2023-12-201-0/+6
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ca5a300d7f add_test: Honor CROSSCOMPILING_EMULATOR only when cross-compiling Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8947
| * | | | add_test: Honor CROSSCOMPILING_EMULATOR only when cross-compilingRalf Habacker2023-12-191-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add policy CMP0158 to provide compatibility for existing projects. Fixes: #23672
* | | | | Help: Fix typo in dependency provider method keywordCraig Scott2023-12-151-1/+1
|/ / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The cmake.vim file is generated by scanning for keyword-like strings in the docs. Update the corresponding wrong entry there too directly for now, which will fix the wrong entry until the next full regeneration of the file. Fixes: #25503
* | | | Merge topic 'cmake-test-launcher'Brad King2023-12-151-3/+25
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 88863d83d6 fileapi: Add test launcher to codemodel-v2 1ec0372ed4 add_test: Optionally use a launcher for tests running in-project targets 478a5f4e04 fileapi: Make launcher attribute 'arguments' optional b44e38a397 cmFileAPICodemodel: Add missing std::move() Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !8963
| * | | | add_test: Optionally use a launcher for tests running in-project targetsRalf Habacker2023-12-131-3/+25
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a `CMAKE_TEST_LAUNCHER` variable and corresponding `TEST_LAUNCHER` target property. Issue: #23672
* | | | | Merge topic 'doc-xcframeworks-stubs-apple'Brad King2023-12-131-3/+3
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | e831eef933 Help: Note case where IMPORTED_IMPLIB isn't needed for (xc)frameworks 01735badee Help: XCFrameworks and stubs are supported on all Apple, not just macOS 6ac50df591 Help: Add missing versionadded directives for IMPORTED_IMPLIB Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9058
| * | | | Help: XCFrameworks and stubs are supported on all Apple, not just macOSCraig Scott2023-12-091-3/+3
| | | | |
* | | | | Merge topic 'Help-create_test_sourcelist'Brad King2023-12-121-22/+21
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 464bc12bb7 Help/create_test_sourcelist: format arguments in the signature docs 131f9c9efa Help/create_test_sourcelist: add formatting markup 8540520902 Help/create_test_sourcelist: reflow prose Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9059
| * | | | Help/create_test_sourcelist: format arguments in the signature docsBen Boeckel2023-12-101-4/+4
| | | | |
| * | | | Help/create_test_sourcelist: add formatting markupBen Boeckel2023-12-091-7/+7
| | | | |
| * | | | Help/create_test_sourcelist: reflow proseBen Boeckel2023-12-091-18/+17
| |/ / /
* | | | Help: Use signature directive for the 'add_library' commandBrad King2023-12-062-142/+169
| | | | | | | | | | | | | | | | | | | | | | | | This allows individual signatures to be cross-referenced from elsewhere. It also associates with each signature its main documentation via indentation.
* | | | Help: Use signature directive for the 'add_executable' commandBrad King2023-12-061-34/+43
| | | | | | | | | | | | | | | | | | | | | | | | This allows individual signatures to be cross-referenced from elsewhere. It also associates with each signature its main documentation via indentation.
* | | | 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
| |
generated by cgit v0.12 at 2025-01-27 14:23:08 (GMT)