summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* 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
| * | Help: Make VALIDATOR wording clearer and more preciseCraig Scott2022-11-071-9/+14
| |/
| * Merge topic 'doc-cli-xrefs' into release-3.25Brad King2022-10-213-8/+8
| |\ | | | | | | | | | | | | | | | | | | 3043c17039 Help: Add more CLI `:option:` references to various pages Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7811
* | | string(TIMESTAMP): Add %z and %Z for adding time zone stringVasiliy Koyrev2022-10-271-0/+11
| | | | | | | | | | | | Fixes: #24056
* | | Merge topic 'doc-cli-xrefs'Brad King2022-10-213-8/+8
|\ \ \ | |/ / |/| / | |/ | | | | | | 3043c17039 Help: Add more CLI `:option:` references to various pages Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7811
| * Help: Add more CLI `:option:` references to various pagesAlex Turbov2022-10-203-8/+8
| |
* | Help: Mention CMake version for a recently-added `find_package` search pathAlex Turbov2022-10-201-1/+3
| | | | | | | | | | | | | | | | Add a `versionadded` mark for the search path added by commit e55c154c5b (cmFindPackageCommand: Add one more search path, 2022-06-27, v3.25.0-rc1~339^2~1). Fixes: #24067
* | Help: Reformat find_package search paths as Sphinx tablesAlex Turbov2022-10-201-21/+29
|/
* Merge topic 'doc-timestamp-f' into release-3.25Brad King2022-10-171-0/+2
|\ | | | | | | | | | | | | 7d25ae7350 Help: Add versionadded for string(TIMESTAMP) %f specifier Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7796
| * Help: Add versionadded for string(TIMESTAMP) %f specifierBrad King2022-10-141-0/+2
| | | | | | | | | | This was accidentally left out of commit c050d6a01e (string(TIMESTAMP): add %f specifier for microseconds, 2022-01-27, v3.23.0-rc1~59^2).
* | Help: Fix typo that crashes older pygments lexersBrad King2022-10-132-8/+8
| | | | | | | | | | | | | | | | In commit cb14ae2b87 (try_compile: Add SOURCE_FROM_{ARG,VAR}, 2022-09-21, v3.25.0-rc1~94^2~2) we accidentally added unbalanced closing `]` characters in the `try_compile` and `try_run` signatures. Fixes: #24053
* | Help: Minor grammar, typo and formatting cleanupsCraig Scott2022-10-091-3/+4
| |
* | Help: Disambiguate cmake(1) program modes in Sphinx option referencesBrad King2022-10-051-1/+1
| | | | | | | | | | | | Define the entry point to each mode as an option for the `cmake` program, but reference the options for that mode as part of stand-in `cmake-<mode>` programs.
* | Merge topic 'improve-try_compile-debug-documentation'Brad King2022-10-041-3/+3
|\ \ | | | | | | | | | | | | | | | | | | | | | 3801785cc3 Help: Improve try_compile debug documentation Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: alcroito <alexandru.croitor@qt.io> Merge-request: !7735
| * | Help: Improve try_compile debug documentationMatthew Woehlke2022-10-031-3/+3
| | | | | | | | | | | | | | | | | | Update the --debug-trycompile documentation to account for recent changes to try_compile. Mention where in the build tree to find artifacts when using said option.
* | | Merge topic 'fix-try_compile-doc-typo'Brad King2022-10-041-1/+1
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | ef05a56387 Help: Fix typo in try_compile documentation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7736
| * | | Help: Fix typo in try_compile documentationMatthew Woehlke2022-09-301-1/+1
| |/ /
* | | try_compile: Rename SOURCE_FROM_ARG -> SOURCE_FROM_CONTENTMatthew Woehlke2022-09-302-14/+15
|/ / | | | | | | | | | | | | | | | | Change the SOURCE_FROM_ARG keyword to try_compile to SOURCE_FROM_CONTENT (which we can do because it was recently added and hasn't been in a release yet). The new name should be clearer as to what it does, and also more consistent with the CONTENT arguments to some other commands. Also, fix a typo in an error message.
* | try_compile: Add NO_CACHE option (also try_run)Matthew Woehlke2022-09-282-1/+28
| | | | | | | | | | | | | | Add NO_CACHE option to try_compile and try_run, which places the results in regular, rather than cache, variables. Issue: #22799
* | Merge topic 'remove-vs10-generator'Brad King2022-09-271-1/+1
|\ \ | | | | | | | | | | | | | | | | | | 8d6f015d59 Drop Visual Studio 10 2010 generator Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7718
| * | Drop Visual Studio 10 2010 generatorBrad King2022-09-261-1/+1
| | | | | | | | | | | | This generator has been deprecated since CMake 3.22. Remove it.
* | | Merge topic 'add_subdirectory_system'Brad King2022-09-271-1/+8
|\ \ \ | |/ / |/| | | | | | | | | | | | | | 2eb30a7036 add_subdirectory: Add SYSTEM option Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7399
| * | add_subdirectory: Add SYSTEM optionDa Quexian2022-09-261-1/+8
| | | | | | | | | | | | | | | Fixes: #22401 Signed-off-by: Da Quexian <daquexian566@gmail.com>
* | | Merge topic 'try_compile-source-from'Brad King2022-09-232-6/+50
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 611d801790 try_compile: Add SOURCE_FROM_FILE a04eaf6742 Tests: Clean up and simplify TryCompile tests cb14ae2b87 try_compile: Add SOURCE_FROM_{ARG,VAR} Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !7700
| * | | try_compile: Add SOURCE_FROM_FILEMatthew Woehlke2022-09-222-2/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Add ability to copy try_compile (and try_run) source files from arbitrary locations into the operation directory. This is included for the sake of completion and consolidation, although use cases which actually require this may be rare.
| * | | try_compile: Add SOURCE_FROM_{ARG,VAR}Matthew Woehlke2022-09-222-6/+38
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add ability to "feed" try_compile (and try_run) sources more directly, either from literal content, or from a CMake variable which contains literal content. This saves the user from needing a separate step to write the content to a file, and allows for the sources to only exist in the scratch directory.
* | | | Help: Link from add_custom_target to policy on BYPRODUCTSHinell2022-09-191-0/+2
|/ / / | | | | | | | | | | | | | | | | | | | | | | | | Link policy explaining BYPRODUCTS. Apply the change from commit 00b788e85e (Help:custom_command: link policy on BYPRODUCTS, 2022-09-09) to `add_custom_target` docs too. Issue: #23786
* | | Merge topic 'transitive-usage-reqs-lnks'Brad King2022-09-198-25/+28
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 3d31f99b74 Help: Link from usage requirement commands to detailed explanation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7653
| * | | Help: Link from usage requirement commands to detailed explanationHinell2022-09-168-25/+28
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Augment vague mentions of "Transitive Usage Requirements" with links to a detailed explanation. Fixes: #23799
* | | | Merge topic 'help-add-custom-comman-byproducts'Brad King2022-09-191-0/+2
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 00b788e85e Help:custom_command: link policy on BYPRODUCTS Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7662
| * | | | Help:custom_command: link policy on BYPRODUCTSHinell2022-09-161-0/+2
| |/ / / | | | | | | | | | | | | | | | | | | | | Link policy explaining BYPRODUCTS. Fixes: #23786
* | | | try_compile: Add PROJECT keyword-dispatched signatureMatthew Woehlke2022-09-141-2/+16
|/ / / | | | | | | | | | | | | | | | | | | Introduce a new signature for the project flavor of try_compile (and try_run) which removes the `bindir` argument and adds a required PROJECT tag. This is similar to the SOURCES flavor added by commit aa9220d3 (try_compile: Add keyword-dispatched signature, 2022-09-02).