summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Help: Fix CMAKE_FIND_LIBRARY_SUFFIXES examples for WindowsRalf Habacker2021-09-291-2/+5
| | | | Fixes: #22697
* Merge topic 'tutorial_update_step_8'Brad King2021-09-282-3/+24
|\ | | | | | | | | | | | | f55a02a26e Tutorial: Enhance CTestConfig info in Step 8 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6565
| * Tutorial: Enhance CTestConfig info in Step 8Joseph Snyder2021-09-272-3/+24
| | | | | | | | | | | | | | | | | | | | | | Add a copy of the CTestConfig.cmake from Step 9 into the directory for Step 8. Expand the information about the contents of the CTestConfig file and write a brief explanation of where on CDash to acquire the CTestConfig file for a specific project. CMake Issue: #22663
* | Merge topic 'tutorial_update_stage_2'Brad King2021-09-271-2/+7
|\ \ | |/ |/| | | | | | | | | 68e0f72744 Tutorial: Describe placement of add_subdirectory Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6559
| * Tutorial: Describe placement of add_subdirectoryJoseph Snyder2021-09-241-2/+7
| | | | | | | | | | | | | | | | | | | | | | | | Clarify that the process of making a target optional in the second step of the tutorial is further steps to the work done before, not a separate addition to the file. Do this by ensuring that the paragraph which describes the work done mentions the placement and use of the previous command. This is done to avoid duplication of the add_subdirectory call. CMake Issue: #22663
* | Merge topic 'doc-find_package-restructure'Craig Scott2021-09-251-176/+231
|\ \ | |/ |/| | | | | | | | | | | 84e02be51c Help: Restructure the find_package() docs Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Brad King <brad.king@kitware.com> Merge-request: !6542
| * Help: Restructure the find_package() docsCraig Scott2021-09-231-176/+231
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The explanation of the basic and full signatures was interwoven tightly with that of the Module and Config search modes. Config mode is supported by both signatures, which made the structure of the command documentation a bit confusing. Add a section at the start which unambiguously describes the two modes, including the fallback functionality between them. Move the text about this out of the basic signature section, leaving just a description of the basic syntax with a note that it is supported by both search modes. This makes the basic signature section more focused. Drop the Module and Config mode parts of the titles for the basic and full signature sections. Those are now more precisely covered by the new opening section, so the Basic Signature and Full Signature sections are now clearer in what they cover. Swap the order of the Search Procedure and Version Selection sections to improve the logical flow. Also add "Config Mode" to their titles to make it clearer what they apply to. Add a note at the start of both sections to highlight their relationship to the basic and full signatures.
* | Merge topic 'doc-build-config'Craig Scott2021-09-223-68/+140
|\ \ | | | | | | | | | | | | | | | | | | | | | b8d10c27d1 Help: Restructure build type docs and clarify case sensitivity Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !6516
| * | Help: Restructure build type docs and clarify case sensitivityCraig Scott2021-09-213-68/+140
| | | | | | | | | Fixes: #22591
* | | Merge topic 'hip-no-hipcc'Brad King2021-09-203-2/+12
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | cb93f72624 HIP: Simplify detection of HIP runtime CMake package a71f0fc9c7 HIP: Remove ROMClang compiler id and use Clang directly b125e9809a HIP: Detect ROCm path earlier 735f41fc2d HIP: Use 'rocm_agent_enumerator' to determine CMAKE_HIP_ARCHITECTURES Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: Raul Tambre <raul@tambre.ee> Acked-by: Axel Huebl <axel.huebl@plasma.ninja> Merge-request: !6533
| * | | HIP: Remove ROMClang compiler id and use Clang directlyBrad King2021-09-162-1/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since commit bd844387df (ROCMClang: Add the ROCm toolkit derived clang compiler to CMake, 2020-08-28, v3.21.0-rc1~66^2~6) and commit ff0d2858e1 (HIP: Extract clang compiler details from hipcc, 2020-10-21, v3.21.0-rc1~66^2~5), the separate `ROCMClang` compiler id for `hipcc` has caused a few problems: * The compiler id changed from behavior of CMake 3.20 and below, breaking projects that already built with `hipcc` treated as `Clang`. * The implementation of `target_compile_features` was incomplete for the `ROCMClang` identity. * Only `hipcc` was identified as `ROCMClang`, so after it is unwrapped to the underlying `clang++`, future runs of new CMake versions on an existing build tree would not repeat this. * Clang should be usable as a HIP compiler without the `hipcc` wrapper. Remove the `ROMClang` compiler identity, and revise HIP language support to work directly with a Clang compiler. Reject direct `hipcc` usage as a HIP compiler. For now it cannot be supported because it interferes with flags CMake needs to pass to Clang. Fixes: #22536, #22460, #22593
| * | | HIP: Use 'rocm_agent_enumerator' to determine CMAKE_HIP_ARCHITECTURESZack Galbreath2021-09-161-1/+2
| | | |
* | | | Merge branch 'release-3.20'Brad King2021-09-201-2/+2
|\ \ \ \ | |_|_|/ |/| | |
| * | | CMake 3.20.6v3.20.6Brad King2021-09-201-2/+2
| | | |
* | | | Merge topic 'clarify_cmake_policy_warning_doc'Brad King2021-09-161-2/+3
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 1230ceb97e Help: Improve explanation on CMAKE_POLICY_WARNING warnings occur Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6522
| * | | | Help: Improve explanation on CMAKE_POLICY_WARNING warnings occurRobert Maynard2021-09-151-2/+3
| | | | |
* | | | | Merge topic 'vs2022'Brad King2021-09-162-3/+9
|\ \ \ \ \ | |/ / / / |/| | / / | | |/ / | |/| | | | | | | | | | | | | | b6ac10394b VS: Update Visual Studio 17 2022 generator for Preview 4 f200f4d5a7 VS: Fix managed C++ project generation for VS 2022 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6524
| * | | VS: Update Visual Studio 17 2022 generator for Preview 4Brad King2021-09-152-3/+9
| | | |
* | | | Merge topic 'find-matlab-imported-targets'Brad King2021-09-141-0/+4
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 161990b921 FindMatlab: Add imported targets Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !6488
| * | | | FindMatlab: Add imported targetsSilvio Traversaro2021-09-131-0/+4
| | | | |
* | | | | Merge topic 'CMakeDependentOption-condition-syntax'Brad King2021-09-143-0/+46
|\ \ \ \ \ | |_|_|_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | 059b90a0b4 CMakeDependentOption: Introduce policy CMP0127 for full Condition Syntax Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !6493
| * | | | CMakeDependentOption: Introduce policy CMP0127 for full Condition SyntaxDaniel Schürmann2021-09-103-0/+46
| |/ / / | | | | | | | | | | | | Fixes: #22303
* | | | Merge topic 'document_find_package_version_restrictions'Craig Scott2021-09-111-5/+6
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 563139e5e9 Help: find_package document version only supports numeric components Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6510
| * | | | Help: find_package document version only supports numeric componentsRobert Maynard2021-09-091-5/+6
| |/ / /
* | | | Merge topic 'vs_settings'Brad King2021-09-102-1/+11
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | f21158cdfe VS: Honor VS_SETTINGS source file property on all sources 3bf013632d cmVisualStudio10TargetGenerator: Factor out helper to write VS_SETTINGS Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6492
| * | | | VS: Honor VS_SETTINGS source file property on all sourcesSteven Boswell2021-09-092-1/+11
| |/ / / | | | | | | | | | | | | | | | | | | | | Extend the feature added by commit 2ce42f281f (VS: Add VS_SETTINGS source file property, 2020-03-18, v3.18.0-rc1~449^2~3) to support all source file types.
* | | | Merge topic 'ctest-memcheck-generate-test.xml'Brad King2021-09-102-1/+8
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | | | | | ce44c2cec3 ctest_memcheck: generate `DynamicAnalysis-Test.xml` as well Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !6491
| * | | ctest_memcheck: generate `DynamicAnalysis-Test.xml` as wellBen Boeckel2021-09-092-1/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | This is useful so that memcheck results also show up as test results on CDash. It will be submitted with the other `MemCheck` parts. Fixes: #22190
* | | | Help: Mention that Qt6 is supported by AUTOGENJoerg Bornemann2021-09-063-10/+13
| | | | | | | | | | | | Co-Authored-By: Craig Scott <craig.scott@crascit.com>
* | | | Help: Document that toolchain files may set implicit link informationBrad King2021-09-022-5/+33
| | | | | | | | | | | | | | | | | | | | | | | | Document in `CMAKE_<LANG>_IMPLICIT_LINK_{LIBRARIES,DIRECTORIES}` how their value is used and that a fallback value may be provided by a toolchain file.
* | | | Merge topic 'cmake-packages-pkg-cfg-file-example'Brad King2021-09-021-1/+1
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | d186797cf6 Help: Fix regex in example of cmake-packages(7) Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !6489
| * | | | Help: Fix regex in example of cmake-packages(7) Johel Ernesto Guerrero Peña2021-08-281-1/+1
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This change makes it work as intended as opposed to make the condition always true. This can be confirmed by running the following script: ``` [johel@sundown tmp]$ cat x.cmake function(f) set(valid_inputs abc 123) foreach(input ${ARGV}) if(";${valid_inputs};" MATCHES input) message("old valid: ${input}") endif() if(";${valid_inputs};" MATCHES ";${input};") message("new valid: ${input}") endif() endforeach() endfunction() f("0;z;123;12;abc;ab;13;ac") set(_supported_components Plot Table) set(ClimbingStats_FIND_COMPONENTS Plot Table P T) foreach(_comp ${ClimbingStats_FIND_COMPONENTS}) if(NOT ";${_supported_components};" MATCHES _comp) message("old invalid: set(ClimbingStats_NOT_FOUND_MESSAGE \"Unsupported component: ${_comp}\")") endif() if(NOT ";${_supported_components};" MATCHES ";${_comp};") message("new invalid: set(ClimbingStats_NOT_FOUND_MESSAGE \"Unsupported component: ${_comp}\")") endif() endforeach() [johel@sundown tmp]$ cmake -P x.cmake new valid: 123 new valid: abc old invalid: set(ClimbingStats_NOT_FOUND_MESSAGE "Unsupported component: Plot") old invalid: set(ClimbingStats_NOT_FOUND_MESSAGE "Unsupported component: Table") old invalid: set(ClimbingStats_NOT_FOUND_MESSAGE "Unsupported component: P") new invalid: set(ClimbingStats_NOT_FOUND_MESSAGE "Unsupported component: P") old invalid: set(ClimbingStats_NOT_FOUND_MESSAGE "Unsupported component: T") new invalid: set(ClimbingStats_NOT_FOUND_MESSAGE "Unsupported component: T") ```
* | | | Help: Fix terminology for regular expression in if(MATCHES)Johel Ernesto Guerrero Peña2021-08-281-1/+1
|/ / / | | | | | | | | | | | | This was wrongly changed in commit ba90611225 (Help: Make synopsis of if command more compact; add section headers, 2018-10-05).
* | | Merge topic 'vs2022'Brad King2021-08-252-3/+6
|\ \ \ | |/ / | | | | | | | | | | | | | | | c8ec137da7 VS: Update Visual Studio 17 2022 generator for Preview 3.1 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6480
| * | VS: Update Visual Studio 17 2022 generator for Preview 3.1Brad King2021-08-252-3/+6
| | | | | | | | | | | | Issue: #22339
* | | Merge topic 'find-package-note'Brad King2021-08-251-1/+1
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | d7e521bcd3 Help: find_package: Tweak change description Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6477
| * | | Help: find_package: Tweak change descriptionFeRD (Frank Dana)2021-08-241-1/+1
| | | |
* | | | Merge topic 'host-distro-info'Brad King2021-08-242-39/+235
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | b9698f89df cmake_host_system_information: Make it available for all systems 5469c71a82 Refactor: Simplify `GetValue()` function calls 6c92f80f2e cmake_host_system_information: Also set `USED_FALLBACK_SCRIPT` efe139d1b8 cmake_host_system_information: Can run fallback scripts 1e65e4a6e5 cmake_host_system_information: Can read `/etc/os-release` file e808cbb1dd Testing: Convert `cmake_host_system_information` tests into `RunCMake` 9e831284e5 Documentation: Use definition list instead of tables 346f3de005 Refactor: Deduplicate code for `VS_nn_DIR` keys processing ... Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !6410
| * | | | cmake_host_system_information: Make it available for all systemsAlex Turbov2021-08-201-4/+2
| | | | | | | | | | | | | | | | | | | | Before it was Linux only.
| * | | | cmake_host_system_information: Can run fallback scriptsAlex Turbov2021-08-201-0/+67
| | | | |
| * | | | cmake_host_system_information: Can read `/etc/os-release` fileAlex Turbov2021-08-202-0/+51
| | | | |
| * | | | Documentation: Use definition list instead of tablesAlex Turbov2021-07-301-39/+119
| | | | | | | | | | | | | | | | | | | | | | | | | Transform tables into definition list for `cmake_host_system_information` command manual.
* | | | | Help: get/set_property: Fix SOURCE grammarsFeRD (Frank Dana)2021-08-232-3/+3
| |/ / / |/| | |
* | | | Merge topic 'GoogleTest-gtest-filter'Brad King2021-08-101-0/+6
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ea6a7dd1c2 GoogleTest: Add TEST_FILTER arg to gtest_discover_tests Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6406
| * | | | GoogleTest: Add TEST_FILTER arg to gtest_discover_testsAshish Sadanandan2021-08-051-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The `TEST_FILTER` argument can be used to filter tests during the discovery phase. It combines `--gtest_filter=<expr>` with the `--gtest_list_tests` argument when invoking the test excutable for listing defined tests. Fixes: #17493
* | | | | Merge topic 'symlinks-rebase-master'Brad King2021-08-105-0/+63
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 58d10cf6f1 Alternative symlink-creating mode for file(INSTALL ...) Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !6396
| * | | | | Alternative symlink-creating mode for file(INSTALL ...)Felix Lelchuk2021-08-025-0/+63
| | |/ / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | An new environment variable 'CMAKE_INSTALL_MODE' is introduced, which can be used to ask CMake to create symbolic links instead of copying files during a file(INSTALL ...). The operation is at the file level only, directory trees are still created using actual directories, not links. Signed-off-by: Felix Lelchuk <felix.lelchuk@gmx.de>
* | | | | Merge topic 'doc-find_package-components'Craig Scott2021-08-091-5/+20
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | b7d4567769 Help: Clarify find_package() component handling Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Brad King <brad.king@kitware.com> Acked-by: Michael Hirsch <michael@scivision.dev> Acked-by: Alex <leha-bot@yandex.ru> Merge-request: !6436
| * | | | | Help: Clarify find_package() component handlingCraig Scott2021-08-081-5/+20
| | |/ / / | |/| | | | | | | | Fixes: #22513
* | | | | Merge topic 'help_cmake_path'Brad King2021-08-091-2/+2
|\ \ \ \ \ | |/ / / / |/| | / / | | |/ / | |/| | | | | | | | | | bb19af546b Help: cmake_path: add missing parameter Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6431