summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* Android: Use unified toolchain in NDK r19+Brad King2019-07-261-2/+4
| | | | | | | | | | | | | | | | | | | The NDK build system now uses only a single toolchain in <ndk>/toolchains/llvm/prebuilt/<host> Its compilers are always `bin/{clang,clang++}` and its binutils are always `bin/<triple>-*`. It is a standalone toolchain: * The Anrdoid API level is specified at the end of `--target=`. * The standard library may be specified via `-stdlib=`. * No need to pass system includes or libraries explicitly. * No need to pass `--sysroot` or `-gcc-toolchain`. Teach CMake to recognize NDK versions that have a unified toolchain with its own sysroot and use the above approach. Fixes: #18739
* Merge topic 'ep_support_no_submodule_init'Kyle Edwards2019-07-261-0/+1
|\ | | | | | | | | | | | | d6be117ca0 ExternalProject: Support not initializing any submodules Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3579
| * ExternalProject: Support not initializing any submodulesRobert Maynard2019-07-241-0/+1
| | | | | | | | Fixes #15592
* | Help: Add documentation for INSTALL_REMOVE_ENVIROMENT_RPATHJiang Yue2019-07-252-0/+2
|/
* Merge topic 'cpack-install-scripts'Craig Scott2019-07-221-1/+0
|\ | | | | | | | | | | | | 5f96601675 CPack: Introduce CPACK_INSTALL_SCRIPTS variable Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3531
| * CPack: Introduce CPACK_INSTALL_SCRIPTS variableAlex Turbov2019-07-211-1/+0
| | | | | | | | | | | | | | | | | | | | The singular name `CPACK_INSTALL_SCRIPT` has existed but was not linked from the CPack documentation. Also, it supported multiple values and should have had a plural name. Add a plural-named alternative now. If both `CPACK_INSTALL_SCRIPTS` and `CPACK_INSTALL_SCRIPT` are set then ignore the latter with a warning. Signed-off-by: Alex Turbov <i.zaufi@gmail.com>
* | Merge topic 'feature/message-indent'Craig Scott2019-07-221-0/+1
|\ \ | | | | | | | | | | | | | | | | | | 5f6fd917a3 message(): Control indentation via CMAKE_MESSAGE_INDENT Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3464
| * | message(): Control indentation via CMAKE_MESSAGE_INDENTAlex Turbov2019-07-211-0/+1
| | |
* | | Help: Add documentation for SKIP_REGULAR_EXPRESSION test propertyGabor Bencze2019-07-181-0/+1
| | |
* | | Merge topic 'aix-exe-implib'Brad King2019-07-171-0/+4
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 2fa920c0cd AIX: Create import library for executables with exports Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3561
| * | | AIX: Create import library for executables with exportsBrad King2019-07-161-0/+4
| |/ / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | On AIX, plugins meant to be loaded into executables via `dlopen` must be linked with access to a list of symbols exported from the executable in order to use them (when not using runtime linking). The AIX linker supports specifying this list as an "import file" passed on the command line either via the `-bI:...` option or (with a leading `#! .` line) as a normal input file like any other library file. The linker import file plays the same role on AIX as import libraries do on Windows. Teach CMake to enable its import library abstraction on AIX for executables with the `ENABLE_EXPORTS` target property set. Teach our internal `ExportImportList` script to optionally generate a leading `#! .` line at the top of the generated export/import list. Update our rule for linking an executable with exports to generate a public-facing "import library" implemented as an AIX linker import file. With this approach, our existing infrastructure for handling import libraries on Windows will now work for AIX linker import files too: * Plugins that link to their executable's symbols will be automatically linked using the import file on the command line. * The executable's import file will be (optionally) installed and exported for use in linking externally-built plugins. This will allow executables and their plugins to build even if we later turn off runtime linking. Issue: #19163
* | | Merge topic 'project-version-0'Brad King2019-07-171-0/+1
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 0ba5891ead project: Keep leading `0` in PROJECT_VERSION components 5f84669806 Tests: Factor out RunCMake.project helper macro into module b1f387a7ea Refactor: Use raw string literals instead of escaping 41b85968d8 Refactor: Use initializer lists instead of `push_back` series 45e85dd2b2 Refactor: Add some `const` to vars 90f91e4d21 Refactor: Replace a "magic" number w/ a named constant 638383c38f Refactor: Eliminate one-time-used variables 9b6a53292f Refactor: Eliminate `sep` from the loop Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3517
| * | project: Keep leading `0` in PROJECT_VERSION componentsAlex Turbov2019-07-161-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | Introduce CMake policy `CMP0096` to make `project()` keep leading zeros in version components. As a side effect, it now allows really long version numbers. Fixes: #19421 Co-Author: Brad King <brad.king@kitware.com>
* | | Merge topic 'cmake-e-true-false'Brad King2019-07-121-0/+6
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | b8828ecbba cmake -E: Add true and false commands Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3542
| * | | cmake -E: Add true and false commandsKyle Edwards2019-07-111-0/+6
| | | |
* | | | Merge topic 'ctest_make_program__propagated_to_cmake_configure_pass'Brad King2019-07-121-1/+2
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | cd681f1f41 ctest: propagate make program to cmake Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3483
| * | | ctest: propagate make program to cmakeRobert Maynard2019-07-111-1/+2
| | | |
* | | | Merge topic 'eclipse-resource-encoding'Brad King2019-07-111-0/+1
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 09c1991895 Eclipse: Add option to set the resource encoding Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3525
| * | | | Eclipse: Add option to set the resource encodingMartin Gerhardy2019-07-091-0/+1
| | |/ / | |/| |
* | | | Merge topic 'add_cmake_find_use_package_registry'Craig Scott2019-07-092-3/+9
|\ \ \ \ | |_|_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | | | | 447a96f590 vim: Update cmake.vim to include the CMAKE_FIND_USE variables 1d00ba9ccf Find: find_package prefers variable CMAKE_FIND_USE_REGISTRY 704e3a2ca8 Find: Correct spelling and layout issues in CMAKE_FIND_USE_ docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3487
| * | | Find: find_package prefers variable CMAKE_FIND_USE_REGISTRYRobert Maynard2019-07-092-2/+8
| | | | | | | | | | | | | | | | | | | | | | | | CMake's find control flags should all have a consistent name. To make this happen we are introducing `CMAKE_FIND_USE_REGISTRY` and deprecating `CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY`.
| * | | Find: Correct spelling and layout issues in CMAKE_FIND_USE_ docsRobert Maynard2019-07-091-1/+1
| | |/ | |/|
* | | Merge topic 'loglevel-option-case-consistency'Craig Scott2019-07-091-2/+2
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 14ed40d670 Help: Use consistent levels for cmake --loglevel and message() Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3521
| * | | Help: Use consistent levels for cmake --loglevel and message()Craig Scott2019-07-081-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The message() command requires uppercase log levels. Even though the cmake --loglevel option is not case sensitive, show the supported values as uppercase to match the message() docs as closely as possible, since they are related to the same feature. Also fixes the wrong string being shown for the warning level by cmake --help.
* | | | Merge topic 'threads-are-good'Brad King2019-07-081-0/+1
|\ \ \ \ | |_|_|/ |/| | | | | | | | | | | | | | | | | | | 08cd7f6a02 Swift: support multithreaded compilation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3506
| * | | Swift: support multithreaded compilationSaleem Abdulrasool2019-07-021-0/+1
| | | | | | | | | | | | | | | | | | | | Query the number of logical CPUs available to enable parallel compilation for Swift.
* | | | Merge topic 'docs-misc-trivial-cleanups'Craig Scott2019-07-041-4/+5
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | d5b722bbbd Help: Remove mention of CMAKE_INSTALL_DO_STRIP ddc7ea4696 Help: Clarify how to provide multiple targets with cmake --target c509f38b7b Help: Add missing xref for CMAKE_EXECUTE_PROCESS_COMMAND_ECHO 9cc6befe1b Help: Improve formatting of list(TRANSFORM) sub-options 074fbdb73f Help: Clean up trivial typos and grammar Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Brad King <brad.king@kitware.com> Merge-request: !3498
| * | | | Help: Remove mention of CMAKE_INSTALL_DO_STRIPCraig Scott2019-07-031-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | It isn't yet clear whether we want to make this part of the documented API for the install script. Remove it from the docs before it appears in an official release for now. Relates: #18997
| * | | | Help: Clarify how to provide multiple targets with cmake --targetCraig Scott2019-07-031-1/+2
| | | | |
| * | | | Help: Clean up trivial typos and grammarCraig Scott2019-07-031-2/+2
| | |/ / | |/| |
* | | | Merge topic 'doc-toolchain-file-CMAKE_SOURCE_DIR'Craig Scott2019-07-031-0/+8
|\ \ \ \ | |_|/ / |/| | | | | | | | | | | | | | | | | | | 16434fe303 Help: Discourage using CMAKE_SOURCE_DIR in toolchain files Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3495
| * | | Help: Discourage using CMAKE_SOURCE_DIR in toolchain filesOleg Chernovskiy2019-07-021-0/+8
| |/ / | | | | | | | | | Fixes: #19390
| * | Merge branch 'capabilities-fileapi' into release-3.15Brad King2019-06-122-0/+18
| |\ \ | | | | | | | | | | | | Merge-request: !3433
* | \ \ Merge topic 'vs-dpi-aware'Brad King2019-06-271-0/+1
|\ \ \ \ | |_|_|/ |/| | | | | | | | | | | | | | | | | | | cd92f8f8bf VS: Add VS_DPI_AWARE target property Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3418
| * | | VS: Add VS_DPI_AWARE target propertyMatt Weir2019-06-261-0/+1
| | | | | | | | | | | | | | | | | | | | Enables setting the visual studio project property for Manifests, controlling the DPI Aware setting.
* | | | Help: Move CMP0095 into CMake 3.16 sectionKyle Edwards2019-06-251-1/+8
| | | | | | | | | | | | | | | | | | | | | | | | CMP0095 was introduced in 3.16, but was mistakenly put in the notes for 3.15. This error was not caught during review. Move it into the notes for 3.16.
* | | | Find: Provide global controls for the `NO_[]_PATH` call optionsRobert Maynard2019-06-211-0/+5
| | | |
* | | | Merge topic 'escape-install-rpath'Kyle Edwards2019-06-171-0/+1
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | 4caefbb423 cmInstallTargetGenerator: Add tests for the RPATH_CHANGE rule 749ce48eb5 cmInstallTargetGenerator: Escape generated OLD_RPATH argument 9e84c7c5e8 cmInstallTargetGenerator: Introduce CMP0095 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3383
| * | | cmInstallTargetGenerator: Introduce CMP0095Dennis Klein2019-06-131-0/+1
| |/ / | | | | | | | | | | | | | | | | | | Escape coincidental CMake syntax in RPATH entries when generating the intermediary cmake_install.cmake script. Fixes #19225
* | | Merge topic 'capabilities-fileapi'Brad King2019-06-122-0/+18
|\ \ \ | |/ / |/| / | |/ | | | | | | | | | | c932f49842 cmake: Teach -E capabilities to report supported fileapi requests 6696855f72 cmake: Simplify implementation of -E capabilities 6b815e58ba fileapi: Factor out helper to construct a version object Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3433
| * cmake: Teach -E capabilities to report supported fileapi requestsBrad King2019-06-072-0/+18
| | | | | | | | Fixes: #19339
* | Help: Move ADDITIONAL_MAKE_CLEAN_FILES dir prop to deprecated sectionCraig Scott2019-06-071-1/+1
|/
* Merge topic 'remove_directories'Brad King2019-06-041-2/+2
|\ | | | | | | | | | | | | | | | | 07a80c7002 cmake: Teach -E remove_directory to remove multiple directories 013bee698e Tests: Add RunCMake.CommandLine make_directory test checks 3eb16de327 Tests: Fix RunCMake.CommandLine make_directory test name Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3411
| * cmake: Teach -E remove_directory to remove multiple directoriesJohn Freeman2019-06-031-2/+2
| | | | | | | | | | The `make_directory` command can make multiple directories in a single invocation. Make `remove_directory` mirror that behavior.
* | Genex: CompileLang and CompileLangAndId now match against a list of idsRobert Maynard2019-06-031-12/+12
| | | | | | | | | | | | This allows for expressions such as: $<COMPILE_LANG_AND_ID, CXX, GNU, Clang>
* | Genex: PlatformId now can match against a list of ids.Robert Maynard2019-06-031-3/+4
| |
* | Genex: CompilerId now can match against a list of ids.Robert Maynard2019-06-031-12/+17
|/ | | | | This allows for expressions like: $<$<CXX_COMPILER_ID:Clang,GNU>:-DMY_PRIVATE_DEFINE>
* Merge topic 'vs-add-package-reference'Brad King2019-05-311-0/+1
|\ | | | | | | | | | | | | | | 42e14d90b1 VS: Added support for VS package references for nuget Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Leonid Pospelov <pospelovlm@yandex.ru> Merge-request: !3389
| * VS: Added support for VS package references for nugetKinan Mahdi2019-05-301-0/+1
| |
* | Merge topic 'tar-zstd-compression'Brad King2019-05-301-5/+8
|\ \ | |/ |/| | | | | | | | | 53cb1f2d04 cmake: Teach cmake -E tar command, Zstandard compression Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3357