summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'vs-toolset-version'Brad King2018-05-301-0/+1
|\ | | | | | | | | | | | | | | 5f13168419 VS: Add option to select the version of the toolset used by VS 2017 Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Francisco Facioni <fran6co@gmail.com> Merge-request: !2093
| * VS: Add option to select the version of the toolset used by VS 2017Basil Fierz2018-05-291-0/+1
| | | | | | | | | | | | | | | | Add new `version=` parameter in the toolset setting to select the version. Add variable `CMAKE_VS_PLATFORM_TOOLSET_VERSION` to hold the version, if one is set (blank indicates default). Fixes: #17549
* | Merge topic 'parallel_build_option'Brad King2018-05-292-0/+8
|\ \ | |/ |/| | | | | | | | | | | 1ab3881ec9 cmake: Add options for parallel builds to --build mode Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Henry Schreiner <henryschreineriii@gmail.com> Merge-request: !1962
| * cmake: Add options for parallel builds to --build modeFlorian Maushart2018-05-252-0/+8
| | | | | | | | | | | | | | While we already support `cmake --build . -- -j`, the options after `--` are specific to the native build tool. Add new options `--parallel [<N>]` and `-j [<N>]` to abstract this and map to the proper option for the native build tool.
* | Merge topic 'cmake-D-option-help'Craig Scott2018-05-271-1/+1
|\ \ | | | | | | | | | | | | | | | | | | 42738e5075 Help: Update description of the -D option to CMake Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2105
| * | Help: Update description of the -D option to CMakeRaul Laasner2018-05-241-1/+1
| | | | | | | | | | | | Fixes #18021
* | | FindODBC: Add module to search for ODBC libraryMateusz Loskot2018-05-221-0/+1
|/ / | | | | | | Add tests for FindODBC module.
* | Eclipse: Add property to include additional contents in .cproject fileMelanie Cappelaere2018-05-181-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | Similar to ECLIPSE_EXTRA_NATURES which can be used to add a third party nature to the .project, this property offers the possibility to inject third party contents into the .cproject. An example of where this is useful is MCUXpresso. This is an IDE based on Eclipse. Compiling through CMake generated Eclipse projects works fine by using a custom toolchain. However, in order to be able to debug using such a project, an extra storageModule specific to the target board is needed in the cproject.
* | added CMAKE_DOTNET_TARGET_FRAMEWORK_VERSION variableMichael Stürmer2018-05-152-0/+2
| | | | | | | | Fixes: #17955
* | CPack: Add NuGet supportAlex Turbov2018-05-111-0/+1
|/ | | | | | | | | | | | | | | | | | | | | | | | | | | Create a CPack generator that uses `nuget.exe` to create packages: https://docs.microsoft.com/en-us/nuget/what-is-nuget NuGet packages could be easily produced from a `*.nuspec` file (running `nuget pack` in the directory w/ the spec file). The spec filename does not affect the result `*.nupkg` name -- only `id` and `version` elements of the spec are used (by NuGet). Some implementation details: * Minimize C++ code -- use CMake script do to the job. It just let the base class (`cmCPackGenerator`) to preinstall everything to a temp directory, render the spec file and run `nuget pack` in it, harvesting `*.nupkg` files...; * Ignore package name (and use default paths) prepared by the base class (only `CPACK_TEMPORARY_DIRECTORY` is important) -- final package filename is a responsibility of NuGet, so after generation just scan the temp directory for the result `*.nupkg` file(s) and update `packageFileNames` data-member of the generator; * The generator supports _all-in-one_ (default), _one-group-per-package_ and _one-component-per-package_ modes.
* 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