summaryrefslogtreecommitdiff
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Help: Clarify 'cmake --build' signature alternativesBrad King2021-07-131-1/+2
| | | | | | | | | | | | | | | | Documentation added by * commit 4f4f2028b8 (Help: Add documentation for buildPresets and testPresets, 2021-01-13, v3.20.0-rc1~51^2~7) * commit 676ecf0d37 (cmake-presets: Add build and test presets, 2020-12-14, v3.20.0-rc1~51^2~6) used square brackets in the `cmake --build` signature to indicate non-optional alternatives, which is not a typical convention. A common convention is to use parentheses instead, but in this case it is probably clearer to list the two signatures separately. Fixes: #22413
* Help: Fix preset example cmakeMinimumRequiredSérgio Martins2021-07-121-1/+1
| | | | | | | | Since commit 8bc5c8961e (CMakePresets.json: Add the ability to conditionally disable presets, 2021-03-10, v3.21.0-rc1~464^2) the example requires presets version 3 support, which is not available until CMake 3.21. CMake 3.20.0 can't open v3 presets. Make cmakeMinimumRequired compatible with the example's version.
* Merge topic 'help_toplevel' into release-3.21Brad King2021-07-082-0/+20
|\ | | | | | | | | | | | | 2df4badc5f Help: Note PROJECT_IS_TOP_LEVEL behavior w.r.t. ExternalProject Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6307
| * Help: Note PROJECT_IS_TOP_LEVEL behavior w.r.t. ExternalProjectMichael Hirsch2021-07-082-0/+20
| | | | | | | | | | | | | | Extend the documentation added by commit 96a7040107 (project: Define variables indicating whether project is top level, 2021-03-24, v3.21.0-rc1~443^2) to give some examples of how the variables are set in each context.
* | Help: Document when CUDA_STANDARD values were addedBrad King2021-07-081-1/+23
| | | | | | | | | | | | | | | | Note that some CUDA C++ language standard levels were added before any compilers actually supported them. In such cases, the value of `CUDA_STANDARD` gracefully degrades to the highest supported by the compiler (unless `CUDA_STANDARD_REQUIRED` is enabled). Therefore we can document support for each value based on when CMake learned of it.
* | Help: Document when OBJCXX_STANDARD values were addedBrad King2021-07-081-1/+21
| |
* | Help: Document when OBJC_STANDARD values as definition listBrad King2021-07-081-1/+10
|/
* Help: Note CXX_STANDARD values added vs. CMake versionMichael Hirsch2021-07-061-1/+25
|
* Help: Improve readability and accuracy of runtime deps-related contentCraig Scott2021-07-042-55/+64
| | | | | | Duplicated textual patterns are factored out to make the text more readable. The POST_INCLUDE_FILES and POST_EXCLUDE_FILES were also previously missing from the main syntax block for install(RUNTIME_DEPENDENCY_SET).
* Help: Tighten install(SCRIPT) wording for ALL_COMPONENTS optionCraig Scott2021-07-031-6/+7
| | | | | In particular, mention the mutually exclusive nature with the COMPONENT option. Fix the inconsistent way the versionadded details were added for that text too.
* Help: Add missing versionadded 3.21 for file(RENAME) optionsCraig Scott2021-07-031-0/+4
|
* Merge topic 'help_cstd' into release-3.21Brad King2021-07-021-1/+20
|\ | | | | | | | | | | | | 9c310ff075 Help: Note C_STANDARD values added in CMake 3.21 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6294
| * Help: Note C_STANDARD values added in CMake 3.21Michael Hirsch2021-07-011-1/+20
| | | | | | | | Issue: #22366
* | Help: Document VS generator support for Intel FortranBrad King2021-06-307-14/+21
|/ | | | | | | Extend the list of project types added by commit a82eb539f0 (Help: Describe the type of Visual Studio projects that can be generated, 2018-08-04, v3.13.0-rc1~227^2) to mention that Fortran projects are supported with Intel compiler integration.
* Merge topic 'CMP0126-WARNING' into release-3.21Brad King2021-06-302-1/+5
|\ | | | | | | | | | | | | | | 16208ac113 CMP0126: Add control for warnings Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !6282
| * CMP0126: Add control for warningsMarc Chevrier2021-06-292-1/+5
| | | | | | | | Fixes: #22353
* | CPack/RPM: Fix weak dep supportAlex Sweet2021-06-291-2/+4
|/ | | | | | | | | | RPM 4.11.3 for el7 contains backported support for the RPM weak dep tags. It only supports querying those tags, but rpmbuild can not make use of them. Since CPack relies on rpmbuild --querytags to check for support, this commit switches to rpm --suggests to check for support of weak dependencies. Fixes: #22350
* Merge topic 'genex-versionadded' into release-3.21Brad King2021-06-281-5/+105
|\ | | | | | | | | | | | | 7993aa3075 Help: Add versionadded tags to cmake-generator-expressions(7) Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6270
| * Help: Add versionadded tags to cmake-generator-expressions(7)FeRD (Frank Dana)2021-06-281-5/+105
| |
* | Merge topic 'Help-CMP0102-mention-warning-variable' into release-3.21Brad King2021-06-281-1/+3
|\ \ | | | | | | | | | | | | | | | | | | 894645d4a6 Help/CMP0102: mention the varible that controls CMP0102 warnings Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6275
| * | Help/CMP0102: mention the varible that controls CMP0102 warningsBen Boeckel2021-06-281-1/+3
| | | | | | | | | | | | | | | This was missed in the review of !4150, but was noticed during discussion of #22353.
* | | Merge topic 'doc-3.21-relnotes-supportedPlatforms' into release-3.21Brad King2021-06-281-3/+3
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | 82ea0aeae4 Help: Clarify 3.21 release note on supportedPlatforms Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6277
| * | Help: Clarify 3.21 release note on supportedPlatformsBrad King2021-06-281-3/+3
| | | | | | | | | | | | | | | | | | Avoid implying that the field is always present. Fixes: #22352
* | | Help/dev/experimental: Link to published P1689R4Brad King2021-06-281-8/+2
|/ /
* | VS: Add Visual Studio 17 2022 generatorBrad King2021-06-254-0/+69
| | | | | | | | Fixes: #22339
* | Help: Remove unnecessary Sphinx versionadded markup in VS toolset selectionBrad King2021-06-255-14/+21
|/ | | | | In a document that says "New in version 3.14", we do not need any blocks that say "New in version 3.8".
* Merge branch 'release-3.20' into release-3.21Brad King2021-06-211-0/+7
|\
| * Help: Add 3.20 release note section for 3.20.{3,4,5}Brad King2021-06-211-0/+7
| | | | | | | | | | | | Make it clear that the notes for these patch releases were not forgotten, and that there were simply no changes to documented features or interfaces.
| * Help: cmake_path: fix erroneous example for IS_PREFIXMarc Chevrier2021-06-121-3/+4
| |
* | Merge topic 'tutorial-sphinx-targets' into release-3.21Brad King2021-06-2112-0/+52
|\ \ | | | | | | | | | | | | | | | | | | 73898c4922 Tutorial: Make code snippets linkable Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6247
| * | Tutorial: Make code snippets linkableBrad King2021-06-1812-0/+52
| | | | | | | | | | | | | | | | | | Extend the change from commit 9e5bbb69ea (Tutorial: Add captions for code blocks, 2021-06-11) to also add a Sphinx named target to code blocks. Name each target after the change the code block makes.
* | | Help: Clarify the usage scope of source_groupHeiko Thiel2021-06-181-0/+3
|/ / | | | | | | Fixes: #18856
* | Help: Drop development topic notes to prepare releaseBrad King2021-06-172-9/+0
| | | | | | | | | | Release versions do not have the development topic section of the CMake Release Notes index page.
* | Merge topic 'doc-3.21-relnotes'Brad King2021-06-1761-343/+294
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | f119fbeec5 Help: Update Sphinx versionadded directives for 3.21 release 45acb61432 Help: Organize and revise 3.21 release notes 046aee0441 Help: Consolidate 3.21 release notes Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6226
| * | Help: Update Sphinx versionadded directives for 3.21 releaseBrad King2021-06-171-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | Run the script: Utilities/Sphinx/update_versions.py --since v3.20.0 --overwrite Manually remove directives generated in documents for long-existing features for which documentation was added.
| * | Help: Organize and revise 3.21 release notesBrad King2021-06-171-148/+204
| | | | | | | | | | | | | | | Add section headers similar to the 3.20 release notes and move each individual bullet into an appropriate section. Revise a few bullets.
| * | Help: Consolidate 3.21 release notesBrad King2021-06-1460-343/+236
| | | | | | | | | | | | | | | Run the `Utilities/Release/consolidate-relnotes.bash` script to move notes from `Help/release/dev/*` into `Help/release/3.21.rst`.
* | | Tutorial: Add infrastructure to preserve old links when renaming stepsBrad King2021-06-171-0/+9
| | |
* | | Tutorial: Add captions for code blocksJosef Angstenberger2021-06-1712-0/+52
| | |
* | | Tutorial: Small formatting improvementsJosef Angstenberger2021-06-1711-39/+43
| | | | | | | | | | | | | | | | | | - Use inline literals for all code fragments and names. - Add missing console code-blocks. - Always use c++, not c as code language.
* | | Tutorial: Fix links after splitting stepsJosef Angstenberger2021-06-175-14/+16
| | |
* | | Tutorial: Split steps into separate filesJosef Angstenberger2021-06-1713-931/+932
| | | | | | | | | | | | Fixes: #21737
* | | Tutorial: Break up intro paragraphBrad King2021-06-171-6/+7
|/ /
* | Merge topic 'objc-std-17-23'Brad King2021-06-141-0/+4
|\ \ | | | | | | | | | | | | | | | | | | | | | e8dc95ae1e ObjectiveC: Add C17 and C23 support Acked-by: Kitware Robot <kwrobot@kitware.com> Reviewed-by: Raul Tambre <raul@tambre.ee> Merge-request: !6219
| * | ObjectiveC: Add C17 and C23 supportGregor Jasny2021-06-111-0/+4
| | | | | | | | | | | | Issue: #22297
* | | Help: cmake_path: fix erroneous example for IS_PREFIXMarc Chevrier2021-06-121-3/+4
| | | | | | | | | | | | Fixes: #22302
* | | Merge topic 'p1689r4-updates'Brad King2021-06-111-0/+3
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ccc0466fc5 cmScanDepFormat: P1689R4: Implement source-path related fields 3e5b609547 cmScanDepFormat: P1689R4: Make work-directory optional aab9a5fc3e cmScanDepFormat: P1689R4: Factor out primary-output field b0a8fa959c cmScanDepFormat: P1689R4: Diagnose invalid provides/requires json type 82c867ad85 cmScanDepFormat: P1689R4: Flatten future-compile members into parent Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6202
| * | | cmScanDepFormat: P1689R4: Make work-directory optionalBen Boeckel2021-06-091-0/+1
| | | |
| * | | cmScanDepFormat: P1689R4: Factor out primary-output fieldBen Boeckel2021-06-091-0/+1
| | | |
| * | | cmScanDepFormat: P1689R4: Flatten future-compile members into parentBen Boeckel2021-06-091-0/+1
| |/ /