summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge branch 'backport-3.16-automoc-path-prefix-off'Brad King2020-08-102-4/+3
|\
| * Autogen: Turn off moc path prefix generation by defaultJoerg Bornemann2020-08-102-4/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Change the default value of `CMAKE_AUTOMOC_PATH_PREFIX` to `OFF` to restore compatibility with behavior of CMake 3.15 and below. C++ source files that are generated by Qt's meta object compiler (moc) include the header file that was passed as input argument to moc. This is usually a path relative to the source directory, for example #include "../../source/dir/myobject.h" That is problematic for reproducible builds as described in #18815. To cope with that, the target property AUTOMOC_PATH_PREFIX was introduced in CMake 3.16 by commit d018d27c10 (Autogen: Add moc path prefix generation (AUTOMOC_PATH_PREFIX), 2019-09-13, v3.16.0-rc1~94^2~4). The property is default-initialized from the variable `CMAKE_AUTOMOC_PATH_PREFIX`, which defaults to `ON`. If this property is ON, and myobject.h is located in an include directory of the target, moc-generated C++ files include the file without the "path prefix": #include "myobject.h" This behavior, however, can break projects that have equally named header files in different include directories. As "not breaking existing projects" trumps "have reproducible builds by default" we change the default of `CMAKE_AUTOMOC_PATH_PREFIX` to `OFF`. Also, it is now possible to pass `-DCMAKE_AUTOMOC_PATH_PREFIX=ON` on the CMake command line. Before, it was overridden in `CMakeGenericSystem`. Fixes: #20598 Issue: #18815
* | Help: clarify add_definitions() and add_compile_definitions() behaviorMarc Chevrier2020-05-242-7/+9
| | | | | | | | Fixes: #20736
* | CUDA: Compute CMAKE_CUDA_RUNTIME_LIBRARY default from toolchainRobert Maynard2020-05-212-3/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since commit 0d0145138f (CUDA: Add abstraction for cuda runtime selection, 2019-11-29, v3.17.0-rc1~83^2) we add CUDA runtime library selection flags by default. To maintain backwards compatibility the default CUDA runtime library needs to be computed based on what libraries are found on the initial compiler invocation. For example a toolchain could establish initial flags that have all CUDA compilations using the runtime version, and if we don't detect this we will try to link to both the static and shared runtime. Co-Author: Brad King <brad.king@kitware.com> Fixes: #20708
* | CUDA: Propagate CMAKE_CUDA_RUNTIME_LIBRARY state to try_compileRobert Maynard2020-05-201-0/+1
| |
* | Help: Correct CMAKE_CUDA_RUNTIME_LIBRARY applicabilityRobert Maynard2020-05-201-1/+1
| |
* | Merge topic 'backport-3.16-FindPkgConfig-isystem' into release-3.17Brad King2020-05-151-0/+6
|\ \ | |/ | | | | | | | | | | 3719ddd3f3 Help: Add 3.16.7 release note for FindPkgConfig '-isystem' fix Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4752
| * Help: Add 3.16.7 release note for FindPkgConfig '-isystem' fixBrad King2020-05-151-0/+6
| | | | | | | | | | Add a release note for the change in commit 4d446c68d1 (FindPkgConfig: also handle "-isystem" prefixes for include directories, 2020-04-30).
| * Merge branch 'backport-3.16-objc-env-vars' into release-3.16Brad King2020-05-144-0/+37
| |\
* | | Help: Add 3.17.3 release note for Objective C/C++ compiler selectionBrad King2020-05-141-0/+4
| | | | | | | | | | | | Port the 3.16.7 release note for 3.17.3 too.
* | | Merge branch 'backport-3.16-objc-env-vars' into objc-env-varsBrad King2020-05-144-0/+37
|\ \ \ | | |/ | |/|
| * | Objective C/C++: Honor CC and CXX env vars to select compilerBrad King2020-05-143-0/+13
| | | | | | | | | | | | | | | | | | | | | If the `OBJC` or `OBJCXX` environment variable is not set to specify an Objective C or C++ compiler, check `CC` or `CXX` too. Fixes: #20703
| * | Help: Document OBJC and OBJCXX env vars for Objective C/C++ compilersBrad King2020-05-143-0/+24
| | |
* | | Help: Add 3.17 release note for FindPkgConfig '-isystem' fixBrad King2020-05-061-0/+9
| | |
* | | Merge topic 'pch-genex-absolute' into release-3.17Brad King2020-04-281-14/+13
|\ \ \ | | |/ | |/| | | | | | | | | | | | | | | | b204bae261 target_precompile_headers: Fix documented example using genex Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Cristian Adam <cristian.adam@gmail.com> Merge-request: !4678
| * | target_precompile_headers: Fix documented example using genexBrad King2020-04-271-14/+13
| |/ | | | | | | | | | | | | | | When the path to a header file is specified using a generator expression, evaluation of the genex must produce an absolute path. Update our documented example and add a test covering the case. Fixes: #20617
| * Merge branch 'doc-3.15-std-fix' into release-3.16Brad King2020-04-061-0/+9
| |\ | | | | | | | | | Merge-request: !4574
* | \ Merge topic 'ninja-fortran-doc' into release-3.17Brad King2020-04-201-5/+1
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | fa31c195b8 Ninja: Document that Fortran support is available with Ninja 1.10+ Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4626
| * | | Ninja: Document that Fortran support is available with Ninja 1.10+Brad King2020-04-171-5/+1
| | | | | | | | | | | | | | | | | | | | | | | | Ninja 1.10 was released in Jan 2020 and has the features we need to support Fortran. Replace documentation that mentions Kitware's branch with mention of Ninja 1.10+ instead.
* | | | Merge topic 'docs-CMAKE_CURRENT_FUNCTION' into release-3.17Craig Scott2020-04-115-25/+46
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 10ee9611f0 Help: Improve wording of CMAKE_CURRENT_FUNCTION_LIST_DIR docs 22fbc404a7 Help: Add cross-references for CMAKE_CURRENT_FUNCTION* docs d2b139687a Help: Minor grammar cleanups of CMAKE_CURRENT_FUNCTION* docs Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Brad King <brad.king@kitware.com> Acked-by: Alex Turbov <i.zaufi@gmail.com> Merge-request: !4595
| * | | | Help: Improve wording of CMAKE_CURRENT_FUNCTION_LIST_DIR docsCraig Scott2020-04-101-20/+28
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The original wording was somewhat confusing in talking about rendering of templates. While technically correct, a less experienced user may not know that terminology. The wording has been updated to more clearly describe the example usage. The old way of implementing the example is not "bad", it was the only way to do things before the CMAKE_CURRENT_FUNCTION_LIST_DIR variable was added. The example has been updated to remove the Bad/Good captions to reflect this. Indentation of the examples was also fixed to make them conform to the guidelines.
| * | | | Help: Add cross-references for CMAKE_CURRENT_FUNCTION* docsCraig Scott2020-04-103-0/+12
| | | | |
| * | | | Help: Minor grammar cleanups of CMAKE_CURRENT_FUNCTION* docsCraig Scott2020-04-105-5/+6
| |/ / /
* | | | Help: Fix unescaped asterisks in docs for SKIP_PRECOMPILE_HEADERSCraig Scott2020-04-101-2/+2
|/ / /
* | | Merge topic 'doc-3.15-std-fix' into release-3.17Brad King2020-04-061-0/+9
|\ \ \ | | |/ | |/| | | | | | | | | | | | | 182a104478 Help: Add 3.15 release note for change in -std= flag for compile features Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4574
| * | Help: Add 3.15 release note for change in -std= flag for compile featuresBrad King2020-04-061-0/+9
| | | | | | | | | | | | Issue: #19917
* | | Help: Improve discoverability of CMAKE_FIND_DEBUG_MODECraig Scott2020-04-041-1/+3
| | |
* | | Help: Fix CMAKE_FIND_DEBUG_MODE list formattingCraig Scott2020-04-041-0/+1
| | |
* | | Merge topic 'cpack-nsis-version' into release-3.17Brad King2020-04-012-1/+17
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | aa78a2537c CPack/NSIS: Document and check requirement of at least NSIS 3.0 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4552
| * | | CPack/NSIS: Document and check requirement of at least NSIS 3.0Brad King2020-03-312-1/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since commit 9d2816544e (CPack/NSIS: Also preload the "UserInfo.dll" plugin, 2020-01-04, v3.17.0-rc1~204^2) we require NSIS 3.0. Since older versions do not support Windows 8 or above, we can now require at least version 3.0. Fixes: #20514
* | | | Merge topic 'docs_macho_prop_tgt' into release-3.17Brad King2020-03-314-26/+65
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 01b47293ea Help: Fix inaccuracies and omissions in MACHO_* property docs Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Isuru Fernando <isuruf@gmail.com> Merge-request: !4542
| * | | | Help: Fix inaccuracies and omissions in MACHO_* property docsCraig Scott2020-03-314-26/+65
| |/ / / | | | | | | | | | | | | | | | | | | | | The VERSION and SOVERSION properties are not true fallbacks for the MACHO_* properties since the MACHO_* properties only affect the embedded version information, but VERSION and SOVERSION also affect other things.
* | | | Merge topic 'docs-xcode-gen-scheme-workdir' into release-3.17Brad King2020-03-303-4/+5
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6905451e11 Help: Add missing XCODE_SCHEME_WORKING_DIRECTORY 6ff07dac76 Help: Minor typos and formatting for XCODE_SCHEME_WORKING_DIRECTORY Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4543
| * | | | Help: Add missing XCODE_SCHEME_WORKING_DIRECTORYCraig Scott2020-03-291-0/+1
| | | | |
| * | | | Help: Minor typos and formatting for XCODE_SCHEME_WORKING_DIRECTORYCraig Scott2020-03-292-4/+4
| |/ / /
* | | | Help: Move Ninja Multi-Config variable details into their respective pagesKyle Edwards2020-03-264-43/+35
| | | |
* | | | Help: Fixed typo in CMAKE_INSTALL_RPATH_USE_LINK_PATH.rstJaak Ristioja2020-03-231-1/+1
|/ / / | | | | | | | | | Signed-off-by: Jaak Ristioja <jaak@ristioja.ee>
* | | Help: Fix documentation of --trace-format parameterKyle Edwards2020-03-181-1/+1
| | |
* | | Help: Expand discussion of GENERATED / BYPRODUCTSFeRD (Frank Dana)2020-03-123-10/+29
| | | | | | | | | | | | | | | | | | | | | | | | - Mention the Makefile Generators' `make clean` removal in the BYPRODUCTS section of add_custom_command and add_custom_target - Expand the GENERATED property docs' description of which files will be marked with the property, and of what it implies (including `make clean` removal)
* | | Help: Add missing word in AUTOGEN_TARGET_DEPENDS.rstFeRD (Frank Dana)2020-03-121-1/+1
| | |
* | | Merge topic 'rename-macho-version-properties' into release-3.17Craig Scott2020-03-128-37/+37
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 14732d3f30 macOS: Rename OSX_*_VERSION properties to MACHO_*_VERSION Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4452
| * | | macOS: Rename OSX_*_VERSION properties to MACHO_*_VERSIONBrad King2020-03-128-37/+37
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The properties added by commit 4a62e3d97c (macOS: Add OSX_COMPATIBILITY_VERSION and OSX_CURRENT_VERSION properties, 2020-01-24, v3.17.0-rc1~80^2~1) are general-purpose for all platforms using Mach-O formats and not just on OS X. Rename them accordingly. The properties are new to the CMake 3.17 release so we can rename them without compatibility concerns. Fixes: #20442
* | | | Merge topic 'release-notes-minor-cleanups' into release-3.17Brad King2020-03-101-13/+13
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | d5e6fedd7b Help: Cleanup minor typos and grammar in 3.17 release notes Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4449
| * | | | Help: Cleanup minor typos and grammar in 3.17 release notesCraig Scott2020-03-101-13/+13
| | | | |
* | | | | Merge topic 'doc-3.17-relnotes' into release-3.17Brad King2020-03-103-6/+9
|\ \ \ \ \ | |/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6b925d0536 Help: Fix 3.17 release notes for Xcode scheme settings e0409b8bca Help: Fix toctree order of Xcode scheme variable and property Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4447
| * | | | Help: Fix 3.17 release notes for Xcode scheme settingsBrad King2020-03-101-4/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In commit 730a53ef1d (Help: Organize and revise 3.17 release notes, 2020-02-04, v3.17.0-rc1~21^2) we accidentally combined the release notes for `CMAKE_XCODE_SCHEME_ENVIRONMENT` and `XCODE_SCHEME_WORKING_DIRECTORY`. Split them up again. Also mention `CMAKE_XCODE_SCHEME_WORKING_DIRECTORY`. Fixes: #20439
| * | | | Help: Fix toctree order of Xcode scheme variable and propertyBrad King2020-03-102-2/+2
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | In commit 92c4c852db (Xcode: Add custom working directory property, 2019-11-18, v3.17.0-rc1~400^2) the toctree links to the new properties were not added in sorted order. Move them. Issue: #20439
* | | | Merge topic 'doc-add_custom_command-depends' into release-3.17Brad King2020-03-061-14/+30
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 785f2b2df1 Help: Clarify add_custom_command DEPENDS conversion to file paths Acked-by: Kitware Robot <kwrobot@kitware.com> Reviewed-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !4434
| * | | | Help: Clarify add_custom_command DEPENDS conversion to file pathsBrad King2020-03-061-14/+30
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In commit f5126badd8 (add_custom_command: convert DEPENDS path arguments to absolute paths, 2019-12-18, v3.17.0-rc1~263^2) we updated the documentation to describe the behavior introduced by that commit. However, the behavior was removed again by commit fd0ba705ce (add_custom_command: check if a relative path should be an in-source path, 2020-01-09, v3.17.0-rc1~141^2~4) without updating the documentation. Update the documentation again to describe the behavior as of the latter commit. Spell out the steps that `cmLocalGenerator::GetRealDependency` and `cmTargetTraceDependencies::IsUtility` use to add file-level and target-level dependencies.
* | | | Merge topic 'doc-rel-3.16-updates' into release-3.17Brad King2020-03-041-0/+26
|\ \ \ \ | | |_|/ | |/| | | | | | | | | | | | | | | | | | d25d8e9eef Help: Update CMake 3.16 release notes for 3.16.5 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4425