summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* Help: cmake-developer: Add section for Windows registry access.Marc Chevrier2022-09-041-64/+79
| | | | Fixes: #23905
* Help: Fix typos, grammar and formatting in CMP0134 policy docsCraig Scott2022-08-301-1/+1
|
* Help: Clarify that variable references may use cache entriesBrad King2022-08-181-6/+8
| | | | | | | | | Clarify in `cmake-language(7)` that a variable lookup may use a cache entry if the variable is not set. Fix misleading text in added by commit 8ba2a8d4a4 (Help: short/long variable reference in if command, 2018-11-01, v3.14.0-rc1~408^2~2). Fixes: #23863
* Help: Fix wrong syntax for $<PATH:REPLACE_EXTENSION,...>Craig Scott2022-07-241-1/+1
|
* Help: Add Whitespace And Quoting section to genex manualCraig Scott2022-07-191-0/+87
|
* Help: Restructure reference sections of genex manualCraig Scott2022-07-191-872/+866
| | | | | | | | As part of the general restructuring, also move the notes of a more introductory nature out of what was the "String-Valued Generator Expressions" section and up to the dedicated Introduction. This gives the reader a bit more of a foundation before they get to the heavier detail of the reference section.
* Help: Move reference content to its own section at end of genex manualCraig Scott2022-07-191-49/+53
| | | | | | | | | | | | | | This involves moving the Debugging section up to just after the introduction. The content of that section is unchanged. The reference section then follows, and since it is a dedicated section, all existing sections thereunder were demoted one level. Move the note about deviating from the usual CMake docs convention of using angle brackets around placeholders out of the Introduction and to the start of the reference section. No placeholders are used before that point, so that content no longer belongs in the introduction. Apply some minor wording cleanup to the content in the Introduction that remained.
* Help: Add missing versionadded for CUDA genexesCraig Scott2022-07-191-0/+4
|
* Help: Genex manual typo, grammar, formatting, wording fixesCraig Scott2022-07-191-35/+35
|
* Help: Boolean genex conditions must evaluate to 1 or 0Craig Scott2022-07-191-5/+8
|
* Help: Fix cross-references in genex manual that linked to wrong genexesCraig Scott2022-07-191-4/+4
|
* Genex LINK_LIBRARY and LINK_GROUP: check supported propertiesMarc Chevrier2022-07-061-6/+8
| | | | | | | Refines check for properties supporting these genex. Enhance error message. Fixes: #23699
* Help: Document $<TARGET_FILE> dependency behaviorRobert Maynard2022-07-051-0/+4
| | | | Fixes: #23686
* Help: Rework $<LINK_LIBRARY>, $<LINK_GROUP> and related docsCraig Scott2022-07-031-140/+148
| | | | | | | These changes restructure the docs to improve readability and flow, correct grammar and typos, and fix errors and inconsistencies in some of the examples. Fixes: #23684
* VS: Add variable to to turn off Visual Studio compile batchingBrad King2022-06-221-0/+1
| | | | | | | | | Extend the change from commit b764c7c273 (VS: Add property to turn off Visual Studio compile batching, 2022-02-07, v3.24.0-rc1~710^2) by adding a variable to initialize the property on every target. Issue: #23179 Fixes: #23639
* Help: Trivial grammar fixup in LINK_GROUPS genexCraig Scott2022-06-101-1/+1
|
* CheckIPOSupported: Compile check using flags of calling projectBrad King2022-06-101-1/+1
| | | | | | | | | | | | | | | | Forward `CMAKE_<LANG>_FLAGS` and `CMAKE_<LANG>_FLAGS_DEBUG` from the calling project into the test project. The set of flags may affect the availability of IPO support. Since this may change the result of the check for existing projects, add a policy for compatibility. This was discovered after commit 5fcadc481e (MSVC: Default to -ZI instead of /Zi for x86 and x64, 2022-05-24) introduced policy CMP0138 to switch our default for MSVC's debug info flag. The `-ZI` flag is incompatible with the `-GL` flag used for IPO, so CMP0138 was reverted pending future work on an alternative solution. Re-use the CMP0138 policy number for this change to CheckIPOSupported instead. Fixes: #23607
* MSVC: Revert "Default to -ZI instead of /Zi for x86 and x64"Brad King2022-06-091-1/+1
| | | | | | | | | | | | | | Revert commit 5fcadc481e (MSVC: Default to -ZI instead of /Zi for x86 and x64, 2022-05-24). The `-ZI` flag is incompatible with the `-GL` flag used for IPO, and so is not an unconditionally better default. Revert the change pending future design of a first-class setting for MSVC debug info format that can be automatically reconciled with IPO settings. That commit introduced policy CMP0138, but we already have later policy numbers used too. Leave placeholder text to avoid policy renumbering. Issue: #23607, #10189
* Merge topic 'if-command-PATH_EQUAL'Brad King2022-06-061-0/+1
|\ | | | | | | | | | | | | | | be4b9e10af if command: Add PATH_EQUAL operator Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7321
| * if command: Add PATH_EQUAL operatorMarc Chevrier2022-06-031-0/+1
| |
* | Help: genex: layout updatesMarc Chevrier2022-06-031-19/+22
|/ | | | | * create section for version comparisons * move $<LINK_LIBRARY> and $<LINK_GROUP> to "Output-Related Expressions" section
* Merge topic 'genex-PATH_EQUAL'Brad King2022-06-031-0/+13
|\ | | | | | | | | | | | | | | 4d1883df11 Genex-PATH_EQUAL: path comparison Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7309
| * Genex-PATH_EQUAL: path comparisonMarc Chevrier2022-06-011-0/+13
| | | | | | | | To complete issue #23498
* | Help: Document CMake version adding each preset version in cmake-presets(7)Brad King2022-06-011-1/+16
|/ | | | Fixes: #23485
* Genex-PATH: path handlingMarc Chevrier2022-05-311-0/+212
| | | | Fixes: #23498
* Merge topic 'msvc-compilers-default-to-ZI'Brad King2022-05-271-0/+1
|\ | | | | | | | | | | | | 5fcadc481e MSVC: Default to -ZI instead of /Zi for x86 and x64 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7295
| * MSVC: Default to -ZI instead of /Zi for x86 and x64Glen Chung2022-05-261-0/+1
| | | | | | | | | | | | | | | | | | | | Add a policy for compatibility. For more information, see [1]. [1] https://docs.microsoft.com/en-us/cpp/build/reference/z7-zi-zi-debug-information-format?view=msvc-170 Fixes: #10189
* | VERIFY_INTERFACE_HEADER_SETS: Add property for list of header setsKyle Edwards2022-05-251-0/+1
|/ | | | | | | | Add a new property, INTERFACE_HEADER_SETS_TO_VERIFY, which contains a list of header sets that should be verified by VERIFY_INTERFACE_HEADER_SETS. Fixes: #23522
* Merge topic 'doc-hip-genex-versionadded'Brad King2022-05-241-0/+8
|\ | | | | | | | | | | | | 9f863cbd93 Help: Document when HIP_COMPILER generator expressions were added Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7289
| * Help: Document when HIP_COMPILER generator expressions were addedEisuke Kawashima2022-05-241-0/+8
| | | | | | | | | | These were added by commit b50bfc8913 (HIP: Add language to CMake, 2020-08-28, v3.21.0-rc1~66^2~4).
* | Merge topic 'find_item-doc-update'Brad King2022-05-191-0/+63
|\ \ | | | | | | | | | | | | | | | | | | 98af010b5c Help: Avoid duplicating registry query syntax in multiple find_* commands Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7278
| * | Help: Avoid duplicating registry query syntax in multiple find_* commandsMarc Chevrier2022-05-181-0/+63
| | | | | | | | | | | | | | | | | | In commit 8d7e80cf3d (find_* commands: add control over Windows registry views, 2022-04-16) we added documentation that is repeated by multiple find commands. Move it to a dedicated manual section to avoid duplication.
* | | Merge topic 'ignore-werror-command-arg'Brad King2022-05-191-0/+5
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 65f7053d6c COMPILE_WARNING_AS_ERROR: Add command-line option Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7268
| * | | COMPILE_WARNING_AS_ERROR: Add command-line optionMartin Duffy2022-05-181-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Add command-line option `--compile-no-warning-as-error` to ignore value of `COMPILE_WARNING_AS_ERROR`. Issue: #19085
* | | | VERIFY_HEADER_SETS: Rename to VERIFY_INTERFACE_HEADER_SETSKyle Edwards2022-05-182-2/+2
| |/ / |/| | | | | | | | Issue: #23448
* | | Merge topic 'try_compile-project-platform-vars'Brad King2022-05-172-0/+2
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | a6562ff579 try_compile: Add option to skip passing platform variables 4843a37676 try_compile: Propagate platform variables in project-mode too Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7265
| * | | try_compile: Add option to skip passing platform variablesBrad King2022-05-161-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a `CMAKE_TRY_COMPILE_NO_PLATFORM_VARIABLES` variable to tell `try_compile` not to pass platform variables to the test project. Issue: #23219
| * | | try_compile: Propagate platform variables in project-mode tooBrad King2022-05-161-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add policy CMP0137 to propagate both our builtin variables and those listed by `CMAKE_TRY_COMPILE_PLATFORM_VARIABLES` to `try_compile` whole-project builds. Inspired-by: Alexander Neumann <Alexander.Neumann@hamburg.de> Fixes: #23219
* | | | Merge topic 'CMAKE_PROJECT_TOP_LEVEL_INCLUDES'Brad King2022-05-161-0/+1
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | a6c34b0353 project(): Add new CMAKE_PROJECT_TOP_LEVEL_INCLUDES file injection point 8aa29a1793 CMakeDetermineSystem: Remove unreachable code Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !7250
| * | | | project(): Add new CMAKE_PROJECT_TOP_LEVEL_INCLUDES file injection pointCraig Scott2022-05-131-0/+1
| | | | | | | | | | | | | | | Fixes: #22685
* | | | | Merge topic 'presets-pathListSep'Brad King2022-05-131-0/+11
|\ \ \ \ \ | |_|/ / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | ba969ce5fe cmake-presets: add ${pathListSep} macro Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !7234
| * | | | cmake-presets: add ${pathListSep} macroErin Melucci2022-05-121-0/+11
| | | | | | | | | | | | | | | | | | | | Fixes: #23282
* | | | | Merge topic 'werror-property'Brad King2022-05-102-0/+2
|\ \ \ \ \ | | |_|/ / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 76a08cd253 COMPILE_WARNING_AS_ERROR: Add options to treat warnings as errors Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Acked-by: Michael Hirsch <michael@scivision.dev> Merge-request: !7187
| * | | | COMPILE_WARNING_AS_ERROR: Add options to treat warnings as errorsMartin Duffy2022-05-062-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add `COMPILE_WARNING_AS_ERROR` target property and supporting `CMAKE_COMPILE_WARNING_AS_ERROR` variable. `COMPILE_WARNING_AS_ERROR` is initialized by `CMAKE_COMPILE_WARNING_AS_ERROR`. It is a boolean variable. If it is true, it expands to a different flag depending on the compiler such that any warnings at compile will be treated as errors. Supports compiler ids that I could find a relevant flag for.
* | | | | OpenWatcom: Allow specifying the runtime libraryCameron Cawley2022-05-063-0/+3
| |_|/ / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | Add a `CMAKE_WATCOM_RUNTIME_LIBRARY` variable to control the runtime library selection. Add policy CMP0136 to switch to in place of the old hard-coded default flags. Fixes: #23178
* | | | Merge topic 'truncation_relnotes'Brad King2022-05-061-2/+8
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 99cad40172 Help: Document version of ctest(1) adding output truncation mode a6f2c13727 Help: Add release notes for test-output-truncation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7242
| * | | | Help: Document version of ctest(1) adding output truncation modeBrad King2022-05-051-2/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | While at it, fix mode value markup. Issue: #23206
* | | | | Merge topic 'FetchContent_find_package_integration'Craig Scott2022-05-061-0/+1
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 29e31e2825 Packages: Integrate FetchContent and find_package() Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: huangqinjin <huangqinjin@gmail.com> Merge-request: !5688
| * | | | | Packages: Integrate FetchContent and find_package()Craig Scott2022-05-031-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Allow FetchContent_MakeAvailable() to try a call to find_package() first, or redirect a find_package() call to FetchContent_MakeAvailable(). The user can set variables to control which of these are allowed or tried by default. Fixes: #21687
* | | | | | Merge topic 'HelpExit'Brad King2022-05-051-0/+12
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 0aea13d20b Help: for message(FATAL_ERROR), document nonzero exit code cc97725137 Help: document exit code of command cmake(1) Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7175
generated by cgit v0.12 at 2025-02-15 15:55:02 (GMT)