summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
...
| * | add_custom_command: Add DEPENDS_EXPLICIT_ONLY option for NinjaAbdelmaged Khalifa2023-02-141-1/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | Add option `DEPENDS_EXPLICIT_ONLY` to `add_custom_command` to indicate that implicit dependencies coming from users of the output are not needed, and only consider dependencies explicitly specified in the custom command. Fixes: #17097
* | | Help: math: note that floating point inputs are invalidscivision2023-02-141-1/+2
|/ /
* | Merge topic 'doc-find_package-root-case'Brad King2023-02-091-1/+2
|\ \ | |/ | | | | | | | | | | 20e727a408 Help: Clarify that <PackageName>_ROOT variable names are case-preserved Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8182
| * Help: Clarify that <PackageName>_ROOT variable names are case-preservedBrad King2023-02-081-1/+2
| | | | | | | | | | The name comes from the case-preserved first argument to `find_package`.
* | Merge topic 'KateImprovements'Brad King2023-02-071-1/+1
|\ \ | |/ |/| | | | | | | | | | | | | | | | | | | e7f7bff4f5 Kate: improve the way the VCS-specific files are searched 96389b4cd3 Kate: add support for hg and fossil 4c32623f5f Help: fix typo in docs for set_property() 9a7612d2d0 Kate: make it possible to force a mode for the "files" entry 8a7aa2642b Help: add documentation for Kate-related variable Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8154
| * Help: fix typo in docs for set_property()Alexander Neundorf2023-02-061-1/+1
| |
* | Help: Clarify interaction of execute_process *_FILE and *_VARIABLE optionsscivision2023-02-061-34/+40
|/ | | | | | | These parameters are so important that it's worthwhile to be more explicit about their interaction. Fixes: #24392
* Help: Clarify add_custom_command OUTPUT relative path behaviorBrad King2023-01-301-3/+12
| | | | Issue: #24372
* Help: configure_file doc example use `target_include_directories`Robert Maynard2023-01-251-2/+2
| | | | Fixes #24351
* Merge topic 'isdir_empty'Brad King2023-01-251-2/+6
|\ | | | | | | | | | | | | a1dc38a567 Help: Document behavior of if(EXISTS,IS_DIRECTORY) for empty paths Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8109
| * Help: Document behavior of if(EXISTS,IS_DIRECTORY) for empty pathsscivision2023-01-241-2/+6
| | | | | | | | | | | | | | | | | | | | Document and add explicit tests for empty string input: `if(EXISTS "")` and `if(IS_DIRECTORY "")` are always false. This avoids need for users to do extra checks due to CMake non-short-circuit logic as below: if("${p}") if(EXISTS "${p}")
* | Help: Update supported languages in project and enable_languageRobert Maynard2023-01-203-31/+31
|/
* message: Add CONFIGURE_LOG mode to record a message in the configure logBrad King2023-01-181-0/+50
| | | | | | | Provide a replacement for `file(APPEND .../CMake{Output,Error}.log)` that records messages in the configure log. Issue: #23200
* Help: Document configure log behavior in try_compile and try_runBrad King2023-01-182-0/+10
|
* try_compile: Add a NO_LOG option to skip recording in the configure logBrad King2023-01-162-0/+11
|
* try_compile: Add optional LOG_DESCRIPTION to record in configure logBrad King2023-01-162-0/+12
| | | | Issue: #23200
* Help: Fix typo in configure_file docsGustaf Borgström2023-01-111-1/+1
|
* Merge topic 'doc-SYSTEM'Craig Scott2022-12-191-11/+9
|\ | | | | | | | | | | | | dfab263825 Help: Clarify and update SYSTEM-related docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8027
| * Help: Clarify and update SYSTEM-related docsCraig Scott2022-12-171-11/+9
| |
* | Merge topic 'doc-updates'Marc Chevrier2022-12-181-11/+11
|\ \ | | | | | | | | | | | | | | | | | | 22d36aa0f8 Help: string(JSON): avoid duplicate labels Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8028
| * | Help: string(JSON): avoid duplicate labelsMarc Chevrier2022-12-171-11/+11
| |/
* | Merge topic 'doc-updates'Craig Scott2022-12-171-6/+7
|\ \ | |/ | | | | | | | | | | 2ee845c0a5 Help: Add version information for SYSTEM option of add_subdirectory Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8025
| * Help: Add version information for SYSTEM option of add_subdirectoryMarc Chevrier2022-12-161-6/+7
| |
* | COMPILE_DEFINITIONS property: ensure leading -D is removed in all casesMarc Chevrier2022-12-131-0/+3
| | | | | | | | Fixes: #24186
* | Help: Add add_custom_command example with output consumed by multiple targetsBrad King2022-12-081-3/+48
| | | | | | | | This is a common use case, so add an example demonstrating it.
* | Help: Drop misleading add_custom_command "makefile terms" explanationBrad King2022-12-071-4/+0
| | | | | | | | | | | | | | | | | | | | | | | | The "In makefile terms" explanation is left from very early days of CMake to help developers migrating from hand-written makefiles. These days it is often misinterpreted, particularly in the context of multiple `add_custom_command` calls, to mean that we generate a single Makefile containing rules for all custom commands. This leads to an incorrect mental model of the expressed build system. The actual generated build system may spread the rules across multiple targets that do not see the each other's file-level rules, which makes target-level dependencies important too.
* | Merge topic 'doc-SYSTEM'Brad King2022-12-071-3/+3
|\ \ | |/ | | | | | | | | | | b15b9cf286 Help: Clarify SYSTEM property default for imported targets Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7990
| * Help: Clarify SYSTEM property default for imported targetsBrad King2022-12-061-3/+3
| | | | | | | | | | | | The `SYSTEM` directory property does not affect imported targets. Fixes: #24219
| * Merge topic 'doc-block-return' into release-3.25Brad King2022-11-083-40/+78
| |\ | | | | | | | | | | | | | | | | | | 1046a61cfd Help: clean up and clarify block() and return() Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7872
* | \ Merge topic 'doc-add_compile_options-example'Craig Scott2022-11-291-4/+7
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | f03a1833e2 Help: Update compiler-specific add_compile_options() example and prose Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7959
| * | | Help: Update compiler-specific add_compile_options() example and proseMichael Hirsch2022-11-281-4/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Avoid hard-coding a warning-as-error flag now that CMake offers a first class abstraction for that. Also mention some relevant generator expressions which can be used to provide even more specific targeting with language-specific flags. Fixes: #24200
* | | | Help: Clarify behavior of BEFORE with target_compile_options()Craig Scott2022-11-271-1/+2
|/ / /
* | | Merge topic 'custom-command-comment-genex'Brad King2022-11-222-0/+8
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 26d813092b add_custom_{command,target}: add genex support for COMMENT 60a5a39022 cmCustomCommandGenerator: refactor GetComment to return std::string Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7887
| * | | add_custom_{command,target}: add genex support for COMMENTPeter Würth2022-11-192-0/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Evaluate and expand generator expressions in the `COMMENT` argument of the `add_custom_command()` and `add_custom_target()` commands. This allows to include generator expressions, e.g. a targets location $<TARGET_...> or the current configuration $<CONFIG>, in the build-time messages. Fixes #22507
* | | | Help: remove links from pages to themselvesBen Boeckel2022-11-186-6/+6
|/ / / | | | | | | | | | | | | At least the top-reference links. Internal `:ref:` usages have been left intact.
* | | file(COPY_FILE): Add option to retry on Windows if input access failsBrad King2022-11-171-1/+10
| | | | | | | | | | | | | | | | | | | | | | | | On Windows, a file may be inaccessible for a short time after it is created. This occurs for various reasons, including indexing, antivirus tools, and NTFS's asynchronous semantics. Add an `INPUT_MAY_BE_RECENT` option to tell CMake that the input file may have been recently created so that we can retry a few times to read it.
* | | file(ARCHIVE_CREATE): Allow higher compression level for ZstdAmir Masoud Abdol2022-11-161-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | This allows the Zstd compression-level to be set between 0-19. I've adjusted some of the tests, and error messages to indicates the selected algorithm, and min/max of its compression-level. Fixes: #24160
* | | project: Warn at top-level if `cmake_minimum_required` wasn't calledfriendlyanon2022-11-111-1/+2
| | | | | | | | | | | | | | | | | | | | | The top-level project() call will now issue an AUTHOR_WARNING if it wasn't called after cmake_minimum_required(). Fixes: #24071
* | | Merge topic 'doc-improvements'Brad King2022-11-1083-188/+440
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | d4d1f85297 Help: Move a note about arguments and genexes into include file 968224484f Help: Drop unused `PROPERTY_GENEX` replace from `prop_tgt/INTERFACE_*` files 65457e4fae Help: Add _See Also_ sections to related CMake commands c86ec79d07 Help: Use direct refs to genexes instead of ``$<GENEX-NAME>`` 8c6274326d Help: Use CMake highlighting for command synopsis c356a94512 Help: Use monospaced font for a genex name in a section title f98c8707f4 Help: Use `code-block:: cmake` instead of `::` for sub-commands descriptions 2ba351ca4f Help: ``CMake`` → CMake ... Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7873
| * | | Help: Move a note about arguments and genexes into include fileAlex Turbov2022-11-0912-52/+39
| | | |
| * | | Help: Add _See Also_ sections to related CMake commandsAlex Turbov2022-11-0944-43/+311
| | | |
| * | | Help: Use direct refs to genexes instead of ``$<GENEX-NAME>``Alex Turbov2022-11-095-16/+15
| | | |
| * | | Help: Use CMake highlighting for command synopsisAlex Turbov2022-11-0929-38/+38
| | | | | | | | | | | | | | | | Most of CMake commands use it. Fix a few of them to do the same.
| * | | Help: Use monospaced font for a genex name in a section titleAlex Turbov2022-11-091-2/+2
| | | |
| * | | Help: Use `code-block:: cmake` instead of `::` for sub-commands descriptionsAlex Turbov2022-11-072-21/+21
| | | | | | | | | | | | | | | | | | | | Most of CMake commands use syntax highlighting when describe sub-commands syntax. Fix a few of them to be like others...
| * | | Help: Unindent _See Also_ related commands listAlex Turbov2022-11-075-15/+13
| | | | | | | | | | | | | | | | To make it similar to other commands.
| * | | Help: Use role `:program:`Alex Turbov2022-11-061-3/+3
| | | | | | | | | | | | | | | | | | | | When mention execitable names use Sphinx semantic role `:program` instead of ``executable`` or **executable**.
* | | | Merge topic 'doc-block-return'Brad King2022-11-083-40/+78
|\ \ \ \ | | |_|/ | |/| | | | | | | | | | | | | | | | | | 1046a61cfd Help: clean up and clarify block() and return() Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7872
| * | | Help: clean up and clarify block() and return()Craig Scott2022-11-073-40/+78
| | | |
* | | | Merge topic 'doc-find-validator'Craig Scott2022-11-081-9/+14
|\ \ \ \ | |_|/ / |/| | / | | |/ | |/| | | | | | | 7e1a4567fb Help: Make VALIDATOR wording clearer and more precise Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7874