summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* 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).
* | MSVC: Add abstraction for debug information formatGlen Chung2022-09-141-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Replace our hard-coded default for `/Zi` with a first-class abstraction to select the debug information format an enumeration of logical names. We've long hesitated to do this because the idea of "debug information format" touches on related concepts on several platforms. Avoid that scope creep by simply defining an abstraction that applies only when targeting the MSVC ABI on Windows. Removing the old default flag requires a policy because existing projects may rely on string processing to edit them and choose a runtime library under the old behavior. Add policy CMP0141 to provide compatibility. Fixes: #10189
* | Merge topic 'try_compile-unique-bindir'Brad King2022-09-072-46/+79
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | aa9220d3a0 try_compile: Add keyword-dispatched signature d1befe5515 cmSystemTools: Add MakeTempDirectory Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Acked-by: Matthew Woehlke <matthew.woehlke@kitware.com> Merge-request: !7579
| * | try_compile: Add keyword-dispatched signatureMatthew Woehlke2022-09-052-46/+79
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Introduce a new signature for try_compile (and try_run) which removes the `bindir` argument and requires the SOURCES tag. This will eventually allow us to add other ways of providing sources, but also allows us to change the behavior without breaking compatibility. The old signature uses a special, but non-unique temporary location inside the specified `bindir`, which conventionally is just the project's build directory. The new signature unconditionally uses the a unique temporary directory which is unconditionally within the project's build directory (which is no longer separately specified). This ensures that successive runs do not overwrite previous runs, will simplify debugging, and should also, eventually, allow us to execute multiple trials in parallel.
* | | return(): Propagate variables to result scopeMarc Chevrier2022-09-033-4/+39
| | | | | | | | | | | | Fixes: #23871
* | | Merge topic 'CMAKE_FIND_USE_INSTALL_PREFIX-support-staging-prefix'Brad King2022-08-312-2/+4
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 0fc10bb19b CMAKE_FIND_USE_INSTALL_PREFIX considers CMAKE_STAGING_PREFIX 43d31c5198 cmFindBase: Refactor CMAKE_FIND_USE_INSTALL_PREFIX handling Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !7623
| * | | CMAKE_FIND_USE_INSTALL_PREFIX considers CMAKE_STAGING_PREFIXRobert Maynard2022-08-302-2/+4
| | | | | | | | | | | | | | | | Fixes #23900
* | | | Merge topic 'doc-CMP0134-fixes'Brad King2022-08-312-19/+19
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 7dca3807f8 Help: Fix typos, grammar and formatting in CMP0134 policy docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7620
| * | | | Help: Fix typos, grammar and formatting in CMP0134 policy docsCraig Scott2022-08-302-19/+19
| | | | |
| * | | | Help: Add crossrefs to ctest output control optionsCraig Scott2022-08-191-1/+4
| | | | |
* | | | | Merge topic 'file-DOWNLOAD-existing-file-matched-message'Craig Scott2022-08-261-2/+5
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 666b3c6f13 Help: Clarify file(DOWNLOAD) behavior for existing file with same hash 87a40b720a file(DOWNLOAD): Fix message for existing file with matching hash Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7599
| * | | | | Help: Clarify file(DOWNLOAD) behavior for existing file with same hashMichael Hirsch2022-08-231-2/+5
| | | | | |
* | | | | | Add new flow-control commands for variables and policies scopes managementMarc Chevrier2022-08-225-6/+138
|/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add block() and endblock() commands offering the capability to create new scopes for variables and/or policies. Fixes: #20171
* | | | | Help: Add crossrefs to ctest output control optionsCraig Scott2022-08-191-1/+5
| | | | |
* | | | | Merge branch 'backport-3.24-doc-ctest_test-output-control' into ↵Craig Scott2022-08-191-1/+1
|\ \ \ \ \ | |/ / / / | | | / / | |_|/ / |/| | | doc-ctest_test-output-control
| * | | Help: Add missing closing quote on C++ exampleCraig Scott2022-08-191-1/+1
| |/ /
* | | Help: Fix formatting of CMAKE_EXPERIMENTAL_CXX_MODULE_CMAKE_API notesBrad King2022-08-093-10/+10
| | |
* | | Merge topic 'doc-markup-program-options'Brad King2022-08-0810-26/+31
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | a6abdf6c8f Help: Consistent options declaration -- short first, then long f4563f05db Help: Value for `--graphviz=` option actually is mandatory 04843d743e Help: Replace a bunch of more ``--option`` to `:option:` role 09446266ee Help: Replace mentions of ``-D`` option with :option:`-D` role b57f27b087 Help: Replace mentions of ``-T`` and ``-A`` options with role d25b232dee Help: Replace mentions of ``-G`` option with :option:`-G` role 63940e1cab Help: Replace mentions of ``-C`` option with :option:`-C` role 183a49cbfe Help: Replace mentions of ``-S`` option with :option:`-S` role ... Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7544
| * | | Help: Replace a bunch of more ``--option`` to `:option:` roleAlex Turbov2022-08-048-22/+27
| | | |
| * | | Help: Replace mentions of ``-S`` option with :option:`-S` roleAlex Turbov2022-08-042-4/+4
| | | |
* | | | Merge topic 'find_package-one-more-path'Brad King2022-08-051-0/+1
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 19366408fe cmFindPackageCommand: Protect overrides of `cmDirectoryListGenerator` e55c154c5b cmFindPackageCommand: Add one more search path Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7542
| * | | | cmFindPackageCommand: Add one more search pathAlex Turbov2022-08-041-0/+1
| |/ / / | | | | | | | | | | | | | | | | | | | | The `PREFIX/(Foo|foo|FOO).*/(cmake|CMake)/(Foo|foo|FOO).*/` search path is the similar to the one already exists `PREFIX/(Foo|foo|FOO).*/(lib/ARCH|lib*|share)/cmake/(Foo|foo|FOO).*/`.
* | | | Merge topic 'doc-find_package-typo'Brad King2022-08-041-2/+2
|\ \ \ \ | |/ / / |/| / / | |/ / | | | | | | | | | 5635d33656 Help: Fix reST syntax typo in find_package docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7540
| * | Help: Fix reST syntax typo in find_package docsEisuke Kawashima2022-08-031-2/+2
| | |
| * | Merge topic 'doc-if-PATH_EQUAL' into release-3.24Brad King2022-07-262-9/+15
| |\ \ | | | | | | | | | | | | | | | | | | | | | | | | 37e01773e4 Help: Clarify behavior of path-based equality conditions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7503
* | \ \ Merge topic 'doc-if-PATH_EQUAL'Brad King2022-07-262-9/+15
|\ \ \ \ | | |/ / | |/| | | | | | | | | | | | | | | | | | 37e01773e4 Help: Clarify behavior of path-based equality conditions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7503
| * | | Help: Clarify behavior of path-based equality conditionsCraig Scott2022-07-242-9/+15
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The docs for if(PATH_EQUAL) did not mention the component-wise nature of the checks. It also claimed no normalization was performed, but multiple separators are effectively collapsed (part of normalization). Improve the wording to clarify both of these points. Also update the corresponding description of cmake_path(COMPARE), which had the same inaccuracy. Fixes: #23758
* | | | Merge topic 'doc-find_package-BYPASS_PROVIDER'Brad King2022-07-251-2/+12
|\ \ \ \ | | |/ / | |/| | | | | | | | | | | | | | | | | | | | | | 4f7a0c25d2 Help: Document BYPASS_PROVIDER keyword for find_package() 76370e06b8 Help: Minor grammar fix for the Using Dependencies manual Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7501
| * | | Help: Document BYPASS_PROVIDER keyword for find_package()Craig Scott2022-07-231-2/+12
| |/ / | | | | | | Fixes: #23669
* | | Merge topic 'try_run_split_output'Brad King2022-07-221-0/+13
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | a2cd0687db try_run: Add RUN_OUTPUT_STDOUT_VARIABLE and RUN_OUTPUT_STDERR_VARIABLE. Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !7453
| * | | try_run: Add RUN_OUTPUT_STDOUT_VARIABLE and RUN_OUTPUT_STDERR_VARIABLE.Patrick Northon2022-07-081-0/+13
| | | |