summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'clang-gnulike-support'Brad King2019-07-2512-12/+24
|\ | | | | | | | | | | | | | | | | | | | | a4657ef670 Merge branch 'backport-clang-gnulike-support' into clang-gnulike-support 161b33f12b Help/guide/tutorial: Revert "require C++14 for the Tutorial" 4f15a6a5c2 Tests: Revert "require C++14 for the Tutorial" 5cfc39127e Merge branch 'backport-clang-gnulike-support' into clang-gnulike-support d50b31be35 Clang: For MSVC ABI do not use modes older than C++14 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3592
| * Help/guide/tutorial: Revert "require C++14 for the Tutorial"Brad King2019-07-2412-12/+24
| | | | | | | | | | | | | | | | | | | | Revert the changes from commit a2a90f41e3 (Tests: require C++14 for the Tutorial, 2019-03-21, v3.15.0-rc1~41^2~2) for the content in its new home. In commit d50b31be35 (Clang: For MSVC ABI do not use modes older than C++14, 2019-07-23) we fixed the C++ standard selection for GNU-like Clang with the MSVC ABI so the test code itself no longer needs to do it. In particular, changing the tests in this way broke the tutorial's narrative.
* | FindPackage: Support `NO_[]_PATH` global call optionsRobert Maynard2019-07-227-12/+17
|/
* Merge topic 'tutorial_reference_cmake_install_command'Brad King2019-07-221-6/+8
|\ | | | | | | | | | | | | c94e62c07e Tutorial: Updated to reference using cmake --install Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3572
| * Tutorial: Updated to reference using cmake --installRobert Maynard2019-07-191-6/+8
| | | | | | | | | | This is preferred over using `make install` as it allows for control over the install location, configuration, and component.
* | Merge topic 'doc-string-multibyte'Brad King2019-07-221-81/+94
|\ \ | | | | | | | | | | | | | | | | | | | | | b97673f54b Help: Add note to each string() subcommand that assumes ASCII input 26cd64d977 Help: Fix language and formatting inconsistencies for string() command Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3559
| * | Help: Add note to each string() subcommand that assumes ASCII inputCraig Scott2019-07-191-1/+10
| | | | | | | | | Fixes: #19465
| * | Help: Fix language and formatting inconsistencies for string() commandCraig Scott2019-07-191-81/+85
| | |
* | | Merge topic 'cpack-install-scripts'Craig Scott2019-07-223-9/+5
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 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-213-9/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-224-0/+41
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-214-0/+41
| | | | |
* | | | | Merge topic 'skip_regular_expression'Kyle Edwards2019-07-195-2/+33
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5dbd9c8583 Vim: Add SKIP_REGULAR_EXPRESSION test property to vim syntax file 407dd1a910 Help: Add documentation for SKIP_REGULAR_EXPRESSION test property d7955d4e5d Tests: Create test for SKIP_REGULAR_EXPRESSION test property 4f1dec86a5 CTest: Add SKIP_REGULAR_EXPRESSION test property Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3570
| * | | | | Help: Add documentation for SKIP_REGULAR_EXPRESSION test propertyGabor Bencze2019-07-185-2/+33
| | |_|_|/ | |/| | |
* | | | | Merge topic 'msvc-runtime-library-doc'Brad King2019-07-193-1/+11
|\ \ \ \ \ | |/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | 282d9f3168 MSVC: Document behavior when MSVC_RUNTIME_LIBRARY is not set Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3573
| * | | | MSVC: Document behavior when MSVC_RUNTIME_LIBRARY is not setBrad King2019-07-193-1/+11
| | | | | | | | | | | | | | | | | | | | | | | | | By default `CMAKE_MSVC_RUNTIME_LIBRARY` is not set. Document the default runtime library selection in that case. We already test it.
| * | | | Merge branch 'FindBISON-CMP0088-SourcePath' into release-3.15Brad King2019-07-121-0/+8
| |\ \ \ \ | | | | | | | | | | | | | | | | | | Merge-request: !3549
* | | | | | AIX: Do not enable runtime linking by default anymoreBrad King2019-07-171-0/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | We've long created shared objects on AIX using the linker's `-G` option (also offered by the XL front-end). The `-G` option implies `-brtl` and enables runtime linking. This has been largely unnecessary because we provide all dependencies on the link line and both XL and GNU compilers offer builtin behavior to export symbols. Since commit 0f150b69d3 (AIX: Explicitly compute shared object exports for both XL and GNU, 2019-07-11) we compute exports explicitly and consistently. Therefore runtime linking is no longer necessary for shared objects. We've also long created executables on AIX using the linker's `-brtl` option to enable runtime linking in case they load plugins at runtime. Since commit 9f5c2040bf (AIX: Explicitly compute executable exports for both XL and GNU, 2019-07-12) and commit 2fa920c0cd (AIX: Create import library for executables with exports, 2019-07-16) we now provide the linker enough information to fully resolve symbols in plugins up front. Therefore runtime linking is no longer necessary for executables. Drop use of `-G` for creating shared objects and use the XL `-qmkshrobj` and GCC `-shared` options instead. Both invoke the linker with the `-bM:SRE -bnoentry` options to create a shared object without runtime linking enabled. Also drop use of `-brtl` for creating executables. Issue: #19163
* | | | | | Merge topic 'aix-exe-implib'Brad King2019-07-175-2/+24
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-165-2/+24
| | |_|/ / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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 'cmake-qch-no-version-in-filename'Brad King2019-07-171-0/+8
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 0518e675ea CMake.qch: Don't include the version in the file name Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3558
| * | | | | | CMake.qch: Don't include the version in the file nameCraig Scott2019-07-171-0/+8
| | |_|_|_|/ | |/| | | | | | | | | | Fixes: #19374
* | | | | | Merge topic 'project-version-0'Brad King2019-07-173-0/+31
|\ \ \ \ \ \ | |_|/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-163-0/+31
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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>
* | | | | | Help: Clarify ENABLE_EXPORTS per-platform link behaviorBrad King2019-07-161-9/+14
| | | | | | | | | | | | | | | | | | | | | | | | Spell out the behavior on each platform in a bullet list.
* | | | | | Help: Simplify CMAKE_ENABLE_EXPORTS documentationBrad King2019-07-161-18/+4
| |/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | In real projects the variable form should rarely be used because the decision to export symbols from an executable is very specific. Remove its main description, which duplicates the `ENABLE_EXPORTS` target property, and simply reference the property instead.
* | | | | Merge topic 'FindBISON-CMP0088-SourcePath'Brad King2019-07-151-0/+8
|\ \ \ \ \ | | |_|/ / | |/| | | | | | | | | | | | | | | | | | | | | | | f84d2045e9 FindBISON: Fix CMP0088 NEW behavior for non-absolute input paths Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3549
| * | | | FindBISON: Fix CMP0088 NEW behavior for non-absolute input pathsBrian Carlson2019-07-121-0/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Now that the working directory is in the build tree, relative input paths must be converted to an absolute path to remain relative to the source directory. Fixes: #19472
* | | | | Merge topic 'cmake-e-true-false'Brad King2019-07-122-0/+11
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-112-0/+11
| | | | | |
* | | | | | Merge topic 'ctest_make_program__propagated_to_cmake_configure_pass'Brad King2019-07-122-1/+8
|\ \ \ \ \ \ | |/ / / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-112-1/+8
| | | | | |
* | | | | | Merge topic 'eclipse-resource-encoding'Brad King2019-07-113-0/+13
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-093-0/+13
| | |_|/ / / | |/| | | |
* | | | | | Merge topic 'docs-file-GLOB-case-sensitivity'Craig Scott2019-07-111-0/+5
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | c65f296960 Help: Mention file(GLOB)'s case-sensitivity Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3516
| * | | | | | Help: Mention file(GLOB)'s case-sensitivitySteve Mokris2019-07-101-0/+5
| |/ / / / / | | | | | | | | | | | | | | | | | | Based on the KWSYS_GLOB_CASE_INDEPENDENT flag in `Source/kwsys/Glob.cxx`.
* | | | | | Merge topic 'docs-message-cmake-gui'Craig Scott2019-07-101-6/+6
|\ \ \ \ \ \ | | |_|_|/ / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | 42a9e61056 message() help: Clarify how logs are displayed in various tools Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3523
| * | | | | message() help: Clarify how logs are displayed in various toolsFrank Dana2019-07-091-6/+6
| | | | | |
| * | | | | Merge branch 'loglevel-option-case-consistency' into release-3.15Craig Scott2019-07-091-2/+2
| |\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | Merge-request: !3521
| * \ \ \ \ \ Merge branch 'docs-misc-trivial-cleanups' into release-3.15Craig Scott2019-07-045-39/+39
| |\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | Merge-request: !3498
* | \ \ \ \ \ \ Merge topic 'add_cmake_find_use_package_registry'Craig Scott2019-07-0914-44/+148
|\ \ \ \ \ \ \ \ | |_|_|_|_|_|_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-0911-7/+71
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-099-38/+78
| | | | | | | |
* | | | | | | | 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 'doc-SKIP_RETURN_CODE-range'Craig Scott2019-07-091-1/+2
|\ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 365ee32db8 Help: Valid range for test property, SKIP_RETURN_CODE, is 0 to 255, inclusive Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3507
| * | | | | | | | Help: Valid range for test property, SKIP_RETURN_CODE, is 0 to 255, inclusiveStephen Manz2019-07-021-1/+2
| | | | | | | | |
* | | | | | | | | Merge topic 'threads-are-good'Brad King2019-07-082-0/+9
|\ \ \ \ \ \ \ \ \ | |_|_|_|_|_|/ / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 08cd7f6a02 Swift: support multithreaded compilation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3506
| * | | | | | | | Swift: support multithreaded compilationSaleem Abdulrasool2019-07-022-0/+9
| |/ / / / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Query the number of logical CPUs available to enable parallel compilation for Swift.
* | | | | | | | Merge topic 'docs-misc-trivial-cleanups'Craig Scott2019-07-045-39/+39
|\ \ \ \ \ \ \ \ | | |_|_|_|/ / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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