summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'fetchcontent-performance'Brad King2021-02-051-0/+13
|\ | | | | | | | | | | | | | | | | | | | | | | 17e5516e60 FetchContent: Invoke steps directly and avoid a separate sub-build 4f3d1abbb4 ExternalProject: Refactor pre-configure steps to support no-target uses 23aab9ecce ExternalProject: Avoid scanning docs for keywords, use include_guard() Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Robert Maynard <robertjmaynard@gmail.com> Acked-by: Michael Hirsch, Ph.D. <michael@scivision.dev> Acked-by: Lars Melchior <lars.melchior@gmail.com> Merge-request: !5749
| * FetchContent: Invoke steps directly and avoid a separate sub-buildCraig Scott2021-02-041-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | The cost of setting up and executing a separate sub-build to do the download, update and patch steps required for FetchContent population can be significant with some platforms and CMake generators. Avoid the sub-build altogether by invoking the step scripts directly. Previously, if no generator was set (e.g. population was being done in script mode), a generator needed to be available on the default PATH. Since we no longer use a sub-build, this restriction is also now gone. Fixes: #21703
| * ExternalProject: Refactor pre-configure steps to support no-target usesCraig Scott2021-02-041-0/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The mkdir, download, update and patch steps are used by FetchContent during the configure phase of the main build. Because these steps need a target, this has so far required a sub-build to be set up. The changes here factor out the preparation of the scripts from the creation of the targets, allowing future work to leverage these steps without a sub-build (see #21703). As part of the refactoring, some rationalisation of the stamp files, repository info files and script names was done to make things more consistent between download methods and step implementations. Every download method now records its own specific repository info in a file and that file is a dependency of the download step. The source directory is also written to that file, so if the SOURCE_DIR changes, the download will be retriggered (the existing implementation fails in this scenario). Each download method now also has just one driver script that implements the whole step (it may pull in other scripts to do its task though). The patch step gained support for USES_TERMINAL as a result of generalising the implementation for custom commands. Fixes: #21748
* | Merge topic 'build-test-presets'Brad King2021-02-055-17/+999
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 9b5289ebd8 Help: Add release note for build and test presets c8a5cd6871 Tests: Update RunCMake/CMakePresets --list-presets 69a5cf23a2 Tests: Update RunCMake/CommandLine BuildDir b500935b94 Tests: Add test preset tests 74a86566f0 Tests: Add build preset tests 56751c83aa Tests: Factor out RunCMake.CMakePresets schema validation 676ecf0d37 cmake-presets: Add build and test presets 4f4f2028b8 Help: Add documentation for buildPresets and testPresets ... Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5681
| * | Help: Add release note for build and test presetsBrad King2021-02-041-0/+4
| | |
| * | Help: Add documentation for buildPresets and testPresetsSam Freed2021-02-013-4/+523
| | |
| * | Help: Add buildPresets and testPresets to JSON schemaSam Freed2021-01-271-13/+472
| | |
* | | Merge topic 'doc-find-env-vars'Brad King2021-02-053-3/+6
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | c40e81ce80 Help: Restore docs that find_library considers LIB, not INCLUDE Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5772
| * | | Help: Restore docs that find_library considers LIB, not INCLUDEBrad King2021-02-043-3/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Documentation updates in commit 02f527c66a (Find: Provide global controls for the `NO_[]_PATH` call options, 2019-06-12, v3.16.0-rc1~541^2) accidentally switched the `find_library` documentation to mention `INCLUDE` where it should be `LIB`. While at it, update `find_file` and `find_path` to mention `INCLUDE` and `PATH` in the order they are considered.
* | | | Merge topic 'aix-xcoff-edit'Brad King2021-02-041-0/+8
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | e017ba046c AIX: Enable XCOFF editing to replace RPATH on installation 56fc4a325f cmXCOFF: Add helper to parse and edit the XCOFF binary format ddaaee907d CMakeDetermineCompilerId: Recognize XCOFF executable format 69e1d95a8a Tests: Add sample XCOFF binaries f79d991dfd Tests: Convert CMake.ELF to RunCMake.file-RPATH ELF case d8f3e68ca9 Ninja Multi-Config: Enable relink diagnostic message cdcfe3eb99 Rename CMAKE_USE_MACH_PARSER to CMake_USE_MACH_PARSER b6071c93f5 Rename CMAKE_USE_ELF_PARSER to CMake_USE_ELF_PARSER Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5769
| * | | | AIX: Enable XCOFF editing to replace RPATH on installationBrad King2021-02-031-0/+8
| | | | | | | | | | | | | | | | | | | | Avoid relinking before installation.
* | | | | Merge topic 'issue-17634'Brad King2021-02-042-0/+12
|\ \ \ \ \ | |/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | 5af38a11ce try_run: Allow to set working directory Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5757
| * | | | try_run: Allow to set working directoryAsit Dhal2021-02-032-0/+12
| | | | | | | | | | | | | | | | | | | | Fixes: #17634
* | | | | Merge topic 'intel-llvm-compilers'Brad King2021-02-031-3/+16
|\ \ \ \ \ | |/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | a552487843 Help: Clarify release note for IntelLLVM compiler support Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5758
| * | | | Help: Clarify release note for IntelLLVM compiler supportBrad King2021-02-021-3/+16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Update the release note added by commit b9f945eccb (Help: Add release note for IntelLLVM compiler support, 2021-01-29) to distinguish between the Intel oneAPI NextGen and Classic compilers. Co-Author: William R. Dieter <william.r.dieter@intel.com> Suggested-by: Michael Hirsch, Ph.D <michael@scivision.dev>
* | | | | Merge topic 'issue-19198'Brad King2021-02-022-1/+14
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 255df8622b file(GENERATE): Support new line style Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Brad King <brad.king@kitware.com> Merge-request: !5649
| * | | | | file(GENERATE): Support new line styleAsit Dhal2021-02-012-1/+14
| |/ / / / | | | | | | | | | | | | | | | Fixes: #19198
* | | | | Merge topic 'doc-user-interaction-ClangCL'Brad King2021-02-021-1/+1
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | c16509907c Help: Update to VS ClangCL toolset in user-interaction example Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5756
| * | | | | Help: Update to VS ClangCL toolset in user-interaction exampleTim Hutton2021-02-011-1/+1
| |/ / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | As of VS 2019 the toolset is now called `ClangCL`. The toolset `LLVM` is no longer supported. Issue: #20415
* | | | | Merge topic 'fix21727_for_FindOpenSSL'Brad King2021-02-021-0/+4
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | bc00cf9300 FindOpenSSL: Add support for version-range Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5750
| * | | | | FindOpenSSL: Add support for version-rangeDeniz Bahadir2021-02-011-0/+4
| |/ / / /
* | | | | Added `SETUID` and `SETGID` to the list of accepted file permissionswilliam.r.dieter2021-01-291-1/+1
|/ / / / | | | | | | | | | | | | Signed-off-by: william.r.dieter <william.r.dieter@intel.com>
* | | | Merge topic 'intel-llvm-compilers'Brad King2021-01-291-0/+6
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | b9f945eccb Help: Add release note for IntelLLVM compiler support Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5748
| * | | | Help: Add release note for IntelLLVM compiler supportBrad King2021-01-291-0/+6
| | |_|/ | |/| | | | | | | | | | | | | | | | | | | | | | This was accidentally left out from commit a90d2a9eed (IntelLLVM: Add support for Intel LLVM-based compilers, 2020-11-02). Issue: #21561
* | | | Merge topic 'cmake_path-stabilization'Craig Scott2021-01-291-70/+49
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | 76cea3dfe2 cmake_path: rename 'GET ... RELATIVE_PATH' to 'GET ... RELATIVE_PART' Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5743
| * | | cmake_path: rename 'GET ... RELATIVE_PATH' to 'GET ... RELATIVE_PART'Marc Chevrier2021-01-281-70/+49
| | |/ | |/| | | | | | | | | | | | | | | | For consistency, subcommand 'HAS_RELATIVE_PATH' is also renamed to 'HAS_RELATIVE_PART'. Fixes: #21385
* | | IntelLLVM: Add support for Intel LLVM-based compilersWilliam R. Dieter2021-01-281-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Using a single ID 'IntelLLVM' for the suite of Intel compilers based on the LLVM backend. The 'IntelLLVM' ID are used for C, C++, and Fortran. Data Parallel C++ will be handled in a separate commit. The C and C++ definitions are based on the Clang definitions. The Intel LLVM-based C and C++ compilers are based on the Clang front end, so existing Clang options are more likely to be a good match than options for the older Intel compilers. Fortran is based on the older Fortran front end with the LLVM backend. It has a similar interface to the older versions, though many options are shared with the C and C++ compilers. Fixes: #21561 Signed-off-by: William R. Dieter <william.r.dieter@intel.com>
* | | NVHPC: Add support for NVIDIA HPC SDK compilers based on PGITin Huynh2021-01-272-0/+5
|/ / | | | | | | | | | | | | Identify the compilers as `NVHPC` to distinguish it from the older PGI compilers from which they evolved, and from other `NVIDIA` compilers. Fixes: #20887
* | Merge topic 'rel-package-names'Brad King2021-01-271-0/+10
|\ \ | | | | | | | | | | | | | | | | | | | | | 2186f8988f Utilities/Release: Rename Windows packages to 'windows-$arch' dc9340dbc4 Utilities/Release: Rename Linux packages to 'linux-$arch' Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5738
| * | Utilities/Release: Rename Windows packages to 'windows-$arch'Brad King2021-01-261-0/+4
| | |
| * | Utilities/Release: Rename Linux packages to 'linux-$arch'Brad King2021-01-251-0/+6
| | |
* | | Merge topic 'outdir-target-genex'Brad King2021-01-271-0/+7
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 64c3857780 OUTPUT_DIRECTORY: Support tgt genex in output artifact vars Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5690
| * | | OUTPUT_DIRECTORY: Support tgt genex in output artifact varsAsit Dhal2021-01-261-0/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Following variables now support target dependent generator expressions. - CMAKE_RUNTIME_OUTPUT_DIRECTORY - CMAKE_LIBRARY_OUTPUT_DIRECTORY - CMAKE_ARCHIVE_OUTPUT_DIRECTORY Fixes: #18055
* | | | Merge topic 'doc-system-processor'Brad King2021-01-271-4/+9
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5a6379f1fd Help: Clarify meaning of CMAKE_SYSTEM_PROCESSOR Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5744
| * | | | Help: Clarify meaning of CMAKE_SYSTEM_PROCESSORBrad King2021-01-261-4/+9
| | |/ / | |/| | | | | | | | | | | | | | | | | | | | | | On Windows the value may not match the compiler's target architecture. Update the documentation to state this explicitly. Issue: #15170
* | | | Merge topic 'cpack-compression-threads'Brad King2021-01-272-0/+8
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | bdf30bdad8 CPack: add CPACK_THREADS variable to control compression threads bcdb5b52a0 libarchive: Fix lzma_stream_encoder_mt detection Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5716
| * | | | CPack: add CPACK_THREADS variable to control compression threadsRodolfo Lima2021-01-262-0/+8
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | This allows setting how many threads the compressor will use. Currently only implemented for XZ when using system's lzma library. Fixes: #21715
* | | | Help: Document that if(EXISTS) does not expand ~Michael Hirsch, Ph.D2021-01-261-3/+4
|/ / / | | | | | | | | | Fixes: #21729
* | | Merge topic 'doc-multi-config-prop'Brad King2021-01-251-2/+6
|\ \ \ | | |/ | |/| | | | | | | | | | | | | | | | 1d7daa668c Help: Add Ninja Multi-Config to list in GENERATOR_IS_MULTI_CONFIG Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Kyle Edwards <kyle.edwards@kitware.com> Merge-request: !5737
| * | Help: Add Ninja Multi-Config to list in GENERATOR_IS_MULTI_CONFIGBrad King2021-01-251-2/+6
| | | | | | | | | | | | Fixes: #21739
* | | Merge topic 'cpack-deb-shlibdeps-private-search-dirs'Brad King2021-01-252-0/+32
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | d586a4ad60 CPackDeb: dpkg-shlibdeps now supports searching for private shared libs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5718
| * | CPackDeb: dpkg-shlibdeps now supports searching for private shared libsDeniz Bahadir2021-01-222-0/+32
| | | | | | | | | | | | | | | | | | | | | | | | | | | The new CPack variable `CPACK_DEBIAN_PACKAGE_SHLIBDEPS_PRIVATE_DIRS` can be set to a list of directories. If `CPACK_DEBIAN_PACKAGE_SHLIBDEPS` or `CPACK_DEBIAN_<component>_PACKAGE_SHLIBDEPS` are set to `ON` these directories will be searched by `dpkg-shlibdeps` in order to find private shared library dependencies of the libraries/executables that shall be packed.
* | | Merge topic 'doc-xcode-attr'Craig Scott2021-01-242-3/+15
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 3c80666f00 Help: Document intended purpose of XCODE_ATTRIBUTE_<an-attribute> Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5726
| * | | Help: Document intended purpose of XCODE_ATTRIBUTE_<an-attribute>Brad King2021-01-222-3/+15
| | | | | | | | | | | | | | | | | | | | | | | | Also warn the reader against setting values CMake normally generates. Issue: #21728
* | | | UseSWIG: use swig tool to generate dependenciesMarc Chevrier2021-01-211-0/+6
|/ / / | | | | | | | | | | | | | | | add_custom_command() supports option DEPFILE when generator is Makefiles or Ninja. And swig tool is able to generate a dependencies file which is compatible with DEPFILE option.
* | | Merge topic 'vs-sdk-selection'Brad King2021-01-212-1/+9
|\ \ \ | | |/ | |/| | | | | | | | | | | | | 1e67482daf VS: Generalize Win10 max SDK version to all VS generators Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5721
| * | VS: Generalize Win10 max SDK version to all VS generatorsjonathan molinatto2021-01-202-1/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The `CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM` variable added in CMake 3.19 by commit ba497111f6 (VS: Add option for custom Win10 SDK version maximum, 2020-08-20, v3.19.0-rc1~262^2) was documented as if it worked for all generators but implemented only to override CMake's builtin default for the VS 2015 max SDK version. Generalize the variable to set a custom max SDK version for later VS versions too. Fixes: #21720
* | | Help: Convert genex documentation to sphinx domain objectsBrad King2021-01-181-102/+282
| | | | | | | | | | | | This makes them linkable, indexed, and enables cross-references.
* | | Help: Remove extra blank line from cmake-generator-expressions(7)Brad King2021-01-181-1/+0
| | |
* | | Utilities/Sphinx: Add role and directive for 'genex' in CMake domainBrad King2021-01-181-2/+13
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This enables cross-reference syntax for CMake generator expressions: :genex:`SOME_GENEX` :genex:`$<SOME_GENEX>` :genex:`$<SOME_GENEX:...>` and definition of CMake generator expressions via a directive: .. genex:: SOME_GENEX .. genex:: $<SOME_GENEX> .. genex:: $<SOME_GENEX:...> It also adds generator expressions defined by the directive and by `Help/genex/SOME_GENEX.rst` documents to the index.