summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* 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.
* CTest: Expand 'Label and Subproject Summary' section of manualBetsy McPhail2017-12-151-3/+31
|
* Merge branch 'backport-revert-server-target-backtraces' into ↵Brad King2017-12-061-41/+1
|\ | | | | | | revert-server-target-backtraces
| * server: Revert "Report backtraces in codemodel response"Brad King2017-12-061-41/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The backtrace information is very repetitive and hugely increases the size of the codemodel object. We need to remove it until an alternative representation can be developed. Revert commit v3.10.0-rc1~393^2 (server: Report backtraces in codemodel response, 2017-06-20), except for the protocol version number (because it indicates other new things). Unfortunately this is incompatible with clients that expect the "crossReferences" field in targets. However, the regression in memory usage is quite serious, especially on large projects, and therefore breaks even older clients that do not use backtraces. Since the "crossReferences" field was only provided by one release (3.10.0), it is simplest to revert it outright for 3.10.1. Fixes: #17502
| * Merge branch 'imported-interface-no-system' into release-3.10Brad King2017-10-131-2/+2
| |\ | | | | | | | | | Merge-request: !1386
* | | server: drop "ctestInfo" backtrace informationBrad King2017-12-061-11/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | Backtrace information was included by commit 35a52bd1b4 (server: add "ctestInfo" request to get test info, 2017-10-25) to match that already provided for targets. However, the backtrace representation uses too much memory and needs to be dropped. Remove it from test information. Issue: #17502
* | | Merge topic 'cmake-job-pool'Brad King2017-12-041-0/+1
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 07185055 Ninja: add CMAKE_JOB_POOLS variable as default for JOBS_POOLS Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1514
| * | | Ninja: add CMAKE_JOB_POOLS variable as default for JOBS_POOLSMatt McCormick2017-11-291-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This enables configuration of build parallelism with the Ninja generator by passing arguments on the command line to CMake. For example, cmake \ '-DCMAKE_JOB_POOLS:STRING=compile=5;link=2' \ -DCMAKE_JOB_POOL_COMPILE:STRING=compile \ -DCMAKE_JOB_POOL_LINK:STRING=link \ ~/src/MyProject
* | | | Merge topic 'findiconv-module'Brad King2017-11-301-0/+1
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 95646591 FindIconv: Add the FindIconv module. Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1530
| * | | | FindIconv: Add the FindIconv module.Christian Pfeiffer2017-11-291-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | This module provides abstraction over the various ways POSIX platforms handle the iconv calls defined in POSIX.1-2001 and later versions.
* | | | | Merge topic 'CodeBlocks-custom-compiler-id'Brad King2017-11-291-0/+1
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | e04f1d1b CodeBlocks: add option for the CB compiler ID Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1512
| * | | | | CodeBlocks: add option for the CB compiler IDMelven Roehrig-Zoellner2017-11-271-0/+1
| |/ / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | CodeBlocks uses his own compiler ID string which may differ from CMAKE_<LANG>_COMPILER_ID. In particular CodeBlocks supports a large number of different compiler configurations (with different IDs) This commit adds a cache variable "CMAKE_CODEBLOCKS_COMPILER_ID", so the user might adjust it when needed.
* | | | | Merge topic 'extend-compile-language-genex'Brad King2017-11-271-5/+7
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2ae880fa Genex: Enable COMPILE_LANGUAGE for COMPILE_OPTIONS with Visual Studio 2b7d59f3 Genex: Enable COMPILE_LANGUAGE for file(GENERATE) with Visual Studio 0f6f7c8a Genex: Fix COMPILE_LANGUAGE messages to allow file(GENERATE) with Xcode c5a82d0f Tests: Decouple COMPILE_LANGUAGE in file(GENERATE) from COMPILE_OPTIONS 25773650 Tests: Remove unnecessary result files from RunCMake.File_Generate Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Jason Juang <jasjuang@gmail.com> Merge-request: !1511
| * | | | | Genex: Enable COMPILE_LANGUAGE for COMPILE_OPTIONS with Visual StudioBrad King2017-11-201-5/+7
| |/ / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since commit v3.9.0-rc4~3^2~1 (VS: Fix target_compile_options for CUDA, 2017-06-21), the evaluation of `COMPILE_LANGUAGE` receives the proper language. 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_OPTIONS` to match the selected language. This is not exactly the same as for other generators, but is the best VS can do. It is also sufficient for many use cases since the set of allowed flags for C and C++ is almost the same in Visual Studio. Furthermore, since the VS generator moves many of the flags to declarative `.vcxproj` elements, it will automatically avoid passing C++ flags for C sources. Issue: #17435
* | | | | Merge topic 'server-target-isGeneratorProvided'Brad King2017-11-271-0/+2
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | afd9a339 server: return whether or not a target is generator provided Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1475
| * | | | | server: return whether or not a target is generator providedJustin Goshi2017-11-201-0/+2
| | |/ / / | |/| | | | | | | | | | | | | | | | | | | | | | | Some generators auto-generate targets. For example VS generators create the ALL_BUILD target. Add the ability to mark targets as generator provided and return that info through cmake-server codemodel.
* | | | | Merge topic 'serverFixTestDiscovery'Brad King2017-11-271-18/+1
|\ \ \ \ \ | |/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | fe2c2b0f server: ctestInfo fix to return all tests Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1479
| * | | | server: ctestInfo fix to return all testsJustin Goshi2017-11-171-18/+1
| |/ / / | | | | | | | | | | | | | | | | Prior to this change we were looking at targets. But tests are associated with directories. This change fixes how we gather all tests.
* | | | Merge topic 'cuda-sep-comp-var'Brad King2017-11-201-0/+1
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 00e13993 CUDA: Add CMAKE_CUDA_SEPARABLE_COMPILATION variable Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Alexander Korsunsky <a.korsunsky@gmail.com> Merge-request: !1495
| * | | | CUDA: Add CMAKE_CUDA_SEPARABLE_COMPILATION variableBrad King2017-11-171-0/+1
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | Use its value to initialize the `CUDA_SEPARABLE_COMPILATION` target property when targets are created. Fixes: #17478
* | | | FindOpenGL: Add policy CMP0072 to prefer GLVND for legacy GLBrad King2017-11-171-0/+8
|/ / / | | | | | | | | | Fixes: #17449
* | | Merge topic 'update-ctest-documentation'Brad King2017-11-101-117/+163
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 3b272ff8 Help: Add 'Label and Subproject Summary' section to ctest(1) manual 002d0a1c Help: Normalize capitalization of 'CTest' in ctest(1) manual 9d3aa95c Help: Divide ctest(1) manual options into sections 7904b659 Tests: Remove incorrect use of 'test-timeout' option e80dc2ad cmCTest: Remove dead code Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1427
| * | | Help: Add 'Label and Subproject Summary' section to ctest(1) manualBetsy McPhail2017-11-101-1/+27
| | | |
| * | | Help: Normalize capitalization of 'CTest' in ctest(1) manualBetsy McPhail2017-11-101-24/+24
| | | |
| * | | Help: Divide ctest(1) manual options into sectionsBetsy McPhail2017-11-101-87/+114
| | | |
| * | | cmCTest: Remove dead codeBetsy McPhail2017-11-071-7/+0
| | | | | | | | | | | | | | | | The option 'ctest-config' is ignored.
* | | | Merge topic 'cmakeServerRequiredCMakeVersion'Brad King2017-11-101-0/+3
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | cdf5f34b server: return minimum cmake required version for each project Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1462
| * | | | server: return minimum cmake required version for each projectJustin Goshi2017-11-071-0/+3
| |/ / /
* | | | CPack: enable setting default dir creation permissionsDomen Vrankar2017-11-081-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Introduces CPACK_DEFAULT_DIRECTORY_INSTALL_PERMISSIONS variable which adds support for functionality introduced by CMAKE_DEFAULT_DIRECTORY_INSTALL_PERMISSIONS variable. Fixes #17333 # Conflicts: # Help/release/dev/cmake-default-dir-install-permissions.rst
* | | | CMake: enable setting default dir creation permissionsDomen Vrankar2017-11-081-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Introduces CMAKE_DEFAULT_DIRECTORY_INSTALL_PERMISSIONS variable which enables the user to specify the default permissions for directory creation. This setting is then used to auto set the permissions on directories which are implicitly created by install() and file(INSTALL) commands such as CMAKE_INSTALL_PREFIX directories.
* | | | Merge topic 'imported-promotion'Brad King2017-11-081-0/+1
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | | | | | 6a3922be Add new target-property `IMPORTED_GLOBAL`. 854e482a cmTarget: Simplified and fixed a string-comparision. Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1254
| * | | Add new target-property `IMPORTED_GLOBAL`.Deniz Bahadir2017-11-071-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The purpose of this new `IMPORTED_GLOBAL` target-property is to prolong the lifetime and scope of `IMPORTED` targets in such a way as if they had been created with the keyword `GLOBAL` in the first place. * It can only be set to `TRUE`. That means, a local `IMPORTED` target can be promoted to global scope but a global `IMPORTED` target cannot be degraded to local scope! * Setting it to `TRUE` only succeeds if done from within the same directory in which the `IMPORTED` target was created in the first place. Fixes #17256.
* | | | Merge topic 'server-test-info'Brad King2017-11-071-0/+73
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | 35a52bd1 server: add "ctestInfo" request to get test info Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1414
| * | | server: add "ctestInfo" request to get test infoJustin Goshi2017-11-031-0/+73
| | | |