summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Help: Add AUTOMOC_MOC_OPTIONS exampleOrkun Tokdemir2023-05-311-0/+36
|
* Merge topic 'cmake-verbose-print-build-tool-command'Brad King2023-05-311-0/+5
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 8451a3f0b5 cmGlobalGenerator: use a stream for output in `Build` e060666531 cmake: write the build command itself with `--verbose` b017c9f127 cmGlobalGenerator: fix off-by-one for `&&` command joining c715fd8d76 cmGlobalGenerator: quote commands in `::Build` output d6c0e827bc cmGlobalGenerator: add a `QuotedPrintable` method for commands 28ee3bef34 cmGlobalGenerator: add missing spaces in output 465ab8d872 cmGlobalGenerator: use `cmStrCat` in `::Build` 81d45dabc4 cmOutputConverter: add a `static` version of `EscapeForShell` Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Acked-by: Alex <leha-bot@yandex.ru> Merge-request: !8183
| * cmake: write the build command itself with `--verbose`Ben Boeckel2023-05-161-0/+5
| |
* | Merge topic 'help-importing-exporting-lib'Brad King2023-05-311-4/+5
|\ \ | | | | | | | | | | | | | | | | | | | | | aef057d0e8 Help/guide: fix MathFunctionsTargets.cmake path in importing-exporting Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !8511
| * | Help/guide: fix MathFunctionsTargets.cmake path in importing-exportingOlivier Blin2023-05-261-4/+5
| | | | | | | | | | | | | | | | | | | | | It is using ${CMAKE_INSTALL_LIBDIR} and an extra "/MathFunctions" path suffix since these commits: - e58a76de51 Help/guide: fix importing-exporting CMake install destinations - 26cf661b64 Help/guide: use GNUInstallDirs in importing-exporting example
* | | cmake: Add debuggerGlen Chung2023-05-302-0/+58
|/ / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | - Depends on cppdap and jsoncpp. - Add --debugger argument to enable the Debugger. - Add --debugger-pipe argument for DAP traffics over named pipes. - Support breakpoints by filenames and line numbers. - Support exception breakpoints. - Call stack shows filenames and line numbers. - Show Cache Variables. - Show the state of currently defined targets, tests and directories with their properties. - Add cmakeVersion to DAP initialize response. - Include unit tests. Co-authored-by: Ben McMorran <bemcmorr@microsoft.com>
* | Optionally exclude implicit link directories via environmentBrad King2023-05-253-1/+20
| | | | | | | | | | | | | | | | A misconfigured compiler may pass extraneous implicit link directories to its linker. If they are in `CMAKE_<LANG>_IMPLICIT_LINK_DIRECTORIES`, CMake may generate extra `-L` flags on mixed-language link lines that break linking. Add an environment variable that users can set to work around such misconfiguration of their compilers.
* | Merge topic 'ep-update-disconnected'Brad King2023-05-231-0/+14
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | 8cc45e150a ExternalProject: Make hg download method respect UPDATE_DISCONNECTED 1512dc43cb ExternalProject: Avoid reconfigure when updates are disconnected 1d29cf37a1 Tests: Reduce warning noise in ExternalProjectUpdate test Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8498
| * | ExternalProject: Avoid reconfigure when updates are disconnectedCraig Scott2023-05-231-0/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When UPDATE_DISCONNECTED is true, create separate update_disconnected and patch_disconnected targets which have ALWAYS set to false. Make the configure step depend on patch_disconnected in this case too. This ensures the configure, build, install and test steps are not executed unnecessarily when updates are disconnected. Make the update and patch commands depend on the details of those steps. This ensures they are re-executed when any of those details change, even if updates are disconnected. Allow updates to occur even if UPDATE_DISCONNECTED is true, but don't contact the remote in that case. If asked to update to a ref that isn't known locally, that is now detected and causes a fatal error when updates are disconnected. Previously, the build would have silently and erroneously continued to use the old ref. Fixes: #16419, #19703, #21146
* | | Merge topic 'help_configure_file'Brad King2023-05-231-4/+4
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | b2b97d015e Help: configure_file: add $CACHE{VAR} and $ENV{VAR} to description Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8500
| * | | Help: configure_file: add $CACHE{VAR} and $ENV{VAR} to descriptionTorsten Rasmussen2023-05-221-4/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The configure_file(...) and string(CONFIGURE ...) functions also substitutes variables of the form: $CACHE{VAR} and $ENV{VAR}. Therefore add this information to the help documentation so that this behavior is described to users
* | | | codespell: Fix typosBrad King2023-05-221-1/+1
|/ / /
* | | Merge topic 'doc-mingw-var'Brad King2023-05-221-2/+3
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | c16f5914f3 Help: Clarify meaning of MINGW variable Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8495
| * | | Help: Clarify meaning of MINGW variableBrad King2023-05-191-2/+3
| |/ / | | | | | | | | | Fixes: #24928
* | | Merge topic 'FileAPI-framework'Brad King2023-05-222-1/+30
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | b3a6a11e95 fileapi: Extend codemodel targets/compileGroups with Apple frameworks Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !8489
| * | fileapi: Extend codemodel targets/compileGroups with Apple frameworksMarc Chevrier2023-05-192-1/+30
| | | | | | | | | | | | Fixes: #19897
* | | Merge topic 'doc-skip-linting'Brad King2023-05-196-33/+41
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 652a785311 Help: Wording, formatting and ordering fixes for SKIP_LINTING docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8493
| * | | Help: Wording, formatting and ordering fixes for SKIP_LINTING docsCraig Scott2023-05-196-33/+41
| | | | | | | | | | | | | | | | | | | | Amends b480315e0c2 (TargetGenerator: Add SKIP_LINTING source property, 2023-05-12).
* | | | Help: Clarify PRE_BUILD option for add_custom_command()Craig Scott2023-05-191-3/+6
|/ / / | | | | | | | | | Fixes: #24889
* | | Merge branch 'release-3.26'Brad King2023-05-181-2/+2
|\ \ \
| * | | CMake 3.26.4v3.26.4Brad King2023-05-181-2/+2
| | | |
* | | | Merge topic 'skip-linting'Brad King2023-05-187-0/+75
|\ \ \ \ | |_|/ / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 775c369420 Autogen: set SKIP_LINTING ON for generated files b480315e0c TargetGenerator: Add SKIP_LINTING source property 993dde925f TargetGenerator: Factor out generation of code check rules 023af4ab2f Improve Const Correctness Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8467
| * | | TargetGenerator: Add SKIP_LINTING source propertyOrkun Tokdemir2023-05-167-0/+75
| | | | | | | | | | | | | | | | | | | | | | | | | | | | The `SKIP_LINTING` source property was added to disable code check for desired source files. The `SKIP_LINTING`includes `cpplint`, `clang-tidy`, \ `cppcheck` and `include-what-you-use`. If `SKIP_LINTING` is set on a source file, the tools mentioned above will not be run on that source file.
* | | | Help: Update SYSTEM oriented target properties for Apple FrameworksMarc Chevrier2023-05-143-12/+19
| |_|/ |/| | | | | | | | This is a complement to !8469.
* | | Apple Frameworks: honor SYSTEM target propertyMarc Chevrier2023-05-111-0/+4
|/ / | | | | | | Fixes: #24109
* | Merge topic 'ctest-timeout-zero'Brad King2023-05-051-0/+3
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 0a5aeaf302 cmCTestRunTest: Consolidate test timeout selection logic 426e38cc10 cmCTestRunTest: Adopt decision for starting cmProcess timer 59336b29bd cmCTestRunTest: Remove unnecessary arguments to ForkProcess 07b5087ba7 Help: Document meaning of TIMEOUT test property with value 0 3edf7fbb41 ctest: Fix TIMEOUT test property with value 0 with --timeout flag 39a20a56dd Tests: Move `CTestTestZeroTimeout` into `RunCMake.CTestTimeout` cd4038fe94 cmCTestTestHandler: Use in-class initialization of properties and results Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8455
| * | Help: Document meaning of TIMEOUT test property with value 0Brad King2023-05-041-0/+3
| | | | | | | | | | | | | | | Document the behavior added by commit 51bb493574 (Test TIMEOUT property explicitly set to zero should be honored, 2011-01-03, v2.8.4~118^2).
* | | Merge topic 'compile-only-genex'Brad King2023-05-052-1/+26
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | | | | c42630ee62 cmGeneratorExpressionNode: implement `COMPILE_ONLY` genex 0fb923c460 cmGeneratorExpressionNode: implement `COMPILE_ONLY` genex Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !8411
| * | cmGeneratorExpressionNode: implement `COMPILE_ONLY` genexRobert Maynard2023-05-041-5/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | This generator expression is the inverse of `LINK_ONLY` and only coveys usage requirements for the purposes of compilation. Its intended use is to avoid needing to export targets that do not have link usage requirements (e.g., header-only libraries) when used by another target. See: #15415
| * | cmGeneratorExpressionNode: implement `COMPILE_ONLY` genexBen Boeckel2023-04-122-1/+23
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This generator expression is the inverse of `LINK_ONLY` and only coveys usage requirements for the purposes of compilation. Its intended use is to avoid needing to export targets that do not have link usage requirements (e.g., header-only libraries) when used by another target. It will also be used to represent private usage requirements on exported C++ module-containing targets in the future. Eventually there should be logic to collapse nesting of `$<COMPILE_ONLY>` and `$<LINK_ONLY>` when generating instances of either. A TODO is left in the code for this case. See: #15415
* | | Merge topic 'use-linker-depfile'Brad King2023-05-043-0/+24
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 375e6fdbbe Link step: use linker dependency linker file 24a3e5cda0 cmLocalGenerator::MayBeRelativeToWorkDir: take care of all cases Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8443
| * | | Link step: use linker dependency linker fileMarc Chevrier2023-05-033-0/+24
| | | | | | | | | | | | | | | | | | | | | | | | Based on work done by @ben.boeckel (!8051) Fixes: #22217
* | | | Merge topic 'Pospelove-master-patch-11353'Brad King2023-05-041-0/+3
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | c64f6d5a5a Help: Document append functionality of string(JSON) Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8453
| * | | | Help: Document append functionality of string(JSON)Leonid Pospelov2023-05-031-0/+3
| |/ / /
* | | | Merge topic 'autogen-system-include'Brad King2023-05-047-0/+65
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 7bf4e30090 Autogen: Default AUTOGEN_USE_SYSTEM_INCLUDE to ON if it is not set 033dc7ee2f Autogen: Add AUTOGEN_USE_SYSTEM_INCLUDE target property 8ba16db163 Tests/RunCMake: Add option for dynamic expected output Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8400
| * | | Autogen: Default AUTOGEN_USE_SYSTEM_INCLUDE to ON if it is not setOrkun Tokdemir2023-05-033-0/+32
| | | | | | | | | | | | | | | | Add policy CMP0151 to preserve the old behavior by default.
| * | | Autogen: Add AUTOGEN_USE_SYSTEM_INCLUDE target propertyOrkun Tokdemir2023-05-035-0/+33
| | | | | | | | | | | | | | | | | | | | | | | | | | | | `AUTOGEN_USE_SYSTEM_INCLUDE` was added. `AUTOGEN_USE_SYSTEM_INCLUDE` is a boolean property that can be set on a target to indicate that the autogen target include directory should be added as a system include directory or normal include directory to the target.
* | | | Merge topic 'vs-debugger-init'Brad King2023-05-0210-4/+56
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 35566b48b4 VS: Add variables to initialize debugger-related properties Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8445
| * | | | VS: Add variables to initialize debugger-related propertiesAlex Neundorf2023-05-0110-4/+56
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add variables to initialize target properties `VS_DEBUGGER_COMMAND`, `VS_DEBUGGER_COMMAND_ARGUMENTS`, `VS_DEBUGGER_ENVIRONMENT`, and `VS_DEBUGGER_WORKING_DIRECTORY`.
* | | | | Merge topic 'doc-xref-find-env-vars'Brad King2023-05-0218-11/+133
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | c584882b26 Help: change links to point to the env.vars, not to the cmake vars e40d4eb644 Help: add documentation for some CMAKE_XXX_PATH env.vars 73ce0b792f Help: minor improvement for the CMAKE_PREFIX_PATH docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8444
| * | | | | Help: change links to point to the env.vars, not to the cmake varsAlex Neundorf2023-05-016-5/+32
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The documentation of the find-commands was pointing to the cmake variables CMAKE_PREFIX_PATH, CMAKE_INCLUDE_PATH etc. also in the section for environment variables. Now they point to the documentation for the respective environment variables.
| * | | | | Help: add documentation for some CMAKE_XXX_PATH env.varsAlex Neundorf2023-05-0112-7/+99
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This patch adds basic documentation for the CMAKE_INCLUDE_PATH, CMAKE_LIBRARY_PATH, CMAKE_PROGRAM_PATH, CMAKE_APPBUNDLE_PATH and CMAKE_FRAMEWORK_PATH environment variables and links to the respective cmake variables and vice versa.
| * | | | | Help: minor improvement for the CMAKE_PREFIX_PATH docsAlex Neundorf2023-04-291-0/+3
| |/ / / / | | | | | | | | | | | | | | | | | | | | With this patch the CMAKE_PREFIX_PATH env. var. is now mentioned in the help for the CMAKE_PREFIX_PATH cmake var.
* | | | | Help: Remove outdated link to Absoft FortranBrad King2023-05-011-2/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Absoft ceased operations on 2022-09-22 [1] [2]. The website is no longer available. [1] https://web.archive.org/web/20220816070730/https://www.absoft.com/ [2] https://fortran-lang.discourse.group/t/4274
* | | | | Merge topic 'tutorial-iface-order'Brad King2023-05-017-200/+225
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | c6a426198a Tutorial: Move Step4-Ex1 to Step3-Ex2 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8417
| * | | | | Tutorial: Move Step4-Ex1 to Step3-Ex2Paul Choisel2023-04-287-200/+225
| | |_|/ / | |/| | | | | | | | | | | | | | | | | | During the training, we talk about INTERFACE libraries just before Step3 so it makes more sense to do the exercise related to them in Step3
* | | | | Merge topic 'cpack-inno-setup'Brad King2023-05-013-0/+433
|\ \ \ \ \ | |_|/ / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | 1d6db66179 CPack: Add Inno Setup generator 9b0dc652ff ci: Provide Inno Setup tools to some Windows CI jobs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8399
| * | | | CPack: Add Inno Setup generatorJannik Alber2023-04-283-0/+433
| | |/ / | |/| |
* | | | FindDoxygen: Optionally use custom config fileLe Go2023-04-271-0/+5
|/ / /
* | | Merge topic 'ExternalProject-relative-git-urls'Craig Scott2023-04-273-0/+47
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 550f63447d ExternalProject/FetchContent: Support relative remote URLs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7988