summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'add_subdirectory_system'Brad King2022-09-271-0/+1
|\ | | | | | | | | | | | | 2eb30a7036 add_subdirectory: Add SYSTEM option Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7399
| * add_subdirectory: Add SYSTEM optionDa Quexian2022-09-261-0/+1
| | | | | | | | | | Fixes: #22401 Signed-off-by: Da Quexian <daquexian566@gmail.com>
* | Help: Add package preset to example presets fileKyle Edwards2022-09-221-1/+10
| |
* | Help: List packagePresets field in cmake-presets.7Kyle Edwards2022-09-221-0/+4
| |
* | Merge topic 'transitive-usage-reqs-lnks'Brad King2022-09-191-3/+5
|\ \ | | | | | | | | | | | | | | | | | | 3d31f99b74 Help: Link from usage requirement commands to detailed explanation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7653
| * | Help: Link from usage requirement commands to detailed explanationHinell2022-09-161-3/+5
| | | | | | | | | | | | | | | | | | | | | Augment vague mentions of "Transitive Usage Requirements" with links to a detailed explanation. Fixes: #23799
* | | Merge topic 'env-tls-certs'Brad King2022-09-191-0/+2
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 10bf34a2d9 cmCurl: Honor OpenSSL certificate environment variables Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7670
| * | | cmCurl: Honor OpenSSL certificate environment variablesMaxim Cournoyer2022-09-161-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Honor the OpenSSL environment variables used to specify the location of the TLS certificates, as specified in the `curl(1)` man page. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* | | | Merge topic 'xcode-lib-dirs'Brad King2022-09-161-0/+1
|\ \ \ \ | |_|/ / |/| | | | | | | | | | | | | | | | | | | d4cc39842e Xcode: Do not append per-config suffixes to library search paths Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7672
| * | | Xcode: Do not append per-config suffixes to library search pathsMikko Sivulainen2022-09-151-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Add policy `CMP0142` to remove the automatic addition of the `$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)` suffix in a compatible way. Fixes: #21757
* | | | Merge topic 'add_tasking_compiler'Brad King2022-09-151-0/+1
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | 94df5b6ef1 Tasking: Add support for several compiler toolsets Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7491
| * | | Tasking: Add support for several compiler toolsetsChristoph Seitz2022-09-141-0/+1
| |/ / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add support for the Tasking compiler toolset: * TriCore Compiler Toolset 6.3 (with TriCore, ARM, MCS, 8051 and PCP architecture compilers) * SmartCode Compiler Toolset 10.1 (with TriCore, ARC, MCS, 8051 architecture compilers) * ARM Compiler 6.0 * MCS Complier 3.3 * 8051 Compiler 7.2 Fixes: #23756
* | | Merge topic 'MsvcDebugInformationFormatAbstraction'Brad King2022-09-143-0/+3
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | | | | a858466aac MSVC: Add test for debug information format 0e96a20478 MSVC: Add abstraction for debug information format d4c8111da4 Clang/Windows: Clarify name of internal runtime library flags variables Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7606
| * | MSVC: Add abstraction for debug information formatGlen Chung2022-09-143-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Replace our hard-coded default for `/Zi` with a first-class abstraction to select the debug information format an enumeration of logical names. We've long hesitated to do this because the idea of "debug information format" touches on related concepts on several platforms. Avoid that scope creep by simply defining an abstraction that applies only when targeting the MSVC ABI on Windows. Removing the old default flag requires a policy because existing projects may rely on string processing to edit them and choose a runtime library under the old behavior. Add policy CMP0141 to provide compatibility. Fixes: #10189
* | | Merge topic 'LINUX-host'Brad King2022-09-131-0/+1
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | caffb15d09 LINUX: Set CMAKE_HOST_LINUX variable when running on a Linux host Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: hinell <al.neodim@gmail.com> Merge-request: !7661
| * | | LINUX: Set CMAKE_HOST_LINUX variable when running on a Linux hostCristian Adam2022-09-091-0/+1
| | | | | | | | | | | | | | | | Relates: #23840
* | | | Merge topic 'manual-toolchain'Brad King2022-09-122-33/+46
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | 004568a9f3 Help: Add links between cmake-{toolchains,presets}(7) Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7650
| * | | Help: Add links between cmake-{toolchains,presets}(7)Hinell2022-09-092-33/+46
| |/ / | | | | | | | | | Also improve formatting and add `versionadded` markup.
* | | Merge topic 'BSD'Brad King2022-09-091-4/+1
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | 1ea8b8ed86 BSD: Set CMAKE_HOST_BSD variable on a BSD host 288f72efea BSD: Only use BSD as variable for target BSD system Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7648
| * | BSD: Set CMAKE_HOST_BSD variable on a BSD hostCristian Adam2022-09-051-0/+1
| | | | | | | | | | | | | | | | | | Also the BSD variable will be set in CMake scripting mode (-P). Relates: #23853
| * | BSD: Only use BSD as variable for target BSD systemCristian Adam2022-09-051-4/+0
| | | | | | | | | | | | | | | | | | | | | Instead of having multiple boolean variables, we only have one string variable: BSD with the name of the target BSD system. Relates: #23853
* | | Merge topic 'return-propagate-variables'Brad King2022-09-071-0/+8
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 838a5fae23 return(): Propagate variables to result scope 8f0e1f2111 cmMakefile: add RaiseScope for list of variables Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Acked-by: Robert Maynard <robertjmaynard@gmail.com> Merge-request: !7634
| * | | return(): Propagate variables to result scopeMarc Chevrier2022-09-031-0/+8
| |/ / | | | | | | | | | Fixes: #23871
* | | Merge topic 'help-windows-registry'Craig Scott2022-09-061-64/+79
|\ \ \ | |/ / |/| | | | | | | | | | | | | | 5b30ca2436 Help: cmake-developer: Add section for Windows registry access. Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7642
| * | Help: cmake-developer: Add section for Windows registry access.Marc Chevrier2022-09-041-64/+79
| | | | | | | | | | | | Fixes: #23905
* | | Merge topic 'cmake-presets-package'Brad King2022-09-024-10/+344
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | a8d73085f4 CPack: Add support for presets b699610df4 cmCMakePresetsGraph: Add package presets 215b9148eb CMakePresets.json: Fix formatting of --list-presets=all Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7621
| * | | CPack: Add support for presetsKyle Edwards2022-08-314-10/+344
| | | | | | | | | | | | | | | | Fixes: #23117
* | | | Merge topic 'E-capabilities-tls'Brad King2022-09-021-0/+5
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | d0bb3286f0 cmake -E capabilities: Tell whether TLS is enabled Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7593
| * | | | cmake -E capabilities: Tell whether TLS is enabledKyle Edwards2022-09-011-0/+5
| | | | | | | | | | | | | | | | | | | | Fixes: #20507
* | | | | Merge topic 'xcode-add-gpu-validation-and-default-configuration'Brad King2022-08-312-0/+6
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 740bee97bd Xcode: Add settings to control a scheme's launch configuration 39456c70e1 Xcode: Add settings to control a scheme's GPU Validation values 4034272ed8 gitignore: Tell Git to ignore the .cache/ directory Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7581
| * | | | | Xcode: Add settings to control a scheme's launch configurationPatriceJiang2022-08-302-0/+2
| | | | | |
| * | | | | Xcode: Add settings to control a scheme's GPU Validation valuesPatriceJiang2022-08-302-0/+4
| | | | | |
* | | | | | Merge topic 'FindOpenSP-module'Brad King2022-08-311-0/+1
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | e706da5f7e FindOpenSP: Add module to find the OpenSP library 4bcdf1b992 ci: add OpenSP to Debian and Fedora base images Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7470
| * | | | | | FindOpenSP: Add module to find the OpenSP libraryDawid Wróbel2022-08-301-0/+1
| | |_|/ / / | |/| | | | | | | | | | | | | | | | | | | | | | OpenSP has not seen a release in seventeen years, so is unlikely to ever provide a CMake package configuration file. Add a find module instead.
* | | | | | Merge topic 'doc-CMP0134-fixes'Brad King2022-08-311-1/+1
|\ \ \ \ \ \ | |/ / / / / |/| | | / / | | |_|/ / | |/| | | | | | | | | | | | | 7dca3807f8 Help: Fix typos, grammar and formatting in CMP0134 policy docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7620
| * | | | Help: Fix typos, grammar and formatting in CMP0134 policy docsCraig Scott2022-08-301-1/+1
| | | | |
* | | | | Help: Clarify that the order of -C and -D arguments mattersKyle Edwards2022-08-261-0/+19
| | | | |
* | | | | Help: $<CONFIG:...> supports multiple configs only since CMake 3.19Michael Hirsch2022-08-241-0/+4
| | | | |
* | | | | Merge topic 'block-management'Brad King2022-08-231-0/+2
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 44a2f3f332 Add new flow-control commands for variables and policies scopes management 604993248f cmMakefile::VariablePushPop: helper class to manage variable scopes 3d94ee0e03 cmMakefile::RaiseScope: Add support for cmValue argument 553da0685f cmFunctionBlocker: Add handling of close block without parameters. 02c067dee5 cm::enum_set: fix various bugs Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: John Ericson <git@johnericson.me> Merge-request: !7575
| * | | | | Add new flow-control commands for variables and policies scopes managementMarc Chevrier2022-08-221-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add block() and endblock() commands offering the capability to create new scopes for variables and/or policies. Fixes: #20171
* | | | | | Merge topic 'bsd-variables'Craig Scott2022-08-221-0/+5
|\ \ \ \ \ \ | |/ / / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | a20d7a9707 BSD: Set *BSD variables when targeting a *BSD system 2ae42d0aa3 kFreeBSD: Do not unset LINUX variable Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7573
| * | | | | BSD: Set *BSD variables when targeting a *BSD systemCristian Adam2022-08-201-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | Fixes: #23853
* | | | | | Merge topic 'feature/cmake-man-page-short-option-first'Brad King2022-08-191-1/+1
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 536a25fedc Help: Convenient declaration for `-j, --parallel` option Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7588
| * | | | | | Help: Convenient declaration for `-j, --parallel` optionAlex Turbov2022-08-181-1/+1
| | |_|/ / / | |/| | | |
* | | | | | Merge topic 'doc-var-refs'Brad King2022-08-191-6/+8
|\ \ \ \ \ \ | | |_|/ / / | |/| | / / | |_|_|/ / |/| | | | | | | | | | | | | | 159acea394 Help: Clarify that variable references may use cache entries Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7589
| * | | | 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
* | | | | cmake -E env: Add --modify flagAlex Reinking2022-08-171-2/+20
| |/ / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When `cmake -E env` is given the `--modify` flag, try to parse the following argument as an `ENVIRONMENT_MODIFICATION` operation and apply it to the environment. This generalizes `--unset=`: 1. When implementing `ENVIRONMENT_MODIFICATION` features for other CMake commands, the `MYVAR=OP:VALUE` strings do not need to be translated to OP-specific flags. 2. This provides a natural and consistent extension point to introduce new operations without introducing very many flags. 3. Users need to learn only one syntax to access the same functionality. There is one difference between the behavior here as compared to CTest's interpretation of the `ENVIRONMENT_MODIFICATION` test property. The `MYVAR=reset:` command when run in `cmake -E env` will reset `MYVAR` to whatever its value was when `cmake -E env` launched, rather than try to checkpoint after plain `MYVAR=VALUE` options. This makes `MYVAR=VALUE` and `--modify MYVAR=set:VALUE` semantically equivalent.
* | | | Merge topic 'doc-cmake-cli-options'Brad King2022-08-169-316/+186
|\ \ \ \ | |_|/ / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 0224576995 Help: Replace `cmake -P` option mentions w/ Sphinx role 1b94770f27 Help: Insert link to `cmake --toolchain` option 2c54cd871a Help: Turn items of presets manual page into description list e2198fd9dc Help: Format `-Werror`/`-Wno-error` in the way it can be referenced a6070b480f Help: Use placeholder instead of listing choices in option lines 8ba20cb56f Help: Simplify `cmake --log-level` option definition 146e4e6bad Help: Split `ctest` options into groups like `cmake` man page has 4c1008d739 Help: Use `:option:` role to reference `ctest` options ... Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7554
| * | | Help: Insert link to `cmake --toolchain` optionAlex Turbov2022-08-141-1/+2
| | | |
| * | | Help: Turn items of presets manual page into description listAlex Turbov2022-08-141-154/+0
| | | | | | | | | | | | | | | | It was an ordinal paragraphs (`<p>`) intermixed with blockquote elements.