summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* cmLocalGenerator: ignore scanned sources for unity buildsBen Boeckel2024-01-051-0/+4
|
* Help: Update missed text for dynamically generated resource spec filesCraig Scott2024-01-011-20/+28
|
* Merge topic 'fix-redirect-links' into release-3.28Craig Scott2024-01-011-1/+1
|\ | | | | | | | | | | | | 5a7927d028 Help: update lua.org links to be HTTPS Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9114
| * Help: update lua.org links to be HTTPSBen Boeckel2024-01-011-1/+1
| | | | | | | | This is now a permanent redirect, so update links accordingly.
* | Help: Note CMAKE_IOS_INSTALL_COMBINED deprecation in toolchains exampleCraig Scott2023-12-301-3/+5
| |
* | Help: Fix typo not accounting for addition of visionOSCraig Scott2023-12-301-1/+1
|/
* Merge branch 'release-3.27' into release-3.28Brad King2023-11-271-4/+4
|\
| * Merge branch 'release-3.26' into release-3.27Brad King2023-11-271-4/+4
| |\
| | * CMake 3.26.6v3.26.6Brad King2023-11-271-4/+4
| | |
| * | Merge branch 'doc-ctest-link-cdash' into release-3.27Brad King2023-11-211-2/+2
| |\ \ | | |/ | | | | | | Merge-request: !8998
| * | Merge branch 'fileapi-file-sets-base-dirs-relative' into release-3.27Brad King2023-11-201-1/+3
| |\ \ | | | | | | | | | | | | Merge-request: !8977
* | \ \ Merge topic 'doc-ctest-link-cdash' into release-3.28Brad King2023-11-221-2/+2
|\ \ \ \ | | |_|/ | |/| | | | | | | | | | | | | | | | | | 486c89dd6a Help: Fix ctest(1) manual links to www.cdash.org Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8998
| * | | Help: Fix ctest(1) manual links to www.cdash.orgBrad King2023-11-211-2/+2
| | |/ | |/| | | | | | | | | | | | | | | | | | | | | | When the link was updated to `https` by commit 52eac4573d (Help: Fix link to cdash.org from CTest manual, 2021-04-21, v3.21.0-rc1~262^2~2) the markup was incorrectly adjusted to show the link as part of the "See Also" section. It is meant to be the link destination for links in prose elsewhere in the manual. Fix the markup and move it to a clearer location. Also update the link to resolve a redirect.
* | | Merge topic 'fileapi-file-sets-base-dirs-relative' into release-3.28Brad King2023-11-201-1/+3
|\ \ \ | |/ / | | | | | | | | | | | | | | | | | | | | | a3a85524cd fileapi: Fix file sets' base directories relative to top source Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Reviewed-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !8977
| * | fileapi: Fix file sets' base directories relative to top sourceKyle Edwards2023-11-171-1/+3
| | | | | | | | | | | | | | | | | | | | | | | | This field was added by commit b3e9fb67bb (file-api: support exporting file set information, 2022-11-03, v3.26.0-rc1~389^2) but the relative path convention used elsewhere was accidentally left out. Fixes: #25422
* | | Help: Move deprecated properties to dedicated section權少2023-11-201-3/+3
| | |
* | | CMP0155: ignore scanning for sources if no scanner is availableBen Boeckel2023-11-012-2/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This allows for a more graceful transition for projects using C++20 without scanner support (e.g., Clang 15 or GCC 13). While newer compilers will (needlessly) scan, it allows C++20-using projects to use older compilers without having to set `CMAKE_CXX_SCAN_FOR_MODULES` to support newer CMake minimum versions. Fixes: #25357
* | | Help: Move some deprecated modules to the dedicated sections權少2023-10-201-4/+4
| | |
* | | Help: Document cmake-presets version 8Johel Ernesto Guerrero Peña2023-10-191-0/+3
| | | | | | | | | | | | | | | This was accidentally missed in commit f1a7179520 (presets: Add $schema property to JSON schema, 2023-09-07, v3.28.0-rc1~106^2).
* | | VS: Explicitly disallow C++ modules provided by imported targetsBen Boeckel2023-10-171-0/+1
| | | | | | | | | | | | | | | | | | | | | The `-ifcOnly` flag is understood by MSBuild, but there are unresolved questions about how to integrate with with CMake's model. See: #25328
* | | Help: Fix versionadded indentation in cmake-generator-expressions(7) manualBrad King2023-10-031-2/+2
| | | | | | | | | | | | | | | | | | Fix indentation of the `versionadded` markup added by commit 634079b86d (cmGeneratorExpressionEvaluator: Short-circuit boolean operators, 2023-09-11) to render the note in the appropriate scope.
* | | Merge topic 'cxxmodules-no-longer-experimental'Brad King2023-10-022-0/+73
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 437280b127 cxxmodules: scan C++ sources for imports by default 3cddd11649 Ninja: message about not compiled sources explicitly 068fde1c34 cmGeneratorTarget: use `this->` for method calls 197a6bf171 cxxmodules: rework control logic for scanning regular C++ sources 5eb7bd641a Tests/RunCMake/CXXModules: remove rules file requirement ff18acc301 CXXModules: remove `EXPERIMENTAL` from C++ module variable names 0c07f39006 cmExperimental: remove the flag for C++ modules 68caec9137 Help: add a manpage for cxxmodule support Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Pavel Solodovnikov <hellyeahdominate@gmail.com> Merge-request: !8828
| * | | cxxmodules: scan C++ sources for imports by defaultBen Boeckel2023-10-022-1/+2
| | | | | | | | | | | | | | | | | | | | Existing projects are not using C++ modules in their sources, so introduce policy CMP0155 to enable scanning by default.
| * | | cxxmodules: rework control logic for scanning regular C++ sourcesBen Boeckel2023-10-021-0/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Now that scanning support is no longer experimental, the logic for whether or not to scan C++ 20 sources is now important because all projects are now exposted to the logic. Make the scanning rules explicit in the documentation and rework the queries to localize all of the associated logic. A policy to handle the ultimate fallback logic will be implemented in a following commit.
| * | | Help: add a manpage for cxxmodule supportBen Boeckel2023-10-021-0/+55
| | | |
* | | | Merge topic 'ctest-timeout-flag'Brad King2023-10-021-1/+2
|\ \ \ \ | | |_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | d267c128a2 ctest: Restore support for --timeout values higher than default test timeout dd779a4bc2 Tests: Clarify RunCMake.CTestTimeout case name Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8851
| * | | ctest: Restore support for --timeout values higher than default test timeoutBrad King2023-09-291-1/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since refactoring in commit 0a5aeaf302 (cmCTestRunTest: Consolidate test timeout selection logic, 2023-05-04, v3.27.0-rc1~120^2) we accidentally truncate `--timeout` values to ctest's default `TimeOut`. Fix the logic to prefer the flag whenever the `TIMEOUT` property is not set. In combination with the prior refactoring, this also fixes a bug that caused `--timeout` values of 10000000 seconds or more to be ignored. Fixes: #23979
* | | | Merge topic 'help-arbitrary'Brad King2023-09-291-0/+15
|\ \ \ \ | |_|/ / |/| | | | | | | | | | | | | | | | | | | | | | | 4e50320978 Help: Allow help for arbitrary keywords Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8674
| * | | Help: Allow help for arbitrary keywordsMartin Duffy2023-09-271-0/+15
| | | | | | | | | | | | | | | | | | | | Changes `cmake --help [arg]` to search `Help/*/` instead of `Help/command/` Allows editors to easily display manual for `<cword>`
* | | | Merge topic 'hip-nvidia'Brad King2023-09-262-0/+2
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | fd982eec10 HIP: Add tests for special NVIDIA values of CMAKE_HIP_ARCHITECTURES 8c8b3f1bfa HIP: Fix support for -DCMAKE_HIP_ARCHITECTURES=native with NVCC b3e92775ab HIP: Add CMAKE_HIP_HOST_COMPILER when compiler is NVCC e43918b4ca HIP: Fix linking mixed-lang binary with CXX compiler and Makefile generators 4794505122 HIP: Do not require hip-lang package for NVIDIA platform 09d759dc7f HIP: Simplify exclusion of AMD device runtime with NVIDIA GPUs 2a60663670 HIP: Simplify CMAKE_GENERATOR references for determining compiler 8124950f6c CUDA: Generalize CMAKE_{CUDA => <LANG>}_HOST_COMPILER variable docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8836
| * | | | HIP: Add CMAKE_HIP_HOST_COMPILER when compiler is NVCCBrad King2023-09-251-0/+1
| | | | | | | | | | | | | | | | | | | | Also add `HIPHOSTCXX` environment variable.
| * | | | CUDA: Generalize CMAKE_{CUDA => <LANG>}_HOST_COMPILER variable docsBrad King2023-09-251-0/+1
| | | | |
* | | | | Merge topic 'doc1'Brad King2023-09-262-0/+18
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 449f5da373 Help:cmake(1): add versionadded back to 3.17 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8831
| * | | | | Help:cmake(1): add versionadded back to 3.17scivision2023-09-242-0/+18
| |/ / / /
* | | | | Merge topic 'genexp-no-eval'Brad King2023-09-261-0/+11
|\ \ \ \ \ | |/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 634079b86d cmGeneratorExpressionEvaluator: Short-circuit boolean operators Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: scivision <michael@scivision.dev> Acked-by: Pavel Solodovnikov <hellyeahdominate@gmail.com> Merge-request: !8791
| * | | | cmGeneratorExpressionEvaluator: Short-circuit boolean operatorsMartin Duffy2023-09-131-0/+11
| | | | |
* | | | | Merge topic 'hip-nvidia'Brad King2023-09-221-0/+1
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6546aa2a2a ci: Add HIP job using CUDA on NVIDIA GPUs 18158bf81c HIP: Add support for NVIDIA GPUs 127b6fa06b HIP: Add CMAKE_HIP_PLATFORM variable to specify GPU platform 90e23f40ee Tests/HIP/WithDefs: Clean up test case 9ebdf3281f Tests/HIP/ArchitectureOff: Cover HIP_ARCHITECTURES initialization cfec29196e ci: Add CUDA 11.8 to HIP 5.5 image 26470eb987 ci: Put HIP GPU platform in CMake_TEST_HIP Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8817
| * | | | | HIP: Add CMAKE_HIP_PLATFORM variable to specify GPU platformBrad King2023-09-211-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | For now, require the value to be `amd`, since that is the only platform we currently support.
* | | | | | Ninja: Allow compilation before generation of dependencies' private sourcesMartin Duffy2023-09-201-0/+1
|/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This requires knowing when a generated header is public, which we can model using file sets. Add policy CMP0154 to treat generated sources as private by default in targets with file sets. Generated public headers can be specified in public file sets. Fixes: #24959 Issue: #15555
* | | | | presets: Add $schema property to JSON schemaChenMoFeiJin2023-09-122-0/+32
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Many modern code editors have support for JSON Schema. When you specify the `$schema` property in a JSON file, the editor can provide features like auto-completion, error checking, etc., which can improve your efficiency when writing and modifying the `CMakePresets.json` file.
* | | | | presets: Add missing spaces in JSON schemaChenMoFeiJin2023-09-071-32/+32
| |/ / / |/| | |
* | | | Help: Update link to Qt 5 CMake docsBrad King2023-08-221-1/+1
| | | |
* | | | cmExportFileGenerator: export private compile info for C++ modulesBen Boeckel2023-08-171-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When consuming exported targets which contain C++ modules, the consuming project must be able to recompile BMI files using the original target's flags. This is because a module source may use some private target usage requirement but not want to propagate it to consumers. To facilitate this, export the private information as necessary for consumers to be able to perform the BMI compilations.
* | | | CTest: Add ability to dynamically generate resource spec fileKyle Edwards2023-08-102-0/+20
| | | | | | | | | | | | | | | | Issue: #25106
* | | | Merge topic 'doc-fixups-release-3.27'Craig Scott2023-08-071-3/+3
|\ \ \ \ | |/ / / |/| / / | |/ / | | | | | | | | | | | | | | | | | | 78e7ea598d cmLocalGenerator: Fix trivial spelling error in code comment 1285fe27ff Help: Improve formatting and fix wording for ENABLE_EXPORTS 91336d061c Help: Improve formatting and cross-references for DEPENDS_EXPLICIT_ONLY 03208d9e18 Help: Fix indenting within TARGET_RUNTIME_DLLS genex docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8688
| * | Help: Fix indenting within TARGET_RUNTIME_DLLS genex docsCraig Scott2023-08-041-3/+3
| | |
* | | exec_program(): Remove by policy CMP0153Kyle Edwards2023-07-251-0/+1
| | |
* | | file(REAL_PATH): resolve symlinks before '..' componentsRobert Maynard2023-07-201-0/+8
| | | | | | | | | | | | | | | | | | | | | | | | Previously REAL_PATH would collapse paths before resolving any symlinks so if `..` crossed a symlink the output from `REAL_PATH` would be wrong. It looked like REAL_PATH did this by mistake since it was a side-effect of ensuring we had an absolute path before resolving symlinks.
* | | Merge topic 'doc-list-genex'Brad King2023-07-141-57/+89
|\ \ \ | |/ / | | | | | | | | | | | | | | | 326a73a328 Help: Improve formatting and wording of LIST generator expressions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8621
| * | Help: Improve formatting and wording of LIST generator expressionsCraig Scott2023-07-131-57/+89
| | |