summaryrefslogtreecommitdiff
path: root/Help/variable
Commit message (Collapse)AuthorAgeFilesLines
* 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
| * | Help: Fix some redirects reported with sphinx linkcheckAlex Turbov2022-11-071-3/+3
| |/ | | | | | | Mostly it's about replace `http:` with `https:` protocol.
* | Tasking: Update CMAKE_TASKING_TOOLSET documentationChristoph Seitz2022-11-071-4/+7
|/ | | | | | | Clarify the relationship between the compiler version and toolset/architecture. Fixes: #24117
* Help: Add more CLI `:option:` references to various pagesAlex Turbov2022-10-203-3/+3
|
* Merge topic 'doc-flag-init' into release-3.25Brad King2022-10-181-1/+9
|\ | | | | | | | | | | | | e0075799ed Help: Clarify how language-specific flag environment values are used Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7804
| * Help: Clarify how language-specific flag environment values are usedBrad King2022-10-181-1/+9
| | | | | | | | | | | | | | | | | | Previous the wording could be interpreted to mean that the environment variables like `CXXFLAGS` are used exclusively to initialize the corresponding cache entries like `CMAKE_CXX_FLAGS`. State clearly that the value will be used in combination with builtin defaults. Issue: #23956
* | Help: Clarify historical-only role of CMAKE_ANDROID_API variableBrad King2022-10-171-3/+4
|/ | | | | | | | | Revise documentation added by commit 6b84df8da9 (Help: Document cross compiling for Android, 2016-06-20, v3.7.0-rc1~229^2~2) to avoid implying that `CMAKE_ANDROID_API` is interchangeable with `CMAKE_SYSTEM_VERSION`. The latter is the authoritative value of the Android API level. Issue: #23830
* Help: Minor grammar, typo and formatting cleanupsCraig Scott2022-10-091-1/+1
|
* Help: Re-sort property, variable and compiler id listsCraig Scott2022-10-091-1/+1
|