summaryrefslogtreecommitdiff
path: root/Help/variable
Commit message (Collapse)AuthorAgeFilesLines
* VS: Select Windows SDK matching WindowsSDKVersion env varBrad King2023-04-051-0/+8
| | | | | | | | | | In an environment established by `vcvarsall.bat` or similar, this environment variable may be set to select a Windows SDK version. If the VS generator is used in such an environment, use that SDK. This is similar to how `CMAKE_GENERATOR_INSTANCE` defaults using a `VS##0COMNTOOLS` environment variable. Fixes: #17992
* VS: Select latest available Windows SDK version by defaultBrad King2023-04-051-0/+3
| | | | | | | Add policy `CMP0149` to stop preferring SDKs exactly matching `CMAKE_SYSTEM_VERSION` over the latest SDK. Fixes: #16202
* VS: Add support for setting WindowsTargetPlatformVersion to 10.0Brad King2023-04-051-0/+4
| | | | | | | VS 2019 and above support this value to select a SDK version automatically. Fixes: #21403
* VS: Add CMAKE_GENERATOR_PLATFORM field to control Windows SDK selectionBrad King2023-04-053-8/+38
| | | | | | | Add a `version=` field to explicitly control the SDK version selection without relying on `CMAKE_SYSTEM_VERSION`. Fixes: #16713
* VS: Parse comma-separated fields from CMAKE_GENERATOR_PLATFORMBrad King2023-04-051-2/+14
|
* Help: Clarify that {add,target}_compile_options are not used for linkingBrad King2023-03-312-3/+3
| | | | | | Link to alternatives that can be used for adding link options. Issue: #24662
* Help: Clarify that CMAKE_<LANG>_FLAGS are used when driving linkingBrad King2023-03-312-12/+23
| | | | | | | | State explicitly that these flags are used when driving either compiling or linking. For linking, document their order w.r.t. link flags specified by commands. Fixes: #24662
* Warn if CMAKE_CROSSCOMPILING is true without CMAKE_SYSTEM_NAME setMartin Storsjö2023-03-241-5/+5
| | | | | Also clarify the `CMAKE_CROSSCOMPILING` documentation to state that CMake sets the variable automatically.
* Merge topic 'autogen-exe-vars'Brad King2023-03-233-0/+30
|\ | | | | | | | | | | | | b3d1797508 Autogen: Add CMAKE_AUTO*_EXECUTABLE variables Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8352
| * Autogen: Add CMAKE_AUTO*_EXECUTABLE variablesOrkun Tokdemir2023-03-223-0/+30
| | | | | | | | | | | | | | | | Add the `CMAKE_AUTOMOC_EXECUTABLE`, `CMAKE_AUTOUIC_EXECUTABLE`, and `CMAKE_AUTORCC_EXECUTABLE` variables to initialize the corresponding `AUTO{MOC,UIC,RCC}_EXECUTABLE` target properties. Fixes: #20071
* | Merge topic 'vs-windows-min-version'Brad King2023-03-161-0/+12
|\ \ | |/ |/| | | | | | | | | 6546305b01 VS: Add CMAKE_VS_WINDOWS_TARGET_PLATFORM_MIN_VERSION variable Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8319
| * VS: Add CMAKE_VS_WINDOWS_TARGET_PLATFORM_MIN_VERSION variablehalx992023-03-151-0/+12
| | | | | | | | | | | | Provide a way to initialize the `VS_WINDOWS_TARGET_PLATFORM_MIN_VERSION` target property on targets. It sets `WindowsTargetPlatformMinVersion` in `.vcxproj` files.
* | Add CMAKE_MAXIMUM_RECURSION_DEPTH environment variableBrad King2023-03-131-0/+2
|/ | | | | | | Extend the recursion limit controls added by commit a6982cff0d (cmMakefile: Impose maximum recursion limit, 2018-12-14, v3.14.0-rc1~82^2) with an environment variable that is used if the CMake variable of the same name is not set.
* Help: Clarify usage of CMAKE_NINJA_OUTPUT_PATH_PREFIXBrad King2023-03-031-13/+24
| | | | Issue: #24566
* Merge topic 'Apple-handle-Text-Stubs'Brad King2023-03-023-0/+26
|\ | | | | | | | | | | | | | | | | ede33f30cf Apple: Handle generation and comsuption of text-based stubs (.tbd files) fcbd723a50 Enhance support functions Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Brad King <brad.king@kitware.com> Merge-request: !8204
| * Apple: Handle generation and comsuption of text-based stubs (.tbd files)Marc Chevrier2023-03-013-0/+26
| | | | | | | | Fixes: #24123
* | Merge topic 'dll-name-soversion'Brad King2023-02-281-0/+14
|\ \ | |/ |/| | | | | | | | | | | | | | | a7f9c7da26 Add option to add SOVERSION to DLL names 9694504adc Tests: Simplify RunCMake.TargetArtifacts spec 3cd34eb279 Tests: Rename RunCMake.{ArtifactOutputDirs => TargetArtifacts} Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !8021
| * Add option to add SOVERSION to DLL namesRalf Habacker2023-02-271-0/+14
| | | | | | | | | | | | | | Add variable/target property `[CMAKE_]DLL_NAME_WITH_SOVERSION`. Fixes: #24251 Signed-off-by: Ralf Habacker <ralf.habacker@freenet.de>
* | Merge topic 'doc-CMAKE_MODULE_PATH'Brad King2023-02-271-4/+5
|\ \ | |/ |/| | | | | | | | | cf7f6b7165 Help: Document that CMAKE_MODULE_PATH must use forward slashes Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8252
| * Help: Document that CMAKE_MODULE_PATH must use forward slashesBrad King2023-02-241-4/+5
| | | | | | | | Issue: #24240, #24540
* | find_package: Use <PACKAGENAME>_ROOT variables as search prefixesBrad King2023-02-231-0/+8
| | | | | | | | | | | | | | | | | | Extend commit eb35d8884b (find_package: Use PackageName_ROOT variables as search prefixes, 2018-03-15, v3.12.0-rc1~349^2) to also check upper-case `<PACKAGENAME>_ROOT` variables. Add policy `CMP0144` to enable the behavior in a compatible way. Fixes: #24403
* | Add variable CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLYAbdelmaged Khalifa2023-02-171-0/+11
| | | | | | | | | | | | | | Add CMake variable `CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY` to enable option `DEPENDS_EXPLICIT_ONLY` on all uses of `add_custom_command`. Fixes: #17097
* | Deprecate "extra" generators in favor of cmake-file-api(7)Brad King2023-02-152-1/+8
| | | | | | | | | | | | | | | | | | | | | | The "extra" generators were created in CMake's early years to provide support for users of specific IDEs by directly generating their project files alongside make or ninja files. Nowadays the file-api provides a more generic, maintainable, well-tested, and robust way for IDEs to view CMake project build trees. Deprecate the legacy "extra" generators to encourage the corresponding IDEs to use the file-api. Fixes: #19090
* | Merge topic 'doc-find_package-root-case'Brad King2023-02-091-4/+4
|\ \ | |/ | | | | | | | | | | 20e727a408 Help: Clarify that <PackageName>_ROOT variable names are case-preserved Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8182
| * Help: Clarify that <PackageName>_ROOT variable names are case-preservedBrad King2023-02-081-4/+4
| | | | | | | | | | The name comes from the case-preserved first argument to `find_package`.
* | Kate: add support for hg and fossilAlexander Neundorf2023-02-061-5/+5
| | | | | | | | Both VCS are supported by kate nowadays.
* | Kate: make it possible to force a mode for the "files" entryAlexander Neundorf2023-02-061-0/+20
| | | | | | | | | | | | | | By default, kate will try to autodetect whether the project is a svn or git checkout or not. In case this does not give a satisfying result, the user can now set CMAKE_KATE_FILES_MODE to the mode he wants.
* | Help: add documentation for Kate-related variableAlexander Neundorf2023-02-031-0/+11
|/
* Help: Document experimental feature gate affecting CXX_SCAN_FOR_MODULESBrad King2023-02-011-0/+5
| | | | | | Also drop the release note for `CXX_SCAN_FOR_MODULES`, as the rest of the C++ modules support has not yet been mentioned in release notes (since it is still experimental).
* Help: Clarify CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS behaviorRobert Maynard2023-01-301-1/+3
| | | | Fixes: #24373
* Merge topic 'doc-rpath-features'Brad King2023-01-255-2/+25
|\ | | | | | | | | | | | | | | | | | | | | | | 434be1256e Help: improve docs for INSTALL_NAME_DIR f784c21567 Help: mention CMAKE_SKIP_RPATH in the RPATH docs 66ad61ba79 Help: improve documentation for BUILD_RPATH 25e7791dc1 Help: improve docs for INSTALL_RPATH 099292f123 Help: improve docs for rpath-related variables Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8073
| * Help: improve docs for rpath-related variablesAlexander Neundorf2023-01-195-2/+25
| | | | | | | | | | | | Now all RPATH-related variables link to the related RPATH-related variables. Some also link to the INSTALL_RPATH and BUILD_RPATH target properties.
* | Help: Document format of CMAKE_CONFIGURATION_TYPES listBrad King2023-01-171-1/+2
| | | | | | | | Issue: #24327
* | Merge topic 'IntelLLVM-no-icpx-on-Windows'Brad King2023-01-131-2/+3
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | 870d89627f Help: Clarify compiler id distinction between Intel Classic and IntelLLVM ea4cfb3b53 Merge branch 'backport-IntelLLVM-no-icpx-on-Windows' 8834e4d6a5 IntelLLVM: Avoid finding not-yet-supported icpx on Windows Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8041
| * | Help: Clarify compiler id distinction between Intel Classic and IntelLLVMMichael Hirsch2023-01-121-2/+3
| | |
| * | Merge topic 'sphinx-linkcheck' into release-3.25Brad King2022-11-081-3/+3
| |\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 435b0c573c Help: Fix some redirects reported with sphinx linkcheck ac5295a9de Help: Fix broken external links found by sphinx linkcheck Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7876
* | | | Set CMAKE_<LANG>_COMPILER_FRONTEND_VARIANT on single-variant compilersRussell Greene2023-01-111-0/+4
| |_|/ |/| | | | | | | | | | | | | | | | | The `GNU` and `MSVC` compilers obviously use their own front-end command-line style. Also set this for `AppleClang`. Fixes: #24232
* | | Help: Fix command references in CTEST_CUSTOM_ variablesAmir Masoud Abdol2022-12-154-4/+4
| | | | | | | | | | | | Fixes: #19087
* | | VS: Add a variable to report the Visual Studio version build numberBrad King2022-12-072-0/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | VS 2017 and above come with a Visual Studio Installer tool that tracks four-component Visual Studio version numbers. We already detect the VS version number because it is needed to make some generation decisions. Provide the number to projects in a `CMAKE_VS_VERSION_BUILD_NUMBER` variable so they can use it similarly. Fixes: #24230
* | | Help: Factor out VS Build Number components document fragmentBrad King2022-12-072-17/+19
| | |
* | | clang-tidy: add <LANG>_CLANG_TIDY_EXPORT_FIXES_DIR propertyKyle Edwards2022-12-061-0/+15
| | | | | | | | | | | | Fixes: #21362
* | | Merge topic 'help-remove-self-reference-links'Brad King2022-11-2122-29/+29
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | eb77695e25 Help: clean up some minor typos c36910476a Help: remove links from pages to themselves 391c53a851 Help/prop_tgt/LINK_OPTIONS: fix `:genex:` reference de4909ea16 Help: fix some minor markup errors c42c77b020 Help/CMAKE_GLOBAL_AUTORCC_TARGET_NAME: fix link reference Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7940
| * | | Help: remove links from pages to themselvesBen Boeckel2022-11-1821-28/+28
| | | | | | | | | | | | | | | | | | | | At least the top-reference links. Internal `:ref:` usages have been left intact.
| * | | Help: fix some minor markup errorsBen Boeckel2022-11-182-2/+2
| | | |
| * | | Help/CMAKE_GLOBAL_AUTORCC_TARGET_NAME: fix link referenceBen Boeckel2022-11-181-1/+1
| | | |
* | | | cxxmodules: add properties to control scanningBen Boeckel2022-11-181-0/+10
|/ / / | | | | | | | | | | | | | | | The `CXX_SCAN_FOR_MODULES` property may be used to control scanning for targets and for source files rather than assuming "C++20 always needs to be scanned".
* | | Merge topic 'doc-improvements'Brad King2022-11-102-3/+3
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | d4d1f85297 Help: Move a note about arguments and genexes into include file 968224484f Help: Drop unused `PROPERTY_GENEX` replace from `prop_tgt/INTERFACE_*` files 65457e4fae Help: Add _See Also_ sections to related CMake commands c86ec79d07 Help: Use direct refs to genexes instead of ``$<GENEX-NAME>`` 8c6274326d Help: Use CMake highlighting for command synopsis c356a94512 Help: Use monospaced font for a genex name in a section title f98c8707f4 Help: Use `code-block:: cmake` instead of `::` for sub-commands descriptions 2ba351ca4f Help: ``CMake`` → CMake ... Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7873
| * | | Help: Use direct refs to genexes instead of ``$<GENEX-NAME>``Alex Turbov2022-11-091-2/+2
| | | |
| * | | Help: ``CMake`` → CMakeAlex Turbov2022-11-071-1/+1
| | | |
* | | | Merge topic 'sphinx-linkcheck'Brad King2022-11-081-3/+3
|\ \ \ \ | |_|/ / |/| | / | | |/ | |/| | | | | | | | | | | | | | | | | | | | | | a89c76a773 Build: Add `SPHINX_LINKCHECK` build option 137b00cda1 Build: Do not redirect `sphinx-build` output if CMake running in verbose mode d954fb8a60 Build: Deduplicate `add_custom_command()` calls for Sphinx targets 2af8724485 Merge branch 'backport-sphinx-linkcheck' into sphinx-linkcheck 435b0c573c Help: Fix some redirects reported with sphinx linkcheck ac5295a9de Help: Fix broken external links found by sphinx linkcheck Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7876