summaryrefslogtreecommitdiffstats
path: root/Help/manual/cmake.1.rst
Commit message (Collapse)AuthorAgeFilesLines
* cmake: Teach -E remove_directory to remove multiple directoriesJohn Freeman2019-06-031-2/+2
| | | | | The `make_directory` command can make multiple directories in a single invocation. Make `remove_directory` mirror that behavior.
* Merge topic 'tar-zstd-compression'Brad King2019-05-301-5/+8
|\ | | | | | | | | | | | | 53cb1f2d04 cmake: Teach cmake -E tar command, Zstandard compression Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3357
| * cmake: Teach cmake -E tar command, Zstandard compressionBartosz Kosiorek2019-05-221-5/+8
| | | | | | | | Fixes #18657
* | cmake: tar: Allow selective extracting and listing of archivesBartosz Kosiorek2019-05-231-3/+9
|/
* Merge topic 'jobs-positive-value'Brad King2019-05-031-0/+3
|\ | | | | | | | | | | | | 6ad699358b cmake: --build -j <jobs> should not accept 0. Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3255
| * cmake: --build -j <jobs> should not accept 0.Fred Baksik2019-05-011-0/+3
| | | | | | | | Fixes #19059
* | message(): Add support for log levelsAlex Turbov2019-04-281-0/+6
|/ | | | | Relates: #18943 Co-Authored-By: Craig Scott <craig.scott@crascit.com>
* Help: Improve formatting of Help documentationBartosz Kosiorek2019-04-081-16/+17
|
* Merge topic 'cmake--install'Kyle Edwards2019-03-191-2/+40
|\ | | | | | | | | | | | | | | | | | | | | 73f23d1e00 cmake: add '--install <dir>' option Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Alex Turbov <i.zaufi@gmail.com> Acked-by: Bartosz <gang65@poczta.onet.pl> Acked-by: Cristian Adam <cristian.adam@gmail.com> Rejected-by: Alex Turbov <i.zaufi@gmail.com> Merge-request: !3069
| * cmake: add '--install <dir>' optionJiang Yi2019-03-161-2/+40
| | | | | | | | Fixes: #19023
* | Help: Update 'tar' documentation with supported argumentsBartosz Kosiorek2019-03-181-0/+15
| |
* | Merge topic 'short-commands'Brad King2019-03-141-3/+3
|\ \ | | | | | | | | | | | | | | | | | | | | | 077ab5774c cmake: add short version of '--target <tgt>...' option 071f5e1544 cmake: Reformat '--parallel' and '--verbose' options in help Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !3078
| * | cmake: add short version of '--target <tgt>...' optionBartosz Kosiorek2019-03-121-1/+1
| | |
| * | cmake: Reformat '--parallel' and '--verbose' options in helpBartosz Kosiorek2019-03-121-2/+2
| |/
* | cmake: Upgrade 'cmake -E' commands descriptionBartosz Kosiorek2019-03-121-4/+12
|/ | | | Fixes: #13204
* cmake: Teach --build mode to support multiple targetsBartosz Kosiorek2019-03-051-2/+2
| | | | Fixes: #16136
* Merge topic 'add_consistent_verbose_build_flag'Brad King2019-01-291-0/+8
|\ | | | | | | | | | | | | | | | | | | | | | | 66801f4d40 cmake: Add tests for verbose output to --build mode 439fe2e253 cmake: Add options for verbose output to --build mode 638667efa2 cmake: cmcmd.cxx fix "The arguments are" comments 3ca4402966 ctest: Fix --build-and-test without --build-target on Xcode cb6c233ecc cmake: Add -hideShellScriptEnvironment xcodebuild option 1a45266cb5 cmGlobalGenerator: Add a class that represent the build command Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2708
| * cmake: Add options for verbose output to --build modeFlorian Maushart2019-01-281-0/+8
| | | | | | | | | | | | | | | | | | | | | | | | While we already support `VERBOSE` environment variable and `CMAKE_VERBOSE_MAKEFILE` cached variable, add `-v` and `--verbose` command line options to be able to activate verbose output directly from CMake's build tool mode command line. Also make `msbuild` honor the verbosity setting. `xcodebuild` still doesn't honor the verbosity setting as it will need a policy added and reworking of cmGlobalGenerator and cmsys to support multiple command invocation.
* | cmake: Add --ignore-eol option to `-E compare_files` commandTaylor Braun-Jones2019-01-281-2/+3
|/ | | | Fixes: #13007
* Help: Extend the cmake(1) manualBrad King2018-11-271-21/+116
| | | | | | | | Extend the description section to cover all capabilities that the "cmake" tool has. Extend the buildsystem generation section to introduce important concepts and describe the basic workflow. Inspired-by: Joachim Wuttke (l) <j.wuttke@fz-juelich.de>
* Help: Improve cmake(1) manual organizationJoachim Wuttke (l)2018-11-271-48/+107
| | | | | | | | | | | Extend the Synposis, and provide links to manual sections. Add sections for `cmake --open` and `cmake --help-*`. Introduce a new section for buildsystem generation to distinguish it from the other functionality. Populate it with minimal placeholder text for now. It will be extended later. Co-Author: Brad King <brad.king@kitware.com>
* Help: Emphasize tool names in their manualsJoachim Wuttke (l)2018-11-261-1/+1
| | | | | | Print the name of the **cmake** executable in boldface, so that it does not appear less prominent than other shell commands (which are underlaid with links). Similarly the other tool manuals.
* Merge topic 'symlink'Brad King2018-09-191-5/+0
|\ | | | | | | | | | | | | afb7f6e4ff cmake: Add '-E create_symlink' support on Windows Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2144
| * cmake: Add '-E create_symlink' support on WindowsJon Chronopoulos2018-09-181-5/+0
| | | | | | | | | | | | | | | | | | | | | | | | The allows `-E create_symlink` to work on Windows. It utilizes `uv_fs_symlink`. I am still unsure exactly which Windows platforms will work without requiring Administrator privileges or needing a user/group with the "Create Symbolic Links" User Rights. It does work with my Windows 10 Pro with Developer Mode turned on. In the test suite check that the symlink either worked or failed with a permissions error. Use recent changes in cmSystemTools::FileExists to check that a symlink is broken.
* | cmake: -S and -B can be used to specify source and build directoriesRobert Maynard2018-09-151-0/+1
|/ | | | | | Document the previously internal option of '-B' and provide a matching source directory option with '-S'. Both '-B', and '-S' can be used independently of each other.
* cmake: Add options for parallel builds to --build modeFlorian Maushart2018-05-251-0/+7
| | | | | | | While we already support `cmake --build . -- -j`, the options after `--` are specific to the native build tool. Add new options `--parallel [<N>]` and `-j [<N>]` to abstract this and map to the proper option for the native build tool.
* Help: Fix command-line synopsis markup syntaxBrad King2018-04-181-2/+2
| | | | | | Use `{}` to surround required parts instead of `()`. Fixes: #17917
* Help: Reword misleading docs for cmake -E timeTaylor Braun-Jones2018-01-191-1/+1
|
* cmake: Add --open option for IDE generatorsGregor Jasny2017-10-131-0/+5
|
* Merge topic 'document_env_variables'Craig Scott2017-09-271-0/+2
|\ | | | | | | | | | | | | e6b77c5f Help: Document CMake's environment variables Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1235
| * Help: Document CMake's environment variablesRobert Maynard2017-09-261-0/+2
| |
* | Docs: Improve markup for graphviz related documentationJano Svitok2017-09-111-2/+2
|/ | | | | - add hyperlink to CMakeGraphVizOptions.cmake in cmake(1) - improve markup in CMakeGraphVizOptions.cmake
* Add sha1sum, sha224sum, sha256sum, sha384sum and sha512sum to command modeAndré Klitzing2017-07-141-0/+30
|
* Help: Add note about cmake -E copy not supporting wildcardsTim2017-04-111-1/+1
| | | | Issue: #16791
* Merge topic 'clarifyRemoveDocs'Brad King2017-04-101-2/+4
|\ | | | | | | | | | | | | 812274ff Help: Clarify what the -f option does for the remove command Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !680
| * Help: Clarify what the -f option does for the remove commandCraig Scott2017-04-101-2/+4
| | | | | | | | Closes: #16784
* | handle non-existing symlink creation locationsDomen Vrankar2017-03-281-0/+3
|/
* cmake-server: Add documentationTobias Hunger2016-09-191-0/+3
|
* cmake: Add `cmake -E capabilities` modeTobias Hunger2016-08-161-0/+37
| | | | | | | Add `cmake -E capabilities` to report on generators, cmake version and possibly other static capabilities of cmake. Closes: #15462
* cmake: Add an option to control what files needs to be tracedAlex Turbov2016-06-171-0/+5
| | | | | | | | | | Even in relatively small projects using `--trace` (and `--trace-expand`) may produce a lot of output. When developing a custom module usually one is interested in output of only a few particular modules. Add a `--trace-source=<file>` option to enable tracing only a subset of source files. The final output would be only from requested modules, ignoring anything else not matched to given filename(s).
* Help: Document `cmake --build` as a separate command mode (#16093)Brad King2016-05-101-18/+34
| | | | | | | The `--build` mode was confusingly documented among other options, falsely implying that it can be used anywhere on the command line. Move the documentation to a dedicated section and clarify its usage as s separate command line mode.
* Help: Document `cmake --find-package` as a separate command modeBrad King2016-05-101-6/+19
|
* Help: Improve 'cmake -E md5sum' documentationBartosz Kosiorek2016-05-021-1/+4
|
* Help: Add missing space in cmake(1) manualBartosz Kosiorek2016-05-021-1/+1
|
* Merge topic 'doc-cmake-E-details'Brad King2016-02-241-4/+8
|\ | | | | | | | | b3475030 Help: Clarify `cmake -E` command behavior with respect to file existence
| * Help: Clarify `cmake -E` command behavior with respect to file existenceBartosz Kosiorek2016-02-191-4/+8
| |
* | cmake: Teach --build to reject multiple --target optionsSebastian Schuberth2016-02-051-0/+1
| | | | | | | | | | | | | | | | | | | | Previously we did not clearly document that `--target` is only supported to be specified once. Even worse, specifying it multiple times would silently ignore any previously specified targets and only build the last target. Update the documentation to specify this. Update the implementation to reject multiple `--target` options to prevent user errors.
* | Help: Fix reference to `cmake --build` in cmake(1) manualBrad King2016-02-051-1/+1
|/
* cmake: Teach -E make_directory to support multiple input directoriesBartosz Kosiorek2015-12-101-4/+6
|
* cmake: Teach -E copy_directory to support multiple input directoriesBartosz Kosiorek2015-12-071-2/+3
|