summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* Help: Fix location of install() note about superseded commandsFeRD (Frank Dana)2024-03-281-10/+10
| | | | | | | The note regarding commands superseded by install() somehow wound up nested under the install(EXPORT) signature, when it has nothing to do with install(EXPORT). Move it to the top level, immediately before the Examples section.
* Help: Remove stray formatting for try_compile() LINKER_LANGUAGE keywordCraig Scott2024-03-221-1/+1
|
* Merge topic 'doc-release-3.29-typos' into release-3.29Brad King2024-03-191-1/+1
|\ | | | | | | | | | | | | | | eceb368ccc Help: Fix typos in 3.29 docs 31fb693d06 Help: Fix typos and grammar in pre-3.29 docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9353
| * Help: Fix typos in 3.29 docsCraig Scott2024-03-191-1/+1
| |
* | Help: Specify advisable range for exit code in cmake_language(EXIT)Craig Scott2024-03-191-2/+7
|/ | | | | The limitations added here are documented in the bash shell's reference manual.
* Help: Update project() code injection for new 3.29 include behaviorCraig Scott2024-03-161-6/+6
| | | | | | Specifically, the various CMAKE_PROJECT_...INCLUDE... variables can now take a list of things, and those things can be module names too, not just file names.
* EXPORT_PACKAGE_DEPENDENCIES: Add experimental feature gateBrad King2024-03-122-2/+10
| | | | | | | Some design concerns have been raised after trying the 3.29 release candidates. Avoid committing to a stable public interface for now. Issue: #25767
* ctest: Allow passing -j without value to choose a contextual defaultBrad King2024-03-101-4/+9
| | | | | | | | | | | | | Under job server integration, added by commit 80fe56c481 (ctest: Add support for running under a make job server on POSIX systems, 2023-11-15, v3.29.0-rc1~324^2), use a very high default so that parallelism is effectively limited only by available job server tokens. Otherwise, choose a default limit based on the number of processors. Also allow passing `0` to specify unbounded parallelism. Fixes: #25739
* Help/add_custom_command: fix verb grammoBen Boeckel2024-02-281-1/+1
|
* Merge topic 'Help-file-ARCHIVE_EXTRACT-mention-working-dir' into release-3.29Brad King2024-02-271-0/+7
|\ | | | | | | | | | | | | 189d28d77d Help/file: mention the working directory for `ARCHIVE_EXTRACT` Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9291
| * Help/file: mention the working directory for `ARCHIVE_EXTRACT`Ben Boeckel2024-02-271-0/+7
| | | | | | | | See: https://discourse.cmake.org/t/10135
* | Help: Document create_test_sourcelist source path conventionBrad King2024-02-221-0/+5
| | | | | | | | | | Document the change in commit a29ca55b1f (create_test_sourcelist: use the full path to the driver, 2023-12-09, v3.29.0-rc1~264^2).
* | Help: Modernize create_test_sourcelist documentationBrad King2024-02-221-26/+54
|/
* Help: Explicitly discourage absolute install destinationsRobert Maynard2024-02-161-13/+16
| | | | | Document some of the problems caused by absolute install destinations. Encourage use of relative paths.
* Help: Fix example for return commandJohannes Schultz2024-02-151-1/+1
| | | | | `cmake_minimum_required` is the correct command, not `cmake_version_required`.
* Merge topic 'doc-autogen' into release-3.29Brad King2024-02-081-1/+1
|\ | | | | | | | | | | | | | | ccaf529c4e Autogen: Update Documentation 16cc011fa5 cmQtAutoGenGlobalInitializer: Improve Const-correctness Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9223
| * Autogen: Update DocumentationOrkun Tokdemir2024-02-081-1/+1
| | | | | | | | | | | | | | * Add Qt 6 to documentation * Add explanation about `<ORIGIN>_autogen_timestamp_deps` Fixes: #25201
* | Help: Reword if(EXISTS) suggestion to prefer if(IS_READABLE)Brad King2024-02-061-4/+3
| |
* | Help: Fix cmake_language(EXIT) signature anchorBrad King2024-02-061-5/+0
|/
* Merge topic 'add_custom_command-target-alias'Brad King2024-02-011-0/+3
|\ | | | | | | | | | | | | 3b07ec631d add_custom_command: Allow adding build event via ALIAS target Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9201
| * add_custom_command: Allow adding build event via ALIAS targetChen Linxuan2024-02-011-0/+3
| | | | | | | | Signed-off-by: Chen Linxuan <me@black-desk.cn>
* | Merge topic 'test-define-prop'Brad King2024-01-301-0/+36
|\ \ | |/ |/| | | | | | | | | | | | | 6c3311d53b Help: Document property redefinition semantics 7aacae4e0e Tests: Add unit tests for property redefinition Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9136
| * Help: Document property redefinition semanticsFeRD (Frank Dana)2024-01-291-0/+36
| | | | | | | | | | | | | | | | | | Add a section to the `define_property()` documentation which details the behavior when attempting to redefine an existing property. (The command is silently ignored.) Provide an example using `get_property()` to examine a property definition created with `define_property()`.
* | Merge topic 'doc-configure_file'Brad King2024-01-271-63/+77
|\ \ | | | | | | | | | | | | | | | | | | | | | 682a513bbb Help: Organize configure_file documentation into sections Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Craig Scott <craig.scott@crascit.com> Merge-request: !9191
| * | Help: Organize configure_file documentation into sectionsBrad King2024-01-261-63/+77
| | |
* | | ctest_test: add options INCLUDE_FROM_FILE and EXCLUDE_FROM_FILEAlex Neundorf2024-01-251-0/+12
|/ / | | | | | | | | | | | | These options can be used to specify files which can be used to restrict the set of tests that will be executed. Fixes: #25455
* | 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.