summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'doc-autogen' into release-3.29Brad King2024-02-0812-74/+128
|\ | | | | | | | | | | | | | | ccaf529c4e Autogen: Update Documentation 16cc011fa5 cmQtAutoGenGlobalInitializer: Improve Const-correctness Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9223
| * Autogen: Update DocumentationOrkun Tokdemir2024-02-0812-74/+128
| | | | | | | | | | | | | | * Add Qt 6 to documentation * Add explanation about `<ORIGIN>_autogen_timestamp_deps` Fixes: #25201
* | Help: Drop development topic notes to prepare releaseBrad King2024-02-062-9/+0
| | | | | | | | | | Release versions do not have the development topic section of the CMake Release Notes index page.
* | Help: Organize and revise 3.29 release notesBrad King2024-02-061-98/+135
| | | | | | | | | | Add section headers similar to the 3.28 release notes and move each individual bullet into an appropriate section. Revise a few bullets.
* | Help: Consolidate 3.29 release notesBrad King2024-02-0632-216/+165
| | | | | | | | | | Run the `Utilities/Release/consolidate-relnotes.bash` script to move notes from `Help/release/dev/*` into `Help/release/3.29.rst`.
* | Help: Reword if(EXISTS) suggestion to prefer if(IS_READABLE)Brad King2024-02-061-4/+3
| |
* | Help: Fix cmake_language(EXIT) signature anchorBrad King2024-02-061-5/+0
| |
* | Merge topic 'findopengl-glu-include-dir'Brad King2024-02-061-0/+7
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | aebebf72df FindOpenGL: Add support for a separate GLU include directory Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: Alex <leha-bot@yandex.ru> Merge-request: !9216
| * | FindOpenGL: Add support for a separate GLU include directoryJordan Williams2024-02-051-0/+7
| |/ | | | | | | | | | | | | | | | | Add a OPENGL_GLU_INCLUDE_DIR cache variable for `GL/glu.h` and attach it as an include directory to the `OpenGL::GLU` target. Also add a `OPENGL_INCLUDE_DIRS` result variable to list all include directories. Account for the GLU header when deciding whether GLU is found. Fixes: #25627
* | Merge topic 'doc-system-names'Brad King2024-02-052-0/+85
|\ \ | | | | | | | | | | | | | | | | | | ef2547bd6a Help: Document CMAKE_SYSTEM_NAME possible values Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9211
| * | Help: Document CMAKE_SYSTEM_NAME possible valuesPeter Kokot2024-02-052-0/+85
| |/ | | | | | | Fixes: #21489
* | Merge branch 'release-3.28'Brad King2024-02-051-2/+2
|\ \
| * | CMake 3.28.3v3.28.3Brad King2024-02-051-2/+2
| | |
* | | Merge topic 'doc-SOVERSION-first-component-VERSION'Brad King2024-02-053-4/+17
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | fcab4bee21 Help: Document conventional VERSION/SOVERSION relationship Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9177
| * | Help: Document conventional VERSION/SOVERSION relationshipSune Stolborg Vuorela2024-01-313-4/+17
| | | | | | | | | | | | Issue: #25626
* | | Merge topic 'add_custom_command-target-alias'Brad King2024-02-012-0/+8
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 3b07ec631d add_custom_command: Allow adding build event via ALIAS target Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9201
| * | | add_custom_command: Allow adding build event via ALIAS targetChen Linxuan2024-02-012-0/+8
| | | | | | | | | | | | | | | | Signed-off-by: Chen Linxuan <me@black-desk.cn>
* | | | Merge topic 'env-cmake-install-prefix'Brad King2024-01-315-5/+34
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 06af18b9db cmake: Allow CMAKE_INSTALL_PREFIX to be set by environment variable Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9200
| * | | | cmake: Allow CMAKE_INSTALL_PREFIX to be set by environment variableSilvio Traversaro2024-01-305-5/+34
| |/ / / | | | | | | | | | | | | Fixes: #25023
* | | | Merge topic 'test-define-prop'Brad King2024-01-301-0/+36
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | 6c3311d53b Help: Document property redefinition semantics 7aacae4e0e Tests: Add unit tests for property redefinition Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9136
| * | | Help: Document property redefinition semanticsFeRD (Frank Dana)2024-01-291-0/+36
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a section to the `define_property()` documentation which details the behavior when attempting to redefine an existing property. (The command is silently ignored.) Provide an example using `get_property()` to examine a property definition created with `define_property()`.
* | | | Merge branch 'release-3.28'Brad King2024-01-291-3/+3
|\ \ \ \ | | |_|/ | |/| |
| * | | CMake 3.28.2v3.28.2Brad King2024-01-291-3/+3
| | | |
| * | | Merge topic 'cxxmodules-no-unity' into release-3.28Brad King2024-01-103-0/+13
| |\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 63bbb3768d cmLocalGenerator: ignore scanned sources for unity builds 76b5383123 cmGlobalGenerator: add unity sources after computing target compile features 7fc2a83fe6 Tests/CXXModules: add a test with unity build support Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9118
* | \ \ \ Merge topic 'test-launcher-emulator-genex'Brad King2024-01-295-7/+20
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 13ece67a58 Add genex support to TEST_LAUNCHER and CROSSCOMPILING_EMULATOR b9ad73fcb2 cmTestGenerator: De-duplicate TEST_LAUNCHER and CROSSCOMPILING_EMULATOR impl Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9198
| * | | | | Add genex support to TEST_LAUNCHER and CROSSCOMPILING_EMULATORBrad King2024-01-295-7/+20
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Evaluate generator expressions in these properties, as they apply to `add_test`, `add_custom_command`, and `add_custom_target`. The `CMAKE_CROSSCOMPILING_EMULATOR` variable's `try_run` behavior occurs at configure time and so cannot support generator expressions.
* | | | | | Merge topic 'productbuild-domains-policy'Brad King2024-01-294-2/+45
|\ \ \ \ \ \ | |/ / / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 339ae33e55 CPack: Change CPACK_PRODUCTBUILD_DOMAINS default to true (CMP0161) 4e7f2397e4 CPack: Clear temporary variable after it is no longer needed Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9197
| * | | | | CPack: Change CPACK_PRODUCTBUILD_DOMAINS default to true (CMP0161)Craig Scott2024-01-284-2/+45
| | | | | | | | | | | | | | | | | | | | | | | | Fixes: #23351
* | | | | | Merge topic 'doc-configure_file'Brad King2024-01-271-63/+77
|\ \ \ \ \ \ | |/ / / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 682a513bbb Help: Organize configure_file documentation into sections Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Craig Scott <craig.scott@crascit.com> Merge-request: !9191
| * | | | | Help: Organize configure_file documentation into sectionsBrad King2024-01-261-63/+77
| | |_|_|/ | |/| | |
* | | | | Merge topic 'ctest-tests-from-file'Brad King2024-01-263-0/+46
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 701029726f ctest_test: add options INCLUDE_FROM_FILE and EXCLUDE_FROM_FILE dbacc1d5a8 ctest: add command line option to exclude tests listed in a given file 022f20f663 ctest: add command line option to run the tests listed in a given file Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Alex <leha-bot@yandex.ru> Merge-request: !9128
| * | | | | ctest_test: add options INCLUDE_FROM_FILE and EXCLUDE_FROM_FILEAlex Neundorf2024-01-252-0/+16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | These options can be used to specify files which can be used to restrict the set of tests that will be executed. Fixes: #25455
| * | | | | ctest: add command line option to exclude tests listed in a given fileAlex Neundorf2024-01-252-1/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add `--exclude-from-file <filename>` to exclude the tests listed in the given file. Issue: #25455
| * | | | | ctest: add command line option to run the tests listed in a given fileAlex Neundorf2024-01-252-0/+17
| |/ / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add `--tests-from-file <filename>` to run only the tests listed in the given file. The test names must match exactly, no regexps or something. The listed tests can still be filtered with a regexp using -R. Issue: #25455
* | | | | IntelLLVM: support marking include paths as SYSTEM directoriesBen Boeckel2024-01-241-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Also learn how to suppress warnings when possible. See: https://discourse.cmake.org/t/icx-on-windows-supports-external-i/8739
* | | | | Merge topic 'validate_read-only_target_properties'Brad King2024-01-242-0/+40
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 0cfd8fe8ad cmTarget: Don't allow setting read-only properties Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9133
| * | | | | cmTarget: Don't allow setting read-only propertiesRobert Maynard2024-01-232-0/+40
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Ensure that all documented read-only target properties now produce errors when trying to set.
* | | | | | Merge topic 'cuda-clang-windows'Brad King2024-01-231-0/+5
|\ \ \ \ \ \ | |_|/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 88c740462c CUDA/Clang: Add support for MSVC ABI on Windows using GNU-like frontend Acked-by: Kitware Robot <kwrobot@kitware.com> Reviewed-by: Raul Tambre <raul@tambre.ee> Merge-request: !9172
| * | | | | CUDA/Clang: Add support for MSVC ABI on Windows using GNU-like frontendBrad King2024-01-221-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | Fixes: #20776
* | | | | | MSVC: Teach find_library to consider the 'libfoo.a' naming conventionBrad King2024-01-191-0/+7
|/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When targeting the GNU ABI, we consider `.a` libraries first but also accept `.lib`. For symmetry, when targeting the MSVC ABI, we now consider `.lib` first but also accept `.a`. This adds support for meson-generated static libraries, which are named with the pattern `lib${foo}.a`: * https://mesonbuild.com/FAQ.html#why-does-building-my-project-with-msvc-output-static-libraries-called-libfooa Note that this was previously attempted by * commit be848a71b0 (MSVC: Teach find_library to consider the 'libfoo.a' naming convention, 2022-09-19, v3.25.0-rc1~111^2) but was reverted by * commit 955d6245c1 (MSVC: Revert "Teach find_library to consider the 'libfoo.a' naming convention", 2022-11-28, v3.25.1~6^2) due to problems finding GNU ABI libraries in PATH-derived prefixes. Since then, * commit 0a81110b84 (find_(library|file|path): Drop PATH-derived search prefixes, 2023-09-14, v3.28.0-rc1~91^2) removed the problematic search paths, so we can restore this change. Fixes: #23975
* | | | | Help: Document {CTEST,CMAKE_BUILD}_PARALLEL_LEVEL equivalent command-linescivision2024-01-182-2/+10
| | | | | | | | | | | | | | | | | | | | | | | | | Clarify that the `--parallel` option isn't needed when these env. variables are set to a finite integer.
* | | | | Merge topic 'autogen-exe-per-config'Brad King2024-01-184-0/+34
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 596e84b0d5 NinjaMultiConfig: Update tests for the new dependency change 7c39dabdbc Autogen: AUTO*_EXECUTABLE: add support for per-config values Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !8919
| * | | | | Autogen: AUTO*_EXECUTABLE: add support for per-config valuesOrkun Tokdemir2024-01-174-0/+34
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Per-config values were added to `AUTO*_EXECUTABLE`. * Dependency order was refactored for `cmake_autogen` and `cmake_autorcc` to avoid unnecessary rebuilds. * A new parameter was added for `cmake_autogen` and `cmake_autorcc` to specify the config name of the `auto*_executable` to be used. * Add `AUTOGEN_BETTER_GRAPH_MULTI_CONFIG` target property to change the behavior of the dependency graph. * The timestamp target is split into three targets for per-config to avoid redundant `mocs_compilation` builds when `AUTOGEN_BETTER_GRAPH_MULTI_CONFIG` is ON * Per-config `DEP_FILE_RULE_NAME` values were added to `AutogenInfo.json` for `Multi-Config` usage. * Some functions were refactored to avoid code duplication. This commit reimplements fddd0f0443b4ce81d61f15ee1b2f13105967b25a Fixes: #20074
* | | | | | Merge topic 'cmake-language-exit-code'Brad King2024-01-172-0/+28
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 1bb1769235 cmake_language: Add EXIT subcommand 4f160f7906 cmakemain: Return the SCRIPT_MODE exit code if it was set b62dcbf5d2 cmMakefile: check cmake script mode exit code after command 3d9d504646 cmMakefile: Store the exit code from cmExecutionStatus to cmake instance 9f6c937408 Source/cmake.h: Add ScriptModeExitCode for proper storing exit code 1082b9cb9a cmExecutionStatus: Add ability to set optional custom exit code Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: Leonid Pospelov <pospelovlm@yandex.ru> Acked-by: NoMaY (a user of Renesas Rulz Japanese Forum) <nomay-jp@outlook.com> Merge-request: !8228
| * | | | | | cmake_language: Add EXIT subcommandleha-bot2024-01-162-0/+28
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add tests to cover these cases: * run as regular CMake module, in NORMAL_MODE (expected to fail); * run as CMake script in SCRIPT_MODE (expected to exit with given code); * run as CMake script that `include()`-s another script with EXIT subcommand; * run as CMake script which EVAL-uates EXIT subcommand via `cmake_language(EVAL CODE "<cmake code>")`. Fixes: #23162
* | | | | | | Help: Fix typo in CMP0156 documentationBrad King2024-01-161-1/+1
| |_|/ / / / |/| | | | |
* | | | | | Help: Clarify standard policy advice paragraph wording on how policies are setBrad King2024-01-111-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | Avoid implying that a policy must always be set explicitly.
* | | | | | Help: Drop current CMake version from standard policy advice paragraphBrad King2024-01-111-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Every policy documents whether CMake warns when it is not set. This behavior does not change with the CMake version, so avoid possibly confusing mention of the current CMake version.
* | | | | | Help: Normalize and consolidate standard policy advice paragraphBrad King2024-01-11152-557/+510
|/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
* | | | | Merge topic 'file-strings-regex-match'Brad King2024-01-114-2/+30
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | fa00928bcd file: `STRINGS` + `REGEX` store match results ff0085cf74 Help: Drop incorrect versionadded mark from CMAKE_MATCH_<n> Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9124