summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'variable-CMAKE_FOLDER'Brad King2018-04-021-0/+1
|\ | | | | | | | | | | | | df535ad846 Add CMAKE_FOLDER variable to initialize FOLDER target property Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1896
| * Add CMAKE_FOLDER variable to initialize FOLDER target propertyMarc B2018-03-291-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This can be used for example to organize all following targets into one Visual Studio folder: set(CMAKE_FOLDER Libraries) add_subdirectory(libA) add_subdirectory(libB) set(CMAKE_FOLDER Executables) add_subdirectory(progA) Another possibility is using the current directory name for all following targets in subdirectories: get_filename_component(dirname "${CMAKE_CURRENT_SOURCE_DIR}" NAME) string(APPEND CMAKE_FOLDER "/${dirname}")
* | Merge topic 'features-c++20'Brad King2018-04-021-5/+5
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 8570dc7f64 Help: Update compiler versions in cmake-compile-features.7.rst 874d3d2948 Help: Add release note for C++ 20 support 7f295b1bd3 Features: Activate C++ 20 support for Clang 5.0+ 71cb8ce3a1 Features: Activate C++ 20 support for GNU 8.0+ 8f146c4508 Features: Activate C++ 20 support for MSVC 19.12.25835+ 7fe580a362 Features: Add infrastructure for C++ 20 language standard 1b328e09a3 Features: Use -std=c++17 for C++ 17 on Clang 5.0+ 0bc3e5788a Features: Use -std=c++17 for C++ 17 on GNU 8.0+ Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1892
| * | Help: Update compiler versions in cmake-compile-features.7.rstBrad King2018-03-271-5/+5
| |/
* | genex: Add TARGET_NAME_IF_EXISTS expressionAlex Turbov2018-03-281-0/+3
|/ | | | | Define `$<TARGET_NAME_IF_EXISTS:tgt>` to mean `tgt` if the target exists and otherwise an empty string.
* Merge topic 'FindPython-new-implementation'Brad King2018-03-212-0/+5
|\ | | | | | | | | | | | | | | | | | | 50b5e9ed13 CMake build: Use new FindPython module 352baee207 FindPython*: New implementation for Python stuff Acked-by: Kitware Robot <kwrobot@kitware.com> Reviewed-by: Ben Boeckel <ben.boeckel@kitware.com> Acked-by: Alex Turbov <i.zaufi@gmail.com> Merge-request: !1819
| * FindPython*: New implementation for Python stuffMarc Chevrier2018-03-202-0/+5
| | | | | | | | Fixes: #16142
* | Merge topic 'sunpro-5.15'Brad King2018-03-211-1/+1
|\ \ | | | | | | | | | | | | | | | | | | 4267960fc9 Features: Record for SunPro 5.15 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1875
| * | Features: Record for SunPro 5.15Brad King2018-03-201-1/+1
| | | | | | | | | | | | Oracle Developer Studio 12.6 adds support for more C++ 11 features.
* | | Merge topic 'find-package_root-restore'Brad King2018-03-191-0/+1
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | eb35d8884b find_package: Use PackageName_ROOT variables as search prefixes Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1858
| * | | find_package: Use PackageName_ROOT variables as search prefixesBrad King2018-03-161-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This feature was originally added by commit v3.9.0-rc1~71^2~2 (find_*: Add a new PackageRoot search path group, 2017-05-03) and documented by commit v3.9.0-rc1~71^2 (find_*: Add docs for PackageRoot search path group, 2017-05-03). However, we had to disable the feature and remove the documentation in commit v3.9.1~2^2 (find_*: Disable the PACKAGE_ROOT search path group for CMake 3.9, 2017-08-08) due to breaking projects that used `PackageName_ROOT` variables themselves. Add policy `CMP0074` to restore the `PackageName_ROOT` variable behavior in a compatible way. Also revise the stack of root paths to store the paths themselves rather than the package names. This way the policy can be considered at the `find_package` call site instead of individual `find_` calls inside a find module. Co-Author: Chuck Atkins <chuck.atkins@kitware.com> Issue: #17144
* | | | Merge topic 'export-properties'Brad King2018-03-191-0/+1
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6db61f0725 Export: allow exporting of additional properties Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1834
| * | | | Export: allow exporting of additional propertiesWouter Klouwen2018-03-161-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This change introduces an additional property that may be set on a target to allow additional properties to be exported. Normally only a limited number of properties are exported. Additional properties may be exported by simply setting the `EXPORT_PROPERTIES` property on a target that is exported.
* | | | | Merge topic 'vs-debugger-command'Brad King2018-03-191-0/+1
|\ \ \ \ \ | |_|_|_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | 5a7113d8fb VS: Add target property VS_DEBUGGER_COMMAND Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1842
| * | | | VS: Add target property VS_DEBUGGER_COMMANDHannes Mezger2018-03-141-0/+1
| | | | | | | | | | | | | | | | | | | | Fixes: #17819
* | | | | project: Add HOMEPAGE_URL named parameterAlex Turbov2018-03-161-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This sets variables like PROJECT_HOMEPAGE_URL, which can be used as default values for various things (packaging modules, doxygen defaults, etc.). Some packaging modules have been updated to do this as part of this commit. Co-Author: Craig Scott <craig.scott@crascit.com>
* | | | | project: Add <PROJECT-NAME>_DESCRIPTIONCraig Scott2018-03-161-0/+1
| |_|/ / |/| | | | | | | | | | | For consistency with the VERSION keyword, also define the <PROJECT-NAME>_DESCRIPTION variable.
* | | | Help: Clarify ctest build-and-test mode optionsCraig Scott2018-03-131-10/+14
| |/ / |/| | | | | Fixes: #17807
* | | Merge topic 'update-buildsystem-docs'Brad King2018-03-121-6/+5
|\ \ \ | | |/ | |/| | | | | | | | | | | | | 78756429ab Help: Adapt cmake-buildsystem(7) to new IMPORTED targets features Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1839
| * | Help: Adapt cmake-buildsystem(7) to new IMPORTED targets featuresKai Wolf2018-03-121-6/+5
| | | | | | | | | | | | | | | | | | | | | Since commit v3.11.0-rc1~433^2~2 (Teach target_* commands to set INTERFACE properties of IMPORTED targets, 2017-09-18) it is now possible to use the customary `target_*` commands for adjusting the settings of an IMPORTED target. Update documentation accordingly.
* | | Merge topic 'genex-TARGET_EXISTS'Brad King2018-03-121-0/+2
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | 7fec336bf7 genex: Add TARGET_EXISTS to check for target existence Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1829
| * | genex: Add TARGET_EXISTS to check for target existenceAlex Turbov2018-03-091-0/+2
| | | | | | | | | | | | | | | Define `$<TARGET_EXISTS:a>` to `1` if `a` is an existed target name, else `0`.
* | | Merge topic 'avoid-LIB_DEPENDS'Brad King2018-03-081-0/+8
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 7723e9a058 Do not produce legacy _LIB_DEPENDS cache entries 2124a1364a cmTarget: Remove unnecessary RecordDependencies member 1c5bfab532 cmTarget: Simplify ClearDependencyInformation implementation 910a9d608e cmTarget: Simplify ClearDependencyInformation signature Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Pavel Solodovnikov <hellyeahdominate@gmail.com> Merge-request: !1828
| * | | Do not produce legacy _LIB_DEPENDS cache entriesBrad King2018-03-071-0/+8
| |/ / | | | | | | | | | | | | | | | Introduce policy `CMP0073` to avoid producing these cache entries. Fixes: #16364
* | | CTest: Add options to control test process affinity to CPUsBrad King2018-03-051-0/+1
|/ / | | | | | | | | | | | | | | | | | | In commit v2.8.0~170 (ENH: Added ctest test options PROCESSORS and RUN_SERIAL, 2009-09-07) CTest learned to track the number of processors allocated to running tests in order to balance it against the desired level of parallelism. Extend this idea by introducing a new `PROCESSOR_AFFINITY` test property to ask that CTest run a test with the CPU affinity mask set. This will allow a set of tests that are running concurrently to use disjoint CPU resources.
* | Help: Document linking behavior of OBJECT librariesBrad King2018-03-011-16/+25
| | | | | | | | | | Inspired-by: Deniz Bahadir <dbahadir@benocs.com> Issue: #14778
* | Document and extend the CMAKE_SUPPRESS_REGENERATION variableShane Parris2018-02-231-0/+1
| | | | | | | | Fixes: https://gitlab.kitware.com/cmake/cmake/issues/16815
* | Merge topic 'follow-up-misc-typos'Brad King2018-02-201-1/+1
|\ \ | | | | | | | | | | | | | | | | | | 287e7a17 Maint: misc. typos Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1771
| * | Maint: misc. typosluz.paz2018-02-161-1/+1
| | | | | | | | | | | | Found via `codespell`
* | | Merge topic 'genex-IN_LIST-operator'Brad King2018-02-161-0/+2
|\ \ \ | |/ / |/| | | | | | | | | | | | | | 5089f560 Genex: Add IN_LIST logical operator Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1724
| * | Genex: Add IN_LIST logical operatorMarc Chevrier2018-02-071-0/+2
| |/ | | | | | | Implements #17679
* | Merge topic 'directory-property-TESTS'Brad King2018-02-151-0/+1
|\ \ | | | | | | | | | | | | | | | | | | b513a879 Tests management: add TESTS directory property Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1748
| * | Tests management: add TESTS directory propertyMarc Chevrier2018-02-081-0/+1
| |/ | | | | | | Implements: #17680
* | Help: Expand string(MAKE_C_IDENTIFIER) docsCraig Scott2018-02-111-1/+2
|/ | | | | The MAKE_C_IDENTIFIER subcommand was also buried in the docs for the TIMESTAMP subcommand, so it has been pulled out to its own subheading.
* Autogen: Documentation: Update for AUTORCC changesSebastian Holtermann2018-02-031-11/+8
|
* Help: add release notes, documentation for CTEST_RUN_CURRENT_SCRIPT behaviorKyle Edwards2018-01-261-0/+1
|
* Merge topic 'server-polish-opt-handshake'Brad King2018-01-251-4/+4
|\ | | | | | | | | | | | | | | 239a3ef8 Server-mode: Document protocol version for optional handshake arguments 9b1a3d24 Server-mode: Rename functions to reflect what they do Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1693
| * Server-mode: Document protocol version for optional handshake argumentsTobias Hunger2018-01-241-4/+4
| | | | | | | | | | | | | | | | Document which Protocol version only needs the build directory to be passed during a handshake. This is available a bit earlier than that, but from all I can tell 1.2 is the earliest version where that feature is reliably available.
* | Merge topic 'RemoveKDevelop3'Brad King2018-01-251-1/+0
|\ \ | | | | | | | | | | | | | | | | | | | | | 551bd0b3 Generators: adjust error message for the removed KDevelop3 generator 9198e6a2 Generators: remove KDevelop3 generator Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1688
| * | Generators: remove KDevelop3 generatorAlex Neundorf2018-01-241-1/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The last KDevelop3 release was many years ago, in 2008 I think. I haven't seen or read about anybody using KDevelop 3 since a long time, so I think it can safely be removed from CMake. KDevelop 4 (first released in 2010) has its own proper CMake support now, independent from this generator. Alex
* | | Merge topic 'sourceFile-new-properties'Brad King2018-01-251-0/+2
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | | | | | | | | | | 04483111 sourceFile properties: add property INCLUDE_DIRECTORIES 3073bd1f VisualStudio generators: refactoring 78b1c2e0 sourceFile properties: add property COMPILE_OPTIONS 3f935e69 LocalGenerator: refactoring Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1596
| * | sourceFile properties: add property INCLUDE_DIRECTORIESMarc Chevrier2018-01-241-0/+1
| | |
| * | sourceFile properties: add property COMPILE_OPTIONSMarc Chevrier2018-01-231-0/+1
| |/ | | | | | | | | | | | | Add the support of per-source property COMPILE_OPTIONS, including generator expressions support. Related: #17507
* | CPack: accept --trace and --trace-expandIsaiah Norton2018-01-231-0/+6
|/
* Help: Reword misleading docs for cmake -E timeTaylor Braun-Jones2018-01-191-1/+1
|
* Autogen: Add documentation for (CMAKE_)AUTOGEN_PARALLELSebastian Holtermann2018-01-173-1/+4
|
* Genex: Enable COMPILE_LANGUAGE for INCLUDE_DIRECTORIES with VS and XcodeBrad King2018-01-121-18/+13
| | | | | | | | | | | | | | | The set of compile flags used for a target's C and C++ sources is based on the linker language. By default this is always the C++ flags if any C++ sources appear in the target, and otherwise the C flags. Therefore we can define the `COMPILE_LANGUAGE` generator expression in `INCLUDE_DIRECTORIES` to match the selected language. This is not exactly the same as for other generators, but is the best VS and Xcode can do. It is also sufficient for many use cases since the set of include directories for C and C++ is frequently similar but may be distinct from those for other languages like CUDA. Fixes: #17435
* Genex: Enable COMPILE_LANGUAGE for COMPILE_DEFINITIONS with VS and XcodeBrad King2018-01-121-11/+16
| | | | | | | | | | | | | | | The set of compile flags used for a target's C and C++ sources is based on the linker language. By default this is always the C++ flags if any C++ sources appear in the target, and otherwise the C flags. Therefore we can define the `COMPILE_LANGUAGE` generator expression in `COMPILE_DEFINITIONS` to match the selected language. This is not exactly the same as for other generators, but is the best VS and Xcode can do. It is also sufficient for many use cases since the set of definitions for C and C++ is frequently similar but may be distinct from those for other languages like CUDA. Issue: #17435
* Unhardcode the CMAKE_CONFIGURATION_TYPES valuesBeren Minor2018-01-081-0/+3
| | | | | | | | | | | | This removes duplicated code for per-config variable initialization by providing a `cmake_initialize_per_config_variable(<PREFIX> <DOCSTRING>)` function. This function initializes a `<PREFIX>` cache variable from `<PREFIX>_INIT` and unless the `CMAKE_NOT_USING_CONFIG_FLAGS` variable is defined, does the same with `<PREFIX>_<CONFIG>` from `<PREFIX>_<CONFIG>_INIT` for every `<CONFIG>` in `CMAKE_CONFIGURATION_TYPES` for multi-config generators or `CMAKE_BUILD_TYPE` for single-config generators.
* Various typo fixesLuz Paz2018-01-031-1/+1
| | | | Some are user-facing. Others are source comments.