summaryrefslogtreecommitdiffstats
path: root/Help/variable
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'fetchcontent-CMAKE-vars-passthrough'Craig Scott2021-10-064-10/+23
|\ | | | | | | | | | | | | | | | | 1851aa49be FetchContent: Pass through networking-related CMAKE_... variables 96937438b7 Help: Clean up how TLS and NETRC variables are discussed 2a82bd85b6 Help: Add documentation for CMAKE_TLS_CAINFO Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6589
| * FetchContent: Pass through networking-related CMAKE_... variablesCraig Scott2021-10-054-12/+16
| | | | | | | | | | | | | | CMAKE_TLS_VERIFY, CMAKE_TLS_CAINFO, CMAKE_NETRC and CMAKE_NETRC_FILE are now passed through to the underlying ExternalProject sub-build. Previously, they were silently ignored. Fixes: #22144
| * Help: Add documentation for CMAKE_TLS_CAINFOCraig Scott2021-10-041-0/+9
| |
* | Merge topic 'default_extensions'Brad King2021-10-0424-75/+133
|\ \ | |/ |/| | | | | | | | | | | | | | | | | | | | | | | 4a0485be7f cmStandardLevelResolver: Avoid unnecessary flags, fix unset level logic 29e2b85171 Tests: Simplify RunCMake.CompileFeatures introspection fc3a1cbdd8 CompilerID: Compiler extensions default detection 2adfd95d79 CompilerID: Rename language_dialect to language_standard 00055d7779 Help: Document CMAKE_<LANG>_STANDARD_DEFAULT a65bee4cfc Help: Document HIP standard/extensions properties and variables a40ff1bb5a Help: Make language standard/extensions variable pages less wordy 3feff8379b Help: Generic language standard and extension variables documentation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6177
| * cmStandardLevelResolver: Avoid unnecessary flags, fix unset level logicRaul Tambre2021-09-291-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The changes are part of CMP0128. When the standard level is unset: * Flags are added if extension mode doesn't match the compiler's default. Previously logic only worked if LANG_EXTENSIONS was ON. Fixes #22224. * The full flag is used. Previously CMAKE_LANG_EXTENSION_COMPILE_OPTION was used. This was only supported for IAR. Otherwise: * Avoid adding flags if not necessary per the detected compiler defaults. * Fixed check for when the requested standard is older. It now matches the nearby comments. I reworded the fallback comment as its logic was a bit difficult to wrap my head around.
| * CompilerID: Compiler extensions default detectionRaul Tambre2021-09-281-0/+7
| |
| * Help: Document CMAKE_<LANG>_STANDARD_DEFAULTRaul Tambre2021-09-281-0/+7
| | | | | | | | Seems to be stable and will referred to by policy for standards flags rework.
| * Help: Document HIP standard/extensions properties and variablesRaul Tambre2021-09-283-0/+30
| |
| * Help: Make language standard/extensions variable pages less wordyRaul Tambre2021-09-2815-75/+30
| | | | | | | | | | | | They all had two sentences describing the same thing. Furthermore, with the shorter wording the explicit advice to see the property being initialized for further information seems unnecessary.
| * Help: Generic language standard and extension variables documentationRaul Tambre2021-09-283-0/+57
| | | | | | | | | | | | Add generic documentation to improve the discoverability of language-specific ones and to make it possible to refer to them generically from other language generic documentation.
* | Help: Fix CMAKE_FIND_LIBRARY_SUFFIXES examples for WindowsRalf Habacker2021-09-291-2/+5
|/ | | | Fixes: #22697
* Merge topic 'doc-build-config'Craig Scott2021-09-222-33/+22
|\ | | | | | | | | | | | | | | b8d10c27d1 Help: Restructure build type docs and clarify case sensitivity Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !6516
| * Help: Restructure build type docs and clarify case sensitivityCraig Scott2021-09-212-33/+22
| | | | | | Fixes: #22591
* | Merge topic 'hip-no-hipcc'Brad King2021-09-202-2/+2
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | cb93f72624 HIP: Simplify detection of HIP runtime CMake package a71f0fc9c7 HIP: Remove ROMClang compiler id and use Clang directly b125e9809a HIP: Detect ROCm path earlier 735f41fc2d HIP: Use 'rocm_agent_enumerator' to determine CMAKE_HIP_ARCHITECTURES Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: Raul Tambre <raul@tambre.ee> Acked-by: Axel Huebl <axel.huebl@plasma.ninja> Merge-request: !6533
| * | HIP: Remove ROMClang compiler id and use Clang directlyBrad King2021-09-161-1/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since commit bd844387df (ROCMClang: Add the ROCm toolkit derived clang compiler to CMake, 2020-08-28, v3.21.0-rc1~66^2~6) and commit ff0d2858e1 (HIP: Extract clang compiler details from hipcc, 2020-10-21, v3.21.0-rc1~66^2~5), the separate `ROCMClang` compiler id for `hipcc` has caused a few problems: * The compiler id changed from behavior of CMake 3.20 and below, breaking projects that already built with `hipcc` treated as `Clang`. * The implementation of `target_compile_features` was incomplete for the `ROCMClang` identity. * Only `hipcc` was identified as `ROCMClang`, so after it is unwrapped to the underlying `clang++`, future runs of new CMake versions on an existing build tree would not repeat this. * Clang should be usable as a HIP compiler without the `hipcc` wrapper. Remove the `ROMClang` compiler identity, and revise HIP language support to work directly with a Clang compiler. Reject direct `hipcc` usage as a HIP compiler. For now it cannot be supported because it interferes with flags CMake needs to pass to Clang. Fixes: #22536, #22460, #22593
| * | HIP: Use 'rocm_agent_enumerator' to determine CMAKE_HIP_ARCHITECTURESZack Galbreath2021-09-161-1/+2
| | |
* | | Help: Improve explanation on CMAKE_POLICY_WARNING warnings occurRobert Maynard2021-09-151-2/+3
| |/ |/|
* | Help: Document that toolchain files may set implicit link informationBrad King2021-09-022-5/+33
| | | | | | | | | | | | Document in `CMAKE_<LANG>_IMPLICIT_LINK_{LIBRARIES,DIRECTORIES}` how their value is used and that a fallback value may be provided by a toolchain file.
* | Merge topic 'doc-ctest-output'Craig Scott2021-07-262-0/+6
|\ \ | |/ | | | | | | | | | | | | ba6d1947b6 Help: Add cross-references between test output size ctest variables cdde9e5a10 Help: Improve wording and cross-referencing for ctest JUnit output Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6389
| * Help: Add cross-references between test output size ctest variablesCraig Scott2021-07-262-0/+6
| |
* | Merge topic 'iar-exe-suffix'Brad King2021-07-202-1/+9
|\ \ | |/ | | | | | | | | | | | | 09bc0785ee Help: Document CMAKE_EXECUTABLE_SUFFIX_<LANG> explicitly 05a3bafe65 Compiler/IAR: Avoid clobbering CMAKE_EXECUTABLE_SUFFIX Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6357
| * Help: Document CMAKE_EXECUTABLE_SUFFIX_<LANG> explicitlyLorenzo Cappelletti2021-07-202-1/+9
| | | | | | | | | | Documentation for `CMAKE_EXECUTABLE_SUFFIX_<LANG>`, useful when cross-compiling, is buried in section `CMAKE_EXECUTABLE_SUFFIX`.
| * Merge topic 'doc-cleanups-3.21' into release-3.21Craig Scott2021-07-201-1/+2
| |\ | | | | | | | | | | | | | | | | | | | | | | | | | | | 8d1944c675 Help: Expand details for file(COPY_FILE) c8ea886123 Help: Re-order file() sub-commands in Filesystem section b5a96716eb Help: Clarify which project() call PROJECT_IS_TOP_LEVEL is for 8be7694d97 Help: Fix trivial typo Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6361
* | \ Merge topic 'doc-cleanups-3.21'Craig Scott2021-07-201-1/+2
|\ \ \ | | |/ | |/| | | | | | | | | | | | | | | | | | | | | | 8d1944c675 Help: Expand details for file(COPY_FILE) c8ea886123 Help: Re-order file() sub-commands in Filesystem section b5a96716eb Help: Clarify which project() call PROJECT_IS_TOP_LEVEL is for 8be7694d97 Help: Fix trivial typo Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6361
| * | Help: Clarify which project() call PROJECT_IS_TOP_LEVEL is forCraig Scott2021-07-181-1/+2
| | |
* | | Merge topic 'vs2022'Brad King2021-07-191-2/+0
|\ \ \ | | |/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 0c7f918fb1 VS: Update Visual Studio 17 2022 generator for Preview 2 1ac1436b25 VS: Fix `/sourceDependencies` flag table entries for v143 919fc7fd5f VS: Remove broken EnableASAN entry from flag table for v143 3f19847b28 VS: Remove empty ExternalWarningLevel entry from flag table for v143 ccb6083cbe VS: Remove empty LanguageStandard entries from flag table for v143 c167de7e70 VS: Remove empty ConformanceMode entry from flag table for v143 993d706a17 VS: Populate `/JMC-` flag table entry for v143 a070d87e08 VS: Populate `-Qspectre-` flag table entry for v143 ... Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Egor Pugin <egor.pugin@gmail.com> Merge-request: !6350
| * | VS: Update Visual Studio 17 2022 generator for Preview 2Brad King2021-07-151-2/+0
| |/ | | | | | | | | | | In particular, update to toolset `v143`. Fixes: #22339
* | Merge topic 'LWYU-externalization'Brad King2021-07-123-1/+20
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | 14e57e9637 LINK_WHAT_YOU_USE feature: externalize configuration 9c5132a586 PGI: Fix "LINKER:" prefix generated separator 8a93de080c cmGeneratorTarget: Add method for LINKER: prefix translation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6306
| * | LINK_WHAT_YOU_USE feature: externalize configurationMarc Chevrier2021-07-093-1/+20
| | | | | | | | | | | | | | | | | | | | | | | | Currently, this feature is only supported on ELF platforms. So, the property LINK_WHAT_YOU_USE will be ignored for other plateforms. Moreover, flags and commands are now controled by CMake variables. Fixes: #20174
* | | Merge topic 'help_toplevel'Brad 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.
* | | find_package: Add variable to make package REQUIREDEugene Shalygin2021-07-082-0/+16
| |/ |/| | | | | | | | | | | | | | | | | | | | | | | | | Add a `CMAKE_REQUIRE_FIND_PACKAGE_<PackageName>` variable is complement to `CMAKE_DISABLE_FIND_PACKAGE_<PackageName>` with just the opposite behaviour: it turns non-required find_package call into the required one. While optional package dependencies usually result in simple and clean build logic, sometimes people want to be sure those optional dependencies will be found and used. Examples are reproducible builds and build instructions for 3rd parties. People choose to make find_package calls REQUIRED and put them behind an option(). Such workarounds blend build logic with build environment management and do not look elegant.
* | cmake: Allow CMAKE_CONFIGURATION_TYPES to be set by environment variableBrad King2021-06-301-1/+3
| | | | | | | | | | | | | | | | When no `CMAKE_CONFIGURATION_TYPES` is explicitly specified while creating a new build tree, check for an environment variable of the same name. Issue: #20983
* | cmake: Allow CMAKE_BUILD_TYPE to be set by environment variableBrad King2021-06-301-2/+3
| | | | | | | | | | | | | | When no `CMAKE_BUILD_TYPE` is explicitly specified while creating a new build tree, check for an environment variable of the same name. Issue: #20983
* | Help: Document when CMAKE_BUILD_TYPE and CMAKE_CONFIGURATION_TYPES are setBrad King2021-06-302-0/+9
| | | | | | | | Fixes: #19247
* | Help: Cross-reference CMAKE_CONFIGURATION_TYPES from CMAKE_BUILD_TYPEBrad King2021-06-301-0/+3
|/ | | | The other direction is already linked.
* CMP0126: Add control for warningsMarc Chevrier2021-06-291-0/+2
| | | | Fixes: #22353
* VS: Add Visual Studio 17 2022 generatorBrad King2021-06-251-0/+3
| | | | Fixes: #22339
* 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: Document special "CTEST_FULL_OUTPUT" test output stringBrad King2021-06-092-0/+6
|
* Merge topic 'add_hip_language'Brad King2021-06-093-1/+13
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 8514ee9b31 HIP: analyze output of `hipcc` to determine default GPU architecture 20d086f1a2 HIP: All HIP tests now run on CMake's current AMD hardware 2e86e50c2f HIP: Add HIP to all the Check* modules 947dbed0aa HIP: Automatically inject the `hip::device` runtime target b50bfc8913 HIP: Add language to CMake ff0d2858e1 HIP: Extract clang compiler details from hipcc bd844387df ROCMClang: Add the ROCm toolkit derived clang compiler to CMake 590553f322 Compilers: protect use of __has_include ... Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Zack Galbreath <zack.galbreath@kitware.com> Reviewed-by: Raul Tambre <raul@tambre.ee> Acked-by: Axel Huebl <axel.huebl@plasma.ninja> Merge-request: !6121
| * HIP: analyze output of `hipcc` to determine default GPU architectureZack Galbreath2021-06-071-1/+1
| |
| * HIP: Add language to CMakeRobert Maynard2021-06-072-1/+12
| |
| * ROCMClang: Add the ROCm toolkit derived clang compiler to CMakeRobert Maynard2021-06-071-0/+1
| |
* | Merge topic 'compile-options-order'Brad King2021-06-082-2/+10
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | 8f68bcad8f Tests: Add cases verifying flag ordering rules ccc83ce162 Help: Document order of flags from CMAKE_<LANG>_FLAGS and COMPILE_OPTIONS df79fe055b Help: Remove incorrect "versionadded" for CMAKE_<LANG>_FLAGS_<CONFIG> c48d2d8480 VS: Place per-source preprocessor definitions after target-wide ones Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6187
| * | Help: Document order of flags from CMAKE_<LANG>_FLAGS and COMPILE_OPTIONSBrad King2021-06-032-0/+10
| | |
| * | Help: Remove incorrect "versionadded" for CMAKE_<LANG>_FLAGS_<CONFIG>Brad King2021-06-031-2/+0
| | | | | | | | | | | | | | | These variables have been around for a long time, but the current form of the document was added later.
* | | Help: Remove recommendations for using CMAKE_CFG_INTDIRCraig Scott2021-06-061-2/+4
| |/ |/| | | | | | | | | Commit e71c4f7729 (CMAKE_CFG_INTDIR: Formally deprecate in favor of $<CONFIG>, 2021-05-27) only updated the docs for CMAKE_CFG_INTDIR itself, but other parts of the docs still used it. Update the other places to avoid referring to the now-deprecated variable.
* | cmake: Allow CMAKE_TOOLCHAIN_FILE to be set by environment variableBrad King2021-06-031-0/+3
|/ | | | | When no `CMAKE_TOOLCHAIN_FILE` is explicitly specified while creating a new build tree, check for an environment variable of the same name.
* Launchers: Support setting linker launchersBobby D Reynolds2021-05-281-0/+11
| | | | Fixes: #18316