summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Help: Drop development topic notes to prepare releaseBrad King2021-10-082-9/+0
| | | | | Release versions do not have the development topic section of the CMake Release Notes index page.
* Merge topic 'doc-3.22-relnotes'Brad King2021-10-0832-170/+151
|\ | | | | | | | | | | | | | | | | 9f0b52b8e6 Help: Update Sphinx versionadded directives for 3.22 release c632a7105c Help: Organize and revise 3.22 release notes 48e503ec78 Help: Consolidate 3.22 release notes Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6606
| * Help: Update Sphinx versionadded directives for 3.22 releaseBrad King2021-10-073-0/+6
| | | | | | | | | | | | | | | | | | Run the script: Utilities/Sphinx/update_versions.py --since v3.21.0 --overwrite Manually select updates that really belong to the 3.22 release, as against adding documentation for previously-existing entities.
| * Help: Organize and revise 3.22 release notesBrad King2021-10-071-69/+89
| | | | | | | | | | Add section headers similar to the 3.21 release notes and move each individual bullet into an appropriate section. Revise a few bullets.
| * Help: Consolidate 3.22 release notesBrad King2021-10-0729-170/+125
| | | | | | | | | | Run the `Utilities/Release/consolidate-relnotes.bash` script to move notes from `Help/release/dev/*` into `Help/release/3.22.rst`.
* | Merge topic 'tutorial_update_step_4'Brad King2021-10-0810-12/+14
|\ \ | |/ |/| | | | | | | | | 5a86ce5428 Tutorial: Step 4 improvements Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6564
| * Tutorial: Step 4 improvementsJoseph Snyder2021-10-0710-12/+14
| | | | | | | | | | | | | | | | | | | | | | Small changes to the text and CMake code for the fourth step of the tutorial: * Remove parameter from endfunction call * Standardize on "binary directory" for test location * Add additional information about a Release build. Issue: #22663
* | FindJasper: Add IMPORTED targetHiroshi Miura2021-10-061-0/+4
|/ | | | | Fixes: #20601 Signed-off-by: Hiroshi Miura <miurahr@linux.com>
* Merge topic 'tutorial_update_step_10'Brad King2021-10-061-0/+10
|\ | | | | | | | | | | | | 5632933304 Tutorial: Add version update instructions to Step 10 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6580
| * Tutorial: Add version update instructions to Step 10Joseph Snyder2021-10-051-0/+10
| | | | | | | | | | | | | | Add instructions to update the cmake_minimum_required version to 3.15 just before the usage of COMPILE_LANG_AND_ID Issue: #22663
* | Merge topic 'find-blas-lapack-sizeof-integer'Brad King2021-10-061-0/+6
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 64038fd5bc Help: Add release notes for Find{BLAS,LAPACK} BLA_SIZEOF_INTEGER option 972489ae4e Find{BLAS,LAPACK}: Provide testing of BLA_SIZEOF_INTEGER 95219365ff Find{BLAS,LAPACK}: Make possible testing of ILP64 model 2cd94f3e57 Find{BLAS,LAPACK}: Specify integer type in tests 9b69307b56 Find{BLAS,LAPACK}: De-duplicate and generalize test creation logic 91fd645d46 FindLAPACK: Stop processing if LAPACK library does not have 64-bit integer API b8a3cea51f FindBLAS: Stop processing if BLAS library does not have 64-bit integer API d2f5c7856f FindLAPACK: Search 32/64-bit integer API via BLA_SIZEOF_INTEGER if possible ... Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6407
| * | Help: Add release notes for Find{BLAS,LAPACK} BLA_SIZEOF_INTEGER optionBrad King2021-10-051-0/+6
| | |
* | | Merge topic 'fetchcontent-CMAKE-vars-passthrough'Craig Scott2021-10-067-19/+40
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | | | | | | | 1851aa49be FetchContent: Pass through networking-related CMAKE_... variables 96937438b7 Help: Clean up how TLS and NETRC variables are discussed 2a82bd85b6 Help: Add documentation for CMAKE_TLS_CAINFO Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6589
| * | FetchContent: Pass through networking-related CMAKE_... variablesCraig Scott2021-10-055-12/+24
| | | | | | | | | | | | | | | | | | | | | CMAKE_TLS_VERIFY, CMAKE_TLS_CAINFO, CMAKE_NETRC and CMAKE_NETRC_FILE are now passed through to the underlying ExternalProject sub-build. Previously, they were silently ignored. Fixes: #22144
| * | Help: Clean up how TLS and NETRC variables are discussedCraig Scott2021-10-041-10/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Mention of the fallback of the command options to the CMAKE_... variables was repeated in places. The wording was also a bit unclear about whether the fallback only occurred when neither TLS or neither NETRC option was given to the command. Move the fallback details directly to each relevant option instead. Also use cross-referencing to the variables where it was not linked previously.
| * | Help: Add documentation for CMAKE_TLS_CAINFOCraig Scott2021-10-043-2/+13
| | |
* | | Merge topic 'tutorial_update_step_11'Brad King2021-10-052-5/+45
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6dade88d1c Tutorial: Add documentation on Package helper functions 1bf25b5b5f Tutorial: Remove information about EXPORT keyword Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6575
| * | | Tutorial: Add documentation on Package helper functionsJoseph Snyder2021-09-302-1/+41
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add documentation for the configure_package_config_file() and write_basic_package_version_file() commands. Update the comment for the installation of those files to allow a stopping point for the code display. Issue: #22663
| * | | Tutorial: Remove information about EXPORT keywordJoseph Snyder2021-09-301-4/+4
| |/ / | | | | | | | | | | | | Remove the text that implies that the EXPORT keyword will also install the generated CMake file.
* | | Merge topic 'default_extensions'Brad King2021-10-0436-81/+402
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 4a0485be7f cmStandardLevelResolver: Avoid unnecessary flags, fix unset level logic 29e2b85171 Tests: Simplify RunCMake.CompileFeatures introspection fc3a1cbdd8 CompilerID: Compiler extensions default detection 2adfd95d79 CompilerID: Rename language_dialect to language_standard 00055d7779 Help: Document CMAKE_<LANG>_STANDARD_DEFAULT a65bee4cfc Help: Document HIP standard/extensions properties and variables a40ff1bb5a Help: Make language standard/extensions variable pages less wordy 3feff8379b Help: Generic language standard and extension variables documentation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6177
| * | | cmStandardLevelResolver: Avoid unnecessary flags, fix unset level logicRaul Tambre2021-09-295-6/+96
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The changes are part of CMP0128. When the standard level is unset: * Flags are added if extension mode doesn't match the compiler's default. Previously logic only worked if LANG_EXTENSIONS was ON. Fixes #22224. * The full flag is used. Previously CMAKE_LANG_EXTENSION_COMPILE_OPTION was used. This was only supported for IAR. Otherwise: * Avoid adding flags if not necessary per the detected compiler defaults. * Fixed check for when the requested standard is older. It now matches the nearby comments. I reworded the fallback comment as its logic was a bit difficult to wrap my head around.
| * | | CompilerID: Compiler extensions default detectionRaul Tambre2021-09-282-0/+8
| | | |
| * | | Help: Document CMAKE_<LANG>_STANDARD_DEFAULTRaul Tambre2021-09-282-0/+8
| | | | | | | | | | | | | | | | Seems to be stable and will referred to by policy for standards flags rework.
| * | | Help: Document HIP standard/extensions properties and variablesRaul Tambre2021-09-288-0/+122
| | | |
| * | | Help: Make language standard/extensions variable pages less wordyRaul Tambre2021-09-2815-75/+30
| | | | | | | | | | | | | | | | | | | | | | | | They all had two sentences describing the same thing. Furthermore, with the shorter wording the explicit advice to see the property being initialized for further information seems unnecessary.
| * | | Help: Generic language standard and extension variables documentationRaul Tambre2021-09-288-0/+138
| | | | | | | | | | | | | | | | | | | | | | | | Add generic documentation to improve the discoverability of language-specific ones and to make it possible to refer to them generically from other language generic documentation.
* | | | Merge topic 'tutorial-regex'Brad King2021-10-049-9/+9
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 0f17b37b96 Tutorial: Fix regexps in sample CMakeLists.txt files Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6572
| * | | | Tutorial: Fix regexps in sample CMakeLists.txt filesChristophe Bernard2021-09-309-9/+9
| |/ / / | | | | | | | | | | | | | | | | | | | | Replace original regexp `[-nan|nan|0]` with `(-nan|nan|0)` which is what the author most likely intended to write in the first place.
* | | | Merge topic 'tutorial-step1'Brad King2021-10-041-23/+47
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 14600a42c8 Tutorial: Update Step 1 instructions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6576
| * | | | Tutorial: Update Step 1 instructionsBetsy McPhail2021-09-301-23/+47
| | |/ / | |/| | | | | | | | | | | | | | To demonstrate how simple a CMake project can be, move the `Build and Run` section earlier in the step.
* | | | Merge topic 'tutorial-step5'Brad King2021-10-041-1/+4
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 01c332c9c7 Tutorial: Clarify instructions in Step 5 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6577
| * | | | Tutorial: Clarify instructions in Step 5Betsy McPhail2021-09-301-1/+4
| |/ / /
* | | | Merge topic 'compile-feature-version-tags'Craig Scott2021-10-033-1/+21
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | b75f778531 Help: Detailed version tags for compiler known features Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6562
| * | | Help: Detailed version tags for compiler known featuresFeRD (Frank Dana)2021-10-013-1/+21
| |/ /
* | | 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
| | | | |
generated by cgit v0.12 at 2025-01-08 11:07:38 (GMT)