summaryrefslogtreecommitdiffstats
path: root/Help/manual/cmake.1.rst
Commit message (Collapse)AuthorAgeFilesLines
* cmake: Add filtered debug-find optionsJohn Parent2021-12-171-0/+14
| | | | | | | | | | Add a `--debug-find-pkg=` option to debug find calls for specific packages. Add a `--debug-find-var=` option to debug find calls for specific return variables. Fixes: #21880
* Help: Clarify 'cmake --build' signature alternativesBrad King2021-07-131-1/+2
| | | | | | | | | | | | | | | | Documentation added by * commit 4f4f2028b8 (Help: Add documentation for buildPresets and testPresets, 2021-01-13, v3.20.0-rc1~51^2~7) * commit 676ecf0d37 (cmake-presets: Add build and test presets, 2020-12-14, v3.20.0-rc1~51^2~6) used square brackets in the `cmake --build` signature to indicate non-optional alternatives, which is not a typical convention. A common convention is to use parentheses instead, but in this case it is probably clearer to list the two signatures separately. Fixes: #22413
* Merge topic 'capabilties-generator-platforms'Brad King2021-05-111-0/+6
|\ | | | | | | | | | | | | 66be34853c cmake: add supported platforms to cmake -E capabilties report Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6102
| * cmake: add supported platforms to cmake -E capabilties reportscheffle2021-05-101-0/+6
| |
* | Help: Fix typos and spelling in documentationJosef Angstenberger2021-05-071-1/+1
|/
* cmake(1): Change wording for fields in presetsfriendlyanon2021-04-211-3/+3
| | | | | | The placement of the word "optionally" implied that the fields mentioned before are not optional, which is not the case starting from version 3 of the presets.
* Help: Add 3.20 release note for error on unknown argumentsBrad King2021-04-141-0/+1
| | | | | | | This was left out of commit 1b6c5333a0 (cmake: Error out on unknown arguments starting with `-`., 2020-11-30, v3.20.0-rc1~370^2). Fixes: #22060
* cmake: Add support for '--build --prefix=<prefix>' form of the argumentBrad King2021-02-231-1/+1
| | | | | | | The main `cmake --preset` argument for configure presets supports both forms, so support it for `cmake --build --preset` too. Issue: #21855
* cmake: Document '--preset <preset>' form of the argumentBrad King2021-02-231-1/+1
| | | | | | This form already works. Document it and add tests. Issue: #21855
* Help: Add documentation for buildPresets and testPresetsSam Freed2021-02-011-3/+19
|
* Merge topic 'cmake-presets-path-arg'Craig Scott2020-10-271-17/+15
|\ | | | | | | | | | | | | b7d7eca66d CMakePresets.json: Rework how --preset argument is handled Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5416
| * CMakePresets.json: Rework how --preset argument is handledKyle Edwards2020-10-261-17/+15
| | | | | | | | | | | | | | | | If a path argument with no -S or -B leads to a cache directory, use that directory as the binary directory. Otherwise, use the binary directory from the preset. Fixes: #21311
* | Merge topic 'cmake-presets-doc-move'Kyle Edwards2020-10-201-328/+4
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | 4a123fc28c Help: Clarify purpose of warnings and errors 6c74bcfc20 Help: Make architecture and toolset descriptions generic 45766789a0 Help: Add inheritance to CMakePresets.json example 88c9d6f6eb Help: Add documentation for debug field efab856008 Help: Show environment field 2208db114c Help: Show multiple ways of doing cacheVariables d30f85193f Help: Move vendor field into example b9c8c57860 Help: s/unusedVars/unusedCli/ ... Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5373
| * Help: Move CMakePresets.json documentation into a separate fileKyle Edwards2020-10-191-328/+4
| |
* | server: remove deprecated 'cmake -E server' modeBrad King2020-10-141-0/+1
|/ | | | | | The server mode has been deprecated since commit 996e1885c4 (server: deprecate in favor of the file-api, 2019-04-19, v3.15.0-rc1~198^2). Clients should now be using the file-api. Remove the server mode.
* Help: Fix invalid code-block in cmake(1) manualKyle Edwards2020-10-141-1/+1
| | | | Fixes: #21304
* Tests: Test the CMakePresets.json example in the documentationKyle Edwards2020-10-091-25/+2
|
* Help: Fix documentation of CMakePresets.json's cacheVariablesKyle Edwards2020-10-091-4/+3
| | | | | | cacheVariables is a map with variable names as the keys, but the example in the documentation was not updated to reflect this. Fix the example.
* CMakePresets.json: Prohibit empty variable namesKyle Edwards2020-10-061-15/+17
|
* Help: Add presets documentation and release notesKyle Edwards2020-10-051-0/+368
|
* cmake_language: Add signature to DEFER calls to later timesBrad King2020-09-291-1/+6
| | | | Fixes: #19575
* Fix typos identified using codespellJean-Christophe Fillion-Robin2020-07-221-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | See https://github.com/codespell-project/codespell#readme The following command was used: ``` codespell -q6 --skip="\ .git,\ *.json,\ ./Copyright.txt,\ ./Help/command/foreach.rst,\ ./Help/prop_test/REQUIRED_FILES.rst,\ ./Help/variable/CTEST_COVERAGE_COMMAND.rst,\ ./Modules/CMakeCheckCompilerFlagCommonPatterns.cmake,\ ./Modules/CMakeRCInformation.cmake,\ ./Modules/Internal/CPack/NSIS.template.in,\ ./Modules/FindMatlab.cmake,\ ./Modules/MatlabTestsRedirect.cmake,\ ./Modules/Platform/Windows-Clang.cmake,\ ./Modules/Platform/Windows-Intel-Fortran.cmake,\ ./Modules/Platform/Windows-MSVC.cmake,\ ./Source/CMakeVersion.cmake,\ ./Source/cmConvertMSBuildXMLToJSON.py,\ ./Source/cmCreateTestSourceList.cxx,\ ./Source/cmGlobalVisualStudio10Generator.cxx,\ ./Source/cmExportBuildFileGenerator.cxx,\ ./Source/cmExportInstallAndroidMKGenerator.cxx,\ ./Source/cmExportInstallFileGenerator.cxx,\ ./Source/cmExportSet.cxx,\ ./Source/cmExportTryCompileFileGenerator.cxx,\ ./Source/cmFindPackageCommand.cxx,\ ./Source/cmInstallCommand.cxx,\ ./Source/cmGeneratorExpressionLexer.cxx,\ ./Source/cmLocalVisualStudio7Generator.cxx,\ ./Source/cmOrderDirectories.cxx,\ ./Source/cmTarget.cxx,\ ./Source/kwsys/*,\ ./Source/QtDialog/CMakeSetupDialog.ui,\ ./Source/CPack/WiX/cmWIXRichTextFormatWriter.cxx,\ ./Source/CTest/cmParseCoberturaCoverage.h,\ ./Tests/CMakeTests/ImplicitLinkInfoTest.cmake.in,\ ./Tests/RunCMake/CPack/tests/DMG_SLA/English.license.rtf,\ ./Tests/RunCMake/CPack/tests/DMG_SLA/German.license.txt,\ ./Tests/RunCMake/CPack/tests/DMG_SLA/German.menu.txt,\ ./Tests/RunCMake/GoogleTest/xml_output.cpp,\ ./Tests/RunCMake/Make/TargetMessages*,\ ./Utilities/*,\ " \ -L "\ dependees,\ endwhile,\ fo,\ filetest,\ helpfull,\ nd,\ objext,\ stoll,\ supercedes,\ superceded,\ vas,\ varn,\ " ```
* cmake: Add -E create_hardlinkSibi Siddharthan2020-07-151-0/+7
| | | | | Fixes: #20950 Signed-off-by: Sibi Siddharthan <sibisiddharthan.github@gmail.com>
* cmake: Remove broken '--warn-unused-vars' optionBrad King2020-06-291-3/+3
| | | | | | | | | | | | | This option has been broken since commit b9f9915516 (cmMakefile: Remove VarUsageStack., 2015-05-17, v3.3.0-rc1~52^2). That commit removed the check that an initialized variable has actually been used and caused the option to warn on every variable ever set. This was not caught by the test suite because the test for the feature only checked that warnings appear when needed and not that they do not appear when not needed. The option was never very practical to use. Remove it to avoid the runtime cost of usage tracking and checks for every variable (which we were doing even when the option was not used).
* cmake-install: implement default directory permissionsAsit Dhal2020-06-251-0/+3
| | | | | | provide an argument for default directory permissions in cmake --install Fixes: #20700
* cmake: add dedicated error for -E compare_files invalid argumentsAsit Dhal2020-06-151-1/+2
| | | | | | Return 2 when user provides invalid arguments Fixes: #20815
* cmake: Allow arbitrary args passed to CMake scriptAlex Turbov2020-05-061-1/+5
|
* cmake -E: add cat command.Johnny Jazeix2020-04-151-0/+3
| | | | | | Concatenate files and print on the standard output. FIXES: #20557
* Merge topic 'docs-CMAKE_FIND_DEBUG_MODE'Craig Scott2020-04-061-1/+3
|\ | | | | | | | | | | | | | | 477b8b5dfe Help: Improve discoverability of CMAKE_FIND_DEBUG_MODE 218bda9671 Help: Fix CMAKE_FIND_DEBUG_MODE list formatting Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4569
| * Help: Improve discoverability of CMAKE_FIND_DEBUG_MODECraig Scott2020-04-041-1/+3
| |
* | Merge topic 'trace-format-json-doc'Brad King2020-03-191-1/+1
|\ \ | |/ | | | | | | | | | | | | 1994f950ff cmake: List valid values for --trace-format on the command line e39766d84a Help: Fix documentation of --trace-format parameter Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4500
| * Help: Fix documentation of --trace-format parameterKyle Edwards2020-03-181-1/+1
| |
* | cmake: add command line options to output script profiling dataWouter Klouwen2020-03-071-0/+14
|/ | | | | | | | | | | | | | | For users of CMake who want to optimize their scripts if they take a while to run, this commit adds the ability to output profiling data. To enable this output, it adds the two command line parameters to select the output path and format. This commit adds the first profiling format of type ``google-trace``, which is the output is a JSON file containing Duration events as per the Google Trace Format specification: https://docs.google.com/document/d/1CvAClvFfyA5R- PhYUmn5OOQtYMH4h6I0nSsKchNAySU/preview#
* trace: Add time and stack level to JSON output formatFrank Winklmeier2020-01-221-3/+11
| | | | | | | | Add the timestamp and stack depth of the function call to the JSON trace output format. This information can be useful for cmake profiling and call stack inspection (see e.g. https://github.com/volo-zyko/cmake-profile-stats). Improve unit test to allow for varying set of keys to check in trace lines.
* Merge topic 'traceJSON'Kyle Edwards2019-12-271-0/+60
|\ | | | | | | | | | | | | | | e113ab1168 trace: Add test for the JSON-v1 trace 482497e0de trace: Add JSON output format Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4102
| * trace: Add JSON output formatDaniel Mensinger2019-12-231-0/+60
| | | | | | | | | | | | | | | | Add a new `--trace-format=` flag, to enable the new JSON trace output format. This new format is easier to parse by machines than the existing format. This new format also removes the ambiguity of the whitespace in the "old" format (e.g. is that whitespace part of a file path, or does it seperate arguments)
* | find_*: Add debug logging infrastructureRobert Maynard2019-12-191-0/+6
|/ | | | | | | | | | | | Enable debug messages a new `--find-debug` command-line option or via the `CMAKE_FIND_DEBUG_MODE` variable. This work was started by Chris Wilson, continued by Ray Donnelly, and then refactored by Robert Maynard to collect information into a single message per find query. Co-Author: Ray Donnelly <mingw.android@gmail.com> Co-Author: Chris Wilson <chris+github@qwirx.com>
* cmake -E: Add rm with improved semantics over remove and remove_directoryJohnny Jazeix2019-11-131-4/+20
|
* message: Support logging a context with each messageAlex Turbov2019-10-121-0/+10
|
* message: Add new CMAKE_MESSAGE_LOG_LEVEL variableAlex Turbov2019-10-121-0/+5
|
* CLI: Rename --loglevel to --log-level for naming consistencyCraig Scott2019-10-101-1/+4
| | | | | | | Other multi-word command line options use hyphens to separate the words, so the --loglevel option introduced in CMake 3.15 was inconsistent in this regard. Rename it to --log-level but still support the original --loglevel name to preserve backward compatibility.
* Help: Fix indentation of create_symlink noteKyle Edwards2019-09-191-2/+2
|
* Help: Fix ordering of cmake -E commandsKyle Edwards2019-09-181-9/+9
| | | | | Several of the commands were not in alphabetical order. Fix the ordering.
* cmake: Document -E remove_directory symlink behaviorBrad King2019-09-051-1/+2
| | | | | | | | Update documentation for the change made by commit e6c9a8bac3 (cmake: Teach -E remove_directory to remove directory symlinks, 2019-08-26). Also add a release note. Issue: #19533
* Help: Fix copy_directory descriptionLeonid Pospelov2019-09-021-1/+1
|
* Add --trace-redirect parameter to redirect trace output to a fileIgor Ivanov2019-08-101-0/+3
|
* cmake -E: Add true and false commandsKyle Edwards2019-07-111-0/+6
|
* 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.
* | 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
generated by cgit v0.12 at 2025-01-05 01:03:53 (GMT)