summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'ninja-multi-variable-shuffle'Brad King2020-02-031-4/+3
|\ | | | | | | | | | | | | b966f86d86 Ninja Multi-Config: Shuffle variables around Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4305
| * Ninja Multi-Config: Shuffle variables aroundKyle Edwards2020-02-031-4/+3
| | | | | | | | | | | | Remove redundant variable CMAKE_NINJA_MULTI_CROSS_CONFIG_ENABLE. Rename other variables. Document and improve handling of error conditions.
* | Merge topic 'ctest-add-ignore-no-tests-option'Kyle Edwards2020-02-031-0/+8
|\ \ | | | | | | | | | | | | | | | | | | a39d4139d0 Add --no-tests=<[error|ignore]> option to CTest Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4258
| * | Add --no-tests=<[error|ignore]> option to CTestStefan Dinkelacker2020-01-311-0/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | If no tests were found, the default behavior of CTest is to always log an error message but to return an error code in script mode only. This option unifies the behavior of CTest by either returning an error code if no tests were found or by ignoring it. Signed-off-by: Stefan Dinkelacker <s.dinkelacker@dkfz-heidelberg.de>
* | | AIX: Add an option to disable automatic exports from shared librariesBrad King2020-01-312-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since commit 0f150b69d3 (AIX: Explicitly compute shared object exports for both XL and GNU, 2019-07-11, v3.16.0-rc1~418^2~2) we always export all symbols from shared libraries by default. Add a new target property called `AIX_EXPORT_ALL_SYMBOLS` that can be explicitly set to OFF to suppress this behavior and export no symbols by default. Fixes: #20290
* | | Merge topic 'document_cmake_reserved_names'Brad King2020-01-303-0/+10
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | 2158ef3e44 Help: Document which variable names CMake reserves. Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4298
| * | Help: Document which variable names CMake reserves.Robert Maynard2020-01-293-0/+10
| | |
* | | Merge topic 'osx-version-flags'Brad King2020-01-281-0/+2
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6a84f0b791 macOS: Test OSX_COMPATIBILITY_VERSION and OSX_CURRENT_VERSION properties 4a62e3d97c macOS: Add OSX_COMPATIBILITY_VERSION and OSX_CURRENT_VERSION properties Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4274
| * | | macOS: Add OSX_COMPATIBILITY_VERSION and OSX_CURRENT_VERSION propertiesIsuru Fernando2020-01-241-0/+2
| | |/ | |/| | | | | | | Fixes: #17652
* | | Merge topic 'QNX_CMAKE_SYSROOT'Brad King2020-01-281-0/+3
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | 32a6ab1f3b QNX: Add support for CMAKE_SYSROOT Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4277
| * | QNX: Add support for CMAKE_SYSROOTStephen Kelly2020-01-271-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | QCC is a wrapper around GCC, but it is not a fully transparent wrapper. Some compile options need to be passed to GCC using a `-Wc` option. QCC does not support --sysroot, so setting CMAKE_SYSROOT in a toolchain file currently does not work. This means that it is likely that no one is setting CMAKE_SYSROOT in existing QNC toolchain files. Override the GCC option for sysroot in the QCC.cmake file with -Wc,-isysroot. This exposes a further issue in that the QNX SDK does not follow the same architectural folder structure as linux uses. That is, on linux systems, architecture-specific libraries might be in <sysroot>/usr/lib/<arch> such as /usr/lib/x86_64-linux-gnu/libcurl.so CMake models this by suffixing the <arch> onto lib directories when searching for libraries. The QNX SDK is structured differently such that the <arch> should be used as a prefix: <sysroot>/<arch>/usr/lib such as <sysroot>/x86_64/usr/lib/libcurl.so Add a variable for platform configuration to set whether to prefix or suffix the <arch> and set that in the QCC.cmake. Use the directory structure of the QNX SDK to compute the <arch> from the implicit library directories. The assumption is that the arch will be a single directory directly below the CMAKE_SYSROOT, below which the usr/ prefix occurs. It would not be appropriate to instruct users to make the <arch> part of the sysroot when specified in the toolchain file because: 1. That would be non-DRY - The QCC wrapper already determines the <arch> by the -V argument passed to the compiler, specified in the toolchain file as the CMAKE_C_COMPILER_TARGET variable. 2. The includes in the QNX SDK are not below the <arch> directory. So, the location of the <arch> in the full path is different on QNX compared to, say an embedded linux platform, but the intent is the same. Add documentation to recommend the use of CMAKE_SYSROOT in a QNX toolchain file. As the CMAKE_SYSROOT is always the same for QNX, it would be possible to simply set it in QCC.cmake. However, that would change behavior for existing users as when CMAKE_SYSROOT is set, files/paths outside of the CMAKE_SYSROOT do not get found. The <arch> prefixing is only enabled in cmSearchPath.cxx if CMAKE_SYSROOT is set. This ensures that the user gets consistency in the current state without CMAKE_SYSROOT, and gets better consistency when using CMAKE_SYSROOT.
* | | Merge topic 'cuda_runtime_library_controls'Brad King2020-01-282-0/+2
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 0d0145138f CUDA: Add abstraction for cuda runtime selection Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4178
| * | | CUDA: Add abstraction for cuda runtime selectionRobert Maynard2020-01-272-0/+2
| | | | | | | | | | | | | | | | | | | | Fixes #17559 Replace our hard-coded default of cudart=static with a first-class abstraction to select the runtime library from an enumeration of logical names.
* | | | Merge topic 'ninja-multi-cross-configs'Brad King2020-01-241-0/+1
|\ \ \ \ | |_|/ / |/| | | | | | | | | | | | | | | | | | | b7a2baf38c Ninja Multi-Config: Add variable to control configs used in cross-config build Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4269
| * | | Ninja Multi-Config: Add variable to control configs used in cross-config buildKyle Edwards2020-01-231-0/+1
| | | |
* | | | Merge topic 'vs-dotnet-standard-core'Brad King2020-01-242-0/+2
|\ \ \ \ | |_|/ / |/| | | | | | | | | | | | | | | | | | | ae1e1909a1 VS: Add support for .NET Standard and .NET Core Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4240
| * | | VS: Add support for .NET Standard and .NET CoreJoerg Bornemann2020-01-242-0/+2
| | |/ | |/| | | | | | | Fixes: #20105
* | | Merge topic 'trace_json_timestamp'Brad King2020-01-241-3/+11
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | | | | c829f0cfca trace: Add time and stack level to JSON output format Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Volo Zyko <volo.zyko@gmail.com> Merge-request: !4242
| * | trace: Add time and stack level to JSON output formatFrank Winklmeier2020-01-221-3/+11
| |/ | | | | | | | | | | | | | | Add the timestamp and stack depth of the function call to the JSON trace output format. This information can be useful for cmake profiling and call stack inspection (see e.g. https://github.com/volo-zyko/cmake-profile-stats). Improve unit test to allow for varying set of keys to check in trace lines.
* | Ninja Multi-Config: Add variable to control aliases in build.ninjaKyle Edwards2020-01-221-0/+1
| |
* | Merge topic 'mark_as_advanced-without-cache'Brad King2020-01-221-0/+1
|\ \ | |/ |/| | | | | | | | | | | | | | | | | | | | | | | | | 3ec82b713e cmMarkAsAdvancedCommand: ignore variables which don't exist in the cache 701a5c60e0 cmake: avoid marking local or unused variables as advanced af158149e7 FindOpenSSL: do not mark a local variable as advanced 74f659f1f2 FindCurses: only mark CURSES_EXTRA_LIBRARY when it is used 7e2ae4e96d FindOpenGL: only mark declared cache variables as advanced 7cc02a0c29 FindLua: only mark LUA_MATH_LIBRARY as advanced if required 85cd26b8a6 FindBoost: only mark Boost_DIR as advanced if defined 338c7916ba CTest: avoid marking undeclared cache variables as advanced ... Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4150
| * cmMarkAsAdvancedCommand: ignore variables which don't exist in the cacheBen Boeckel2020-01-201-0/+1
| | | | | | | | Fixes: #18331
* | Merge topic 'cmake-ctest-arguments'Brad King2020-01-171-0/+1
|\ \ | | | | | | | | | | | | | | | | | | 4153d8445b Add CMAKE_CTEST_ARGUMENTS variable to pass command-line arguments to ctest Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4168
| * | Add CMAKE_CTEST_ARGUMENTS variable to pass command-line arguments to ctestRobert Goulet2020-01-151-0/+1
| |/ | | | | | | Fixes: #20172
* | Merge topic 'rename-cross-config-variable'Brad King2020-01-171-2/+2
|\ \ | | | | | | | | | | | | | | | | | | 310b58e961 Ninja Multi-Config: Rename variable to be more consistent Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4234
| * | Ninja Multi-Config: Rename variable to be more consistentKyle Edwards2020-01-161-2/+2
| |/ | | | | | | Also make some tweaks to the documentation.
* | Ninja: Add a separate job pool for PCH creationDan Johnston2020-01-162-0/+2
|/ | | | | | | Add a `JOB_POOL_PRECOMPILE_HEADER` target property to specify the pool name, and its associated `CMAKE_JOB_POOL_PRECOMPILE_HEADER` variable. Fixes: #20217
* Merge topic 'doc-user-interaction'Brad King2020-01-141-0/+0
|\ | | | | | | | | | | | | | | | | | | | | bd681fee7a Help: Add guides for user interaction 6185265800 Utilities/Sphinx: Index guide-level documents for cross-referencing b1b7d01172 Utilities/Sphinx: Index document types only by top level directory Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Mateusz Łoskot <mateusz@loskot.net> Acked-by: Daan De Meyer <daan.j.demeyer@gmail.com> Merge-request: !4097
| * Help: Add guides for user interactionStephen Kelly2020-01-131-0/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add some prose to the documentation index page to guide readers to the major manuals and guides. Add a new "User Interaction Guide" to help the class of new user who wishes to build a project with CMake for the first time, such as after cloning a repo from a git repository. Add a new "Using Dependencies Guide" to help the class of new user who wishes to consume a SDK provided by a third party and needs a starting point. This is a different type of user to the user who wishes to create their own project from scratch (addressed by the `cmake-buildsystem(7)` manual) as each will encounter needs for information discovery in a different order.
* | Merge topic 'target_compile_options-BEFORE-keyword'Brad King2020-01-131-0/+1
|\ \ | | | | | | | | | | | | | | | | | | 2678e31053 target_compile_options: ensure BEFORE keyword is handled in all scopes Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4203
| * | target_compile_options: ensure BEFORE keyword is handled in all scopesMarc Chevrier2020-01-111-0/+1
| |/ | | | | | | Fixes: #20200
* | Ninja Multi-Config: Make cross-config building opt-inKyle Edwards2020-01-101-0/+1
|/ | | | | | | | | | | Many users will want to use the Ninja Multi-Config generator like a traditional Visual Studio-style multi-config generator, which doesn't mix configurations - custom commands are built using target executables of the same configuration the command is for. We do not want to force these people to generate an N*N build matrix when they only need N*1, especially if they have lots of targets. Add a new variable, CMAKE_NINJA_CROSS_CONFIG_ENABLE, to opt-in to the cross-config build matrix.
* Help: Fix sorting of property indexesCraig Scott2020-01-091-8/+8
|
* Autogen: Process .hh headers based on new policy CMP0100 settingsSebastian Holtermann2020-01-041-0/+1
| | | | | | | Reintroduces .hh header processing in AUTOMOC and AUTOUIC based on the new policy CMP0100 setting. Fixes: #13904 CMAKE_AUTOMOC misses headers with ".hh" extension
* Merge topic 'add_target_deprecation'Kyle Edwards2020-01-031-0/+1
|\ | | | | | | | | | | | | | | c621839bd9 Add set_property option: DEPRECATION Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Daniele E. Domenichelli <ddomenichelli@drdanz.it> Merge-request: !4128
| * Add set_property option: DEPRECATIONJoseph Snyder2020-01-021-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | Add a new property flag for a target which contains a message regarding deprecation status. Add a warning at "Generate" time if a linked target is marked as deprecated. Expand ExportImport test to ensure that new property is being set and passed correctly. Ensure that the message is shown during the "Generate" step run of the ExportImport test.
* | Merge topic 'traceJSON'Kyle Edwards2019-12-271-0/+60
|\ \ | | | | | | | | | | | | | | | | | | | | | e113ab1168 trace: Add test for the JSON-v1 trace 482497e0de trace: Add JSON output format Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4102
| * | trace: Add JSON output formatDaniel Mensinger2019-12-231-0/+60
| |/ | | | | | | | | | | | | | | Add a new `--trace-format=` flag, to enable the new JSON trace output format. This new format is easier to parse by machines than the existing format. This new format also removes the ambiguity of the whitespace in the "old" format (e.g. is that whitespace part of a file path, or does it seperate arguments)
* | Help: Document CMAKE_FIND_DEBUG_MODERobert Maynard2019-12-191-0/+1
| |
* | find_*: Add debug logging infrastructureRobert Maynard2019-12-191-0/+6
|/ | | | | | | | | | | | Enable debug messages a new `--find-debug` command-line option or via the `CMAKE_FIND_DEBUG_MODE` variable. This work was started by Chris Wilson, continued by Ray Donnelly, and then refactored by Robert Maynard to collect information into a single message per find query. Co-Author: Ray Donnelly <mingw.android@gmail.com> Co-Author: Chris Wilson <chris+github@qwirx.com>
* Merge topic 'FindCUDAToolkit-module'Brad King2019-12-171-0/+1
|\ | | | | | | | | | | | | | | | | | | | | | | | | d484a3c4d8 FindCUDAToolkit: correct searches for Toolkit components e2a5d8374f FindCUDAToolkit: Improve usage, library set, and tests 29560bf07b FindCUDAToolkit: Import targets for toolkit libraries 2c0ff263b4 FindCUDAToolkit: Add module to find the CUDA Toolkit 12d324e55d CUDA: Persist SIZEOF_VOID_P and PLATFORM_ABI Acked-by: Kitware Robot <kwrobot@kitware.com> Rejected-by: Brad King <brad.king@kitware.com> Acked-by: Brad King <brad.king@kitware.com> Merge-request: !4093
| * FindCUDAToolkit: Add module to find the CUDA ToolkitStephen McDowell2019-12-161-0/+1
| |
* | CMAKE_DEBUG_TARGET_PROPERTIES to `provides information` sectionRobert Maynard2019-12-161-1/+1
|/ | | | | | This variable only provides debug information and doesn't modify the output of CMake, so move it to the correct variable section.
* Help: Add documentation and release notes for multi-config NinjaKyle Edwards2019-12-132-2/+4
|
* Merge topic 'function-var-current'Kyle Edwards2019-12-121-0/+4
|\ | | | | | | | | | | | | | | | | | | 24fdd51f45 Refactor: Replace CMAKE_CURRENT_LIST_DIR with CMAKE_CURRENT_FUNCTION_LIST_DIR 90e3e2a777 cmFunctionCommand: Introduce `CMAKE_CURRENT_FUNCTION*` variables dd54290dab Refactor: Modernize `function` command Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !4000
| * cmFunctionCommand: Introduce `CMAKE_CURRENT_FUNCTION*` variablesAlex Turbov2019-12-101-0/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | `CMAKE_CURRENT_FUNCTION` Can be used for diagnostic or debugging messages like the `__PRETTY_FUNCTION__` macro of GCC. `CMAKE_CURRENT_FUNCTION_LIST_DIR` Eliminates the necessity of the additional "global" variables inside a module used to access additional "resource" files from functions defined in the module. ...
* | Merge topic 'add_cuda_meta_compiler_features'Brad King2019-12-123-6/+9
|\ \ | | | | | | | | | | | | | | | | | | 2467a2b318 CUDA: Add cuda meta-features (e.g. ``cuda_std_11``) support Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3992
| * | CUDA: Add cuda meta-features (e.g. ``cuda_std_11``) supportRobert Maynard2019-12-103-6/+9
| | |
* | | Merge topic 'ctest-drmemory-support'Brad King2019-12-121-0/+14
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 676befdf52 ctest: add support for memcheck using Dr. Memory 2db0a65f56 cmCTestMemCheckHandler.cxx: minor refactoring Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4119
| * | | ctest: add support for memcheck using Dr. MemoryDietmar Scheidl2019-12-101-0/+14
| | | | | | | | | | | | | | | | Fixes: #19788
generated by cgit v0.12 at 2025-01-19 07:10:18 (GMT)