summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'fix-doc-manual-cmake-cxxmodules'Brad King2024-06-271-1/+1
|\ | | | | | | | | | | | | | | 727d25152b Help: Fix typo in cmake-cxxmodules(7) note syntax Acked-by: Kitware Robot <kwrobot@kitware.com> Reviewed-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !9625
| * Help: Fix typo in cmake-cxxmodules(7) note syntax權少2024-06-261-1/+1
| | | | | | | | | | Fix a typo from commit 5bbd2c12db (Help/cmake-cxxmodules: describe the compilation strategy, 2024-03-26, v3.30.0-rc1~251^2~22).
* | Merge topic 'preset-comments'Brad King2024-06-263-374/+1471
|\ \ | |/ |/| | | | | | | | | 7d2cc6ece6 presets: Allow comments in presets files Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9608
| * presets: Allow comments in presets filesAliaksandr Averchanka2024-06-243-374/+1471
| | | | | | | | | | Co-authored-by: Kanaiym <abdigak@clarkson.edu> Fixes: #22791
* | Link feature attributes: stabilizationMarc Chevrier2024-06-211-2/+2
|/ | | | | * enhance OVERRIDE handling * Update wording
* FetchContent: Force cmake --fresh to re-execute direct population stepsCraig Scott2024-06-071-3/+9
| | | | Issue: #25468
* Help: Clarify preset-specific macrosCristian Le2024-06-061-2/+7
| | | | | Closes: #26030 Signed-off-by: Cristian Le <cristian.le@mpsd.mpg.de>
* Merge topic 'doc-presets-cwd'Craig Scott2024-06-031-15/+21
|\ | | | | | | | | | | | | 15950197b0 Help: Presets read by --preset must be in the source directory Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9568
| * Help: Presets read by --preset must be in the source directoryCraig Scott2024-06-021-15/+21
| | | | | | | | Issue: #21911
* | Merge topic 'dep-provider-try_compile'Brad King2024-05-311-0/+1
|\ \ | |/ |/| | | | | | | | | | | 4cb5bb014d try_compile: Propagating top level includes into whole-project calls Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Robert Maynard <robertjmaynard@gmail.com> Merge-request: !9532
| * try_compile: Propagating top level includes into whole-project callsCraig Scott2024-05-301-0/+1
| | | | | | | | Fixes: #24151
* | Merge topic 'enforce-fc-fully-disconnected-requirements'Brad King2024-05-301-0/+1
|\ \ | | | | | | | | | | | | | | | | | | | | | f588421b58 FetchContent: Enforce FETCHCONTENT_FULLY_DISCONNECTED requirements Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !9556
| * | FetchContent: Enforce FETCHCONTENT_FULLY_DISCONNECTED requirementsCraig Scott2024-05-291-0/+1
| | | | | | | | | | | | | | | | | | | | | FETCHCONTENT_FULLY_DISCONNECTED should only be set to true if each dependency's source directory has already been populated. Previously, this wasn't being checked, but now it is (subject to a new policy).
* | | Merge topic 'deprecate-fetchcontent_populate'Brad King2024-05-291-0/+1
|\ \ \ | |/ / | | | | | | | | | | | | | | | | | | 4370fcf750 FetchContent: Deprecate FetchContent_Populate(depName) bc70b458ad Help: Minor grammar improvements for FetchContent Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9552
| * | FetchContent: Deprecate FetchContent_Populate(depName)Craig Scott2024-05-291-0/+1
| | | | | | | | | | | | | | | Projects should use FetchContent_MakeAvailable(depName) instead. Policy CMP0169 provides backward compatibility.
* | | HIP: Populate CMAKE_HIP_KNOWN_FEATURES global propertyBrad King2024-05-282-0/+2
|/ / | | | | | | Fixes: #26013
* | Merge topic 'genex-compiler-frontend-variant'Brad King2024-05-241-13/+126
|\ \ | | | | | | | | | | | | | | | | | | | | | af81b8667e GenEx: Add generator expr. for CMAKE_<LANG>_COMPILER_FRONTEND_VARIANT 8a11a39c51 Help: Use correct programming language names in docs of generator expr. Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9538
| * | GenEx: Add generator expr. for CMAKE_<LANG>_COMPILER_FRONTEND_VARIANTDeniz Bahadir2024-05-221-3/+116
| | |
| * | Help: Use correct programming language names in docs of generator expr.Deniz Bahadir2024-05-221-10/+10
| | |
* | | Merge topic 'ninja-parallel'Brad King2024-05-241-0/+1
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | 0e5250e63c Ninja: Add option for parallel install daeb8fffa2 Help: Add Builtin Targets section to Ninja help Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9505
| * | Ninja: Add option for parallel installMartin Duffy2024-05-231-0/+1
| | | | | | | | | | | | | | | | | | | | | Adds the global property ``INSTALL_PARALLEL`` to enable a parallel install target for Ninja. Fixes: #25459
* | | GenEx: Add support for custom transitive link propertiesBrad King2024-05-213-3/+29
| | | | | | | | | | | | | | | | | | | | | | | | | | | Teach the `$<TARGET_PROPERTY:...>` generator expression to check for a new `TRANSITIVE_LINK_PROPERTIES` property in the target's link closure to enable transitive evaluation of named properties through the link closure, including entries guarded by `$<LINK_ONLY:...>`. Fixes: #20416
* | | GenEx: Add support for custom transitive compile propertiesBrad King2024-05-213-0/+91
| | | | | | | | | | | | | | | | | | | | | | | | | | | Teach the `$<TARGET_PROPERTY:...>` generator expression to check for a new `TRANSITIVE_COMPILE_PROPERTIES` property in the target's link closure to enable transitive evaluation of named properties through the link closure, excluding entries guarded by `$<LINK_ONLY:...>`. Issue: #20416
* | | Help: Format TARGET_PROPERTY special evaluation rules as a definition listBrad King2024-05-211-16/+18
| | |
* | | Merge topic 'fetchcontent-direct'Craig Scott2024-05-181-0/+1
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 7bf15e49a8 ExternalProject: Fix misleading git update output b2496bf14c FetchContent: Populate directly without a sub-build 173daad58d ExternalProject: Move more internal commands out of main file 462e583267 ExternalProject: Switch download, update and patch to use _EP_ vars 0ccc8e340d ExternalProject: Provide ExternalProject_Add keywords through a macro 91e1015722 ExternalProject: Don't treat YES as a keyword a1743ce1ef ExternalProject: Fix minor formatting error Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: scivision <michael@scivision.dev> Merge-request: !9513
| * | FetchContent: Populate directly without a sub-buildCraig Scott2024-05-171-0/+1
| | | | | | | | | | | | Fixes: #21703
* | | GenEx $<LINK_LIBRARY>: Add the support of properties attached to featuresMarc Chevrier2024-05-151-0/+2
| | | | | | | | | | | | Fixes: #24504, #25954
* | | Help: Document TARGET_PROPERTY genex behavior on unset propertyBrad King2024-05-101-4/+6
|/ / | | | | | | | | | | Also add an explicit test for the case. Fixes: #25968
* | Help: Clarify TARGET_PROPERTY genex evaluation of transitive propertiesBrad King2024-05-071-12/+18
| | | | | | | | | | | | Regularize and fill out a documentation pattern from commit ddb9442f48 (GenEx: Fix TARGET_PROPERTY evaluation of transitive link properties, 2024-04-22).
* | Help: Add intro text to cmake-buildsystem(7) build properties sectionsBrad King2024-05-071-0/+12
| |
* | Merge topic 'FindBoost-remove'Brad King2024-05-061-0/+1
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | e0355c4ea9 FindBoost: Add policy to remove this module Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: Christoph Grüninger <foss@grueninger.de> Merge-request: !9488
| * | FindBoost: Add policy to remove this moduleBrad King2024-05-031-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Upstream Boost 1.70 and above provide a proper `BoostConfig.cmake` package configuration file. Packages for all major distros now provide it in at least one LTS release. Add a policy to pretend that the `FindBoost` module does not exist so that projects calling `find_package(Boost)` use the upstream package directly. Closes: #19402
* | | Help: Clarify cmake-buildsystem(7) compile properties section namesBrad King2024-05-032-11/+11
|/ / | | | | | | | | | | | | | | | | | | In commit 835f34949e (Help: Update cmake-buildsystem(7) build and usage requirements, 2024-04-23) we labeled the sections documenting `COMPILE_*` properties as "build properties". All the properties it documents are about compilation steps before linking, including the Autogen features for compiling Qt metadata, so rename the sections as "compile properties". This is also consistent with the name of the `$<COMPILE_ONLY:...>` generator expression.
* | Merge topic 'vs-filter-props'Brad King2024-05-021-0/+1
|\ \ | | | | | | | | | | | | | | | | | | | | | 56a96d1f1f VS: Add option to import .props in .vcxproj.filters files Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !9478
| * | VS: Add option to import .props in .vcxproj.filters fileshalx992024-05-011-0/+1
| | | | | | | | | | | | | | | | | | Adds new target property VS_FILTER_PROPS Fixes: #25948
* | | Merge topic 'genex-link-properties'Brad King2024-05-012-5/+15
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ddb9442f48 GenEx: Fix TARGET_PROPERTY evaluation of transitive link properties 862b8e28ad GenEx: Teach TARGET_PROPERTY evaluation to optionally pierce LINK_ONLY 8d1d6a1437 Tests: Cover TARGET_PROPERTY genex evaluation of transitive link properties abf607c2ec Tests: Cover TARGET_PROPERTY genex evaluation of transitive build properties 7d3d728a72 Help: Clarify CMP0099 documentation and summary text 79a3ae9a0d cmGeneratorExpressionDAGChecker: Simplify transitive property table e8010b67c7 cmGeneratorExpressionDAGChecker: Make local generator available in constructor b36fb3f6f1 cmGeneratorExpressionNode: Remove outdated lint suppression Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !9473
| * | | GenEx: Fix TARGET_PROPERTY evaluation of transitive link propertiesBrad King2024-04-292-4/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In commit bbba701899 (Link properties: must be transitive over private dependency on static library, 2019-12-06, v3.17.0-rc1~323^2) and commit af9d4f24ae (Link properties: must be transitive over private dependency on static library, 2019-12-11, v3.17.0-rc1~305^2) we neglected to implement CMP0099 NEW behavior for `TARGET_PROPERTY` evaluation. Add policy CMP0166 to fix this.
| * | | Help: Clarify CMP0099 documentation and summary textBrad King2024-04-291-1/+1
| |/ /
* | | Add CMAKE_<LANG>_STANDARD_LATEST variablesTyler2024-04-301-0/+1
|/ / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a variable to indicate the latest standard known to be supported for each language: * `CMAKE_C_STANDARD_LATEST` * `CMAKE_CXX_STANDARD_LATEST` * `CMAKE_CUDA_STANDARD_LATEST` * `CMAKE_HIP_STANDARD_LATEST` * `CMAKE_OBJC_STANDARD_LATEST` * `CMAKE_OBJCXX_STANDARD_LATEST` These variables, more generally referred to as `CMAKE_<LANG>_STANDARD_LATEST`, are assigned an integer value which represents the minimum between the latest version of the associated language standard supported by the current compiler and the latest version supported by CMake. Add documentation for these variables in a new page called `CMAKE_<LANG>_STANDARD_LATEST` was added under the "Variables for Languages" section of the `cmake-variables(7)` page. Update each compiler-specific CMake script under `${CMAKE_ROOT}\Modules\Compiler` to manually define the relevant `CMAKE_<LANG>_STANDARD_LATEST` variable as necessary. This will require updating and maintaining as newer compiler versions become recognized by CMake. Closes: #25717
* | Help: CMP0135 applies to FetchContent as wellCraig Scott2024-04-271-1/+1
| | | | | | | | | | | | | | | | This updates the CMP0135 documentation, which should have been done as part of c2044fdf3f (FetchContent: Respect the CMP0135 policy setting, 2022-06-02). Issue: #23560
* | Help: Document TARGET_PROPERTY genex handling of transitive propertiesBrad King2024-04-251-5/+33
| |
* | Help: Clarify role of TARGET_NAME generator expressionBrad King2024-04-251-4/+6
| |
* | Help: Organize target-dependent generator expressions into subsectionsBrad King2024-04-251-19/+36
| |
* | Help: Clarify cross-references to target-dependent generator expressionsBrad King2024-04-251-1/+1
| |
* | Help: Fix link in cmake-buildsystem(7)Brad King2024-04-251-1/+1
| | | | | | | | | | | | One local cross-reference added by commit 835f34949e (Help: Update cmake-buildsystem(7) build and usage requirements, 2024-04-23) had incorrect syntax.
* | Help: Update cmake-buildsystem(7) build and usage requirementsBrad King2024-04-243-87/+352
| | | | | | | | | | | | | | Re-organize the section to explicitly describe target-specific commands, build properties, and usage requirement properties. Add builtin transitive properties that have been created since the document was first written.
* | Merge topic 'doc-objc-lang-flags'Brad King2024-04-191-0/+2
|\ \ | | | | | | | | | | | | | | | | | | | | | 31e6017bb6 Help: Document ObjC/ObjC++ flag variables Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !9437
| * | Help: Document ObjC/ObjC++ flag variablesAlexander Borsuk2024-04-181-0/+2
| | | | | | | | | | | | Signed-off-by: Alexander Borsuk <me@alex.bio>
* | | cxxmodules: provide a detection variable for `import std`Ben Boeckel2024-04-182-0/+4
|/ /
* | Clang: support creating a target for imported modulesBen Boeckel2024-04-121-0/+1
| |