summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'feature/cpack-default-package-version'Craig Scott2018-05-031-0/+5
|\ | | | | | | | | | | | | | | af1c48871c CPack: Use project version as default for `CPACK_PACKAGE_VERSION` Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Harry Mallon <hjmallon@gmail.com> Merge-request: !2020
| * CPack: Use project version as default for `CPACK_PACKAGE_VERSION`Alex Turbov2018-05-021-0/+5
| | | | | | | | | | | | | | | | | | | | * Introduce `CMAKE_PROJECT_VERSION` and the corresponsing components: `CMAKE_PROJECT_VERSION_MAJOR`, `CMAKE_PROJECT_VERSION_MINOR`, `CMAKE_PROJECT_VERSION_PATCH` and `CMAKE_PROJECT_VERSION_TWEAK`. * `CPack` module use `CMAKE_PROJECT_VERSION_MAJOR`, `CMAKE_PROJECT_VERSION_MINOR` and `CMAKE_PROJECT_VERSION_PATCH` to initialize corresponsing CPack variables.
* | Help: Fix and clarify server mode --pipe= option docsIsrael Blancas2018-05-021-2/+4
| | | | | | | | | | | | Document the `=` in the option name. Clarify the term "named pipe" as an abstraction of local domain sockets on Unix and named pipes on Windows.
* | Help: Improve accuracy, readability and cross-referencing of cpack docsCraig Scott2018-04-271-65/+58
|/ | | | | | This is primarily a cleanup of the cpack(1) page. The cpack.cxx file and CPack module were also updated to make the docs relating to the generator specification and option names consistent in all three places.
* Merge topic 'vs-hlsl-object-name'Brad King2018-04-251-0/+1
|\ | | | | | | | | | | | | 8d1ccbc693 VS: Add VS_SHADER_OBJECT_FILE_NAME source file property Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1997
| * VS: Add VS_SHADER_OBJECT_FILE_NAME source file propertyJeremiah van Oosten2018-04-241-0/+1
| |
* | Merge topic 'Genex-TARGET_GENEX_PROPERTY'Brad King2018-04-241-0/+39
|\ \ | | | | | | | | | | | | | | | | | | 4d15046edd Genex: Add $<TARGET_GENEX_EVAL:...> and $<GENEX_EVAL:...> Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1984
| * | Genex: Add $<TARGET_GENEX_EVAL:...> and $<GENEX_EVAL:...>Marc Chevrier2018-04-231-0/+39
| |/ | | | | | | Fixes: #17884
* | Merge topic 'cmake-install-doc'Brad King2018-04-231-0/+1
|\ \ | | | | | | | | | | | | | | | | | | | | | a4f71b4ba8 Help: Document existence of cmake_install.cmake fcf64866da Help: move DESTDIR into a separate page Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1979
| * | Help: move DESTDIR into a separate pageKyle Edwards2018-04-201-0/+1
| |/
* | Merge topic 'add_compile_definitions'Brad King2018-04-232-1/+2
|\ \ | |/ |/| | | | | | | | | cb83314e65 add_compile_definitions: add new command Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1988
| * add_compile_definitions: add new commandMarc Chevrier2018-04-202-1/+2
| | | | | | | | | | | | | | This command manages preprocessor definitions at directory level and supports generator expressions. Fixes: #15374
* | Merge topic 'vs-sdk-dirs'Brad King2018-04-201-0/+7
|\ \ | | | | | | | | | | | | | | | | | | 6ec3e880e7 VS: Add variables to set SDK directories in vcxproj files Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1965
| * | VS: Add variables to set SDK directories in vcxproj filesBastien Schatt2018-04-191-0/+7
| | | | | | | | | | | | | | | | | | | | | Create `CMAKE_VS_SDK_*_DIRECTORIES` variables to tell the VS generator how to populate fields in `.vcxproj` files that specify SDK directories. Fixes: #17908
* | | Help: Drop direct link to Wiki/FAQ pageBrad King2018-04-191-7/+3
| |/ |/| | | | | | | Instead mention that community resources are available on the general documentation landing page.
* | Merge topic 'CheckIncludeFile-required-libs'Brad King2018-04-191-0/+1
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | a61ae3fb80 CheckIncludeFiles: Honor CMAKE_REQUIRED_LIBRARIES 391a5837ee cmake_policy: Add undocumented PARENT_SCOPE option to GET 3c47ac5b25 OpenWatcom: Add workaround for lack of error on missing library Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1978
| * | CheckIncludeFiles: Honor CMAKE_REQUIRED_LIBRARIESBrad King2018-04-181-0/+1
| |/ | | | | | | | | | | | | | | | | | | | | | | | | Other check modules honor this variable, so include file checks should too. Add policy `CMP0075` to enable the behavior in a compatible way. This change was originally made by commit v3.11.0-rc1~108^2 (CheckIncludeFiles: Honor CMAKE_REQUIRED_LIBRARIES, 2017-12-24) but it was reverted by commit v3.11.1~9^2 (Revert "CheckIncludeFiles: Honor CMAKE_REQUIRED_LIBRARIES", 2018-04-04) because the behavior change could affect checks in existing projects in an incompatible way. Fixes: #9514
* | Help: Fix command-line synopsis markup syntaxBrad King2018-04-184-5/+5
|/ | | | | | Use `{}` to surround required parts instead of `()`. Fixes: #17917
* Merge topic 'add_support_for_clr_targets'Brad King2018-04-121-0/+2
|\ | | | | | | | | | | | | | | | | | | | | | | | | 312527de47 document COMMON_LANGUAGE_RUNTIME target properties 4b7a82b4ed cmVisualStudio10TargetGenerator: set /clr compiler flag from property 20e31fb4c9 cmExportFileGenerator: add target property for managed targets 411a22706a cmGeneratorTarget: add handling of managed assemblies to HasImportLibrary() fb433ff283 cmGeneratorTarget: Make import library checks config-aware 4c1f33961f cmGeneratorTarget: add GetManagedType() and CheckManagedType() methods 6c517a9f8d cmGeneratorTarget: add HasLanguage() as wrapper for GetLanguages() Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1916
| * document COMMON_LANGUAGE_RUNTIME target propertiesMichael Stürmer2018-04-091-0/+2
| |
* | MSVC: Add MSVC_TOOLSET_VERSION variableArkady Shapkin2018-04-041-0/+1
|/ | | | | | Provide the MSVC toolset version number based on the compiler version. Fixes: #16923
* 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`