summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* Help: Document ctest_update branch following behaviorBrad King2016-06-081-0/+4
|
* try_compile: Optionally forward custom platform variables to test projectBrad King2016-05-251-0/+4
| | | | | | | | | Add a `CMAKE_TRY_COMPILE_PLATFORM_VARIABLES` variable to specify a list of custom variables to be forwarded to a `try_compile` test project. This will be useful for platform information modules or toolchain files to forward some platform-specific set of variables from the host project (perhaps set in its cache) to the test project so that it can build the same way.
* file: Sort GLOB results to make it deterministic (#14491)Reiner Herrmann2016-05-171-2/+3
| | | | | | | | | | | | | | | | | Even though the `file(GLOB)` documentation specifically warns against using it to collect a list of source files, projects often do it anyway. Since it uses `readdir()`, the list of files will be unsorted. This list is often passed directly to add_executable / add_library. Linking binaries with an unsorted list will make it unreproducible, which means that the produced binary will differ depending on the unpredictable `readdir()` order. To solve those reproducibility issues in a lot of programs (which don't explicitly `list(SORT)` the list manually), sort the resulting list of the `file(GLOB)` command. A more detailed rationale about reproducible builds is available [here](https://reproducible-builds.org/).
* Drop find_(library|file|path) prefixes from PATH on non-WindowsBrad King2016-05-093-3/+6
| | | | | | | | | | | Since commit v3.3.0-rc1~430^2 (Teach find_(library|file|path) to get prefixes from PATH, 2015-02-18) we search in <prefix>/include and <prefix>/lib directories for prefixes with bin directories in the PATH environment variable. The motivation was to support MSYS, MinGW and similar Windows platforms in their default environments automatically. At the time this behavior was thought to be worthwhile in general. Suggested-by: Chuck Atkins <chuck.atkins@kitware.com>
* CustomCommandGenerator: Add support for CROSSCOMPILING_EMULATORJean-Christophe Fillion-Robin2016-05-092-4/+10
| | | | | | Teach the `add_custom_command` and `add_custom_target' commands to substitute argv0 with the crosscompiling emulator if it is a target with the `CROSSCOMPILING_EMULATOR` property set.
* Fix spelling typos in comments and documentation (#16037)Felix Geyer2016-03-292-2/+2
| | | | | The Debian package checker tool (lintian) detected several typos in CMake.
* Help: Organize and clarify `cmake_minimum_required` documentationBrad King2016-03-231-18/+27
| | | | | State more explicitly that `cmake_policy(VERSION)` is implied and explain the effects it has.
* Drop Visual Studio 6 generatorBrad King2016-03-092-3/+2
| | | | | | This generator has been deprecated since CMake 3.3. Remove it. Update documentation, modules, and tests to drop content specific to this generator.
* try_compile: Add option to control type of targetBrad King2016-02-191-0/+3
| | | | | | | Create a `CMAKE_TRY_COMPILE_TARGET_TYPE` option to specify use of `add_library(... STATIC ...)` for the generated test project. This will be useful for cross-compiling toolchains that cannot link a binary without custom flags or scripts.
* Merge topic 'unix-timestamps'Brad King2016-02-191-0/+1
|\ | | | | | | | | 6727270b CMake: Extend TIMESTAMP sub-commands with new unix time format specifier
| * CMake: Extend TIMESTAMP sub-commands with new unix time format specifierJose-Luis Blanco-Claraco2016-02-181-0/+1
| | | | | | | | | | | | | | | | The new `%s` format specifier is substituted by file()/string() `TIMESTAMP` sub-commands with the number of seconds since unix-epoch (1970-01-01 00:00:00 UTC). Co-Author: Nils Gladitz <nilsgladitz@gmail.com>
* | Help: Clarify install(TARGETS) INCLUDES DESTINATION optionBrad King2016-02-171-7/+12
|/ | | | | | | | The option does not actually participate in argument groups like the others because it does not actually install anything. Fix the order in the documentation accordingly. Reported-by: Daniel Wirtz <daniel.wirtz@simtech.uni-stuttgart.de>
* Merge topic 'install-EXCLUDE_FROM_ALL'Brad King2016-02-091-8/+15
|\ | | | | | | | | | | | | 586e56d0 Help: Add notes for topic 'install-EXCLUDE_FROM_ALL' d321c196 Tests: Add cases for install() command EXCLUDE_FROM_ALL option 18ce97c4 install: Add EXCLUDE_FROM_ALL option (#14921)
| * install: Add EXCLUDE_FROM_ALL option (#14921)Nick Lewis2016-02-041-8/+15
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Let us take an example of a project that has some tests in a component that need to be installed into a dedicated test package. The user expectation is that the result could be achieved by typing the following: make make tests make install DESTDIR=/testpkgs make install-tests However this results in test components in the default installation as well as the testpkg. Add an EXCLUDE_FROM_ALL option to the install() command to tell it that the installation rule should not be included unless its component is explicitly specified for installation.
* | Merge topic 'fix-doc-typos'Brad King2016-02-081-1/+1
|\ \ | | | | | | | | | | | | | | | a3b91d16 Help: Fix command specification for cmake_minimum_required d8c90800 Help: Fix mistake in cmake-buildsystem(7) example
| * | Help: Fix command specification for cmake_minimum_requiredHorst Kronstorfer2016-02-081-1/+1
| |/ | | | | | | | | | | Implementation indicates that at least two components of VERSION must be specified (see Source/cmCMakeMinimumRequired.cxx.) Therefore the minor version is not optional.
* | list: Add FILTER subcommand (#3986)Ashley Whetter2016-02-031-3/+10
|/ | | | Create a `list(FILTER)` command to filter lists by regular expression.
* Help: Clarify `add_custom_command(TARGET)` scope (#15681)Bartosz Kosiorek2016-01-281-2/+5
|
* Help: Clarify scope of `if(TARGET)` expressionBartosz Kosiorek2016-01-281-3/+4
|
* Help: Improve markup in `if` command documentationBartosz Kosiorek2016-01-281-1/+1
|
* Help: Improve markup in `get_target_property` documentationBartosz Kosiorek2016-01-281-1/+1
|
* install: Allow generator expressions in DIRECTORYYves Frederix2016-01-131-3/+4
| | | | | Teach install(DIRECTORY) to support generator expressions in the list of directories, much like install(FILES) already supports.
* cmake_parse_arguments: consider duplicate keyword as warningMatthias Maennich2015-12-171-0/+7
| | | | | | The behaviour of double specified keywords is rather undefined or at least not clearly documented. This change introduces a strict check and emits a warning in case a keyword has been specified more than once.
* CMakeParseArguments: replace by native cmake_parse_arguments commandMatthias Maennich2015-12-171-0/+78
| | | | | | | Implement a native `cmake_parse_arguments` command that is fully compatible with the documented behaviour of the previous implementation. Leave the CMakeParseArguments module empty but existing for compatibility.
* Merge topic 'doc-add_executable-typo'Brad King2015-10-261-1/+1
|\ | | | | | | | | 194011b8 Help: Add missing parenthesis in add_executable docs
| * Help: Add missing parenthesis in add_executable docsChristopher Dembia2015-10-221-1/+1
| |
* | Merge topic 'doc-file-GLOB-no-order'Brad King2015-10-211-1/+2
|\ \ | | | | | | | | | | | | 5a208f83 Help: Document that file(GLOB*) order is undefined
| * | Help: Document that file(GLOB*) order is undefinedRuslan Baratov2015-10-211-1/+2
| |/ | | | | | | | | | | Since this command use 'readdir' under the hood the order of list is undefined: * http://stackoverflow.com/questions/8977441/does-readdir-guarantee-an-order
* | Merge topic 'doc-add_test-requirements'Brad King2015-10-191-0/+7
|\ \ | | | | | | | | | | | | f19d6a2c Help: Document add_test expectations of test command (#15798)
| * | Help: Document add_test expectations of test command (#15798)Brad King2015-10-191-0/+7
| |/
* | Help: Document that SHARED libraries must export a symbol (#15775)James Johnston2015-10-081-0/+6
|/ | | | | | | CMake assumes that a SHARED library compiled on Windows will export a LIB file. This is not actually the case on Visual C++ if the library does not export any symbols, and causes incremental builds to break if the user specifies SHARED anyway. (Users should use MODULE libraries instead.)
* install: Allow generator expressions in DIRECTORY DESTINATIONRobert Goulet2015-09-241-0/+4
|
* install: Allow generator expressions in FILES DESTINATIONRobert Goulet2015-09-231-0/+4
|
* Merge topic 'ctest-variable-docs'Brad King2015-09-221-0/+3
|\ | | | | | | | | | | | | | | 4da5a227 Help: document CTEST_CUSTOM_* variables 70c0cc72 ctest_read_custom_files: mention that ctest does this automatically 71c67e83 CTEST_CUSTOM_*: treat variables as lists 936a95d4 CTestCoverageCollectGCOV: replace tabulators
| * ctest_read_custom_files: mention that ctest does this automaticallyBen Boeckel2015-09-211-0/+3
| |
* | try_compile: Propogate CMP0065 to the generated project.Chuck Atkins2015-09-211-0/+3
|/ | | | | | | Set policy CMP0065 to the value used in the calling project. Set the the value of CMAKE_ENABLE_EXPORTS if set in the calling project to initialize the target property appropriately.
* CTest: Document and test custom output size settingsBrad King2015-09-181-0/+3
| | | | | | | | | Add documentation and tests for the existing CTEST_CUSTOM_MAXIMUM_PASSED_TEST_OUTPUT_SIZE CTEST_CUSTOM_MAXIMUM_FAILED_TEST_OUTPUT_SIZE CTest variables.
* Help: Document string(REGEX) input concatentation (#15742)Brad King2015-09-141-0/+3
| | | | | These commands concatenate all their input before matching. Document this behavior.
* Help: Organize string command docs into sectionsBrad King2015-09-141-82/+218
| | | | | Add section headers and titles for each command signature. Group related commands into sections.
* Merge topic 'doc-get_filename_component-typo'Brad King2015-09-091-1/+1
|\ | | | | | | | | 8bfa34b7 Help: Fix typo in get_filename_component docs
| * Help: Fix typo in get_filename_component docsChristopher Meng2015-09-081-1/+1
| | | | | | | | trailing slahes -> trailing slashes
* | find_program: Optionally consider all names in each directoryBrad King2015-09-021-1/+6
|/ | | | | | | When more than one value is given to the NAMES option this command by default will consider one name at a time and search every directory for it. Add a NAMES_PER_DIR option to tell this command to consider one directory at a time and search for all names in it.
* get_filename_component: Teach new BASE_DIR parameter.James Johnston2015-08-181-5/+32
| | | | | | In the get_filename_component command, add a new BASE_DIR parameter to use with the ABSOLUTE and REALPATH options. This will be used when finding an absolute path from a relative path.
* try_compile: Update documentation for other propagated variablesChuck Atkins2015-08-141-0/+4
|
* try_compile: Propogate the CMAKE_LINK_SEARCH_ variablesChuck Atkins2015-08-141-0/+7
|
* Merge topic 'if-test'Brad King2015-08-031-0/+4
|\ | | | | | | | | | | 14e49ed1 if: Add "TEST <test>" condition 623dcc85 ExternalProject: Avoid if() auto-dereference of a "TEST" variable
| * if: Add "TEST <test>" conditionMatt McCormick2015-08-031-0/+4
| | | | | | | | | | | | | | | | if(TEST TestNameThatExists) will return true if a test with the name TestNameThatExists has been added with add_test. The syntax is similar to if(TARGET TargetName). Since use of "TEST" as an argument to if() could previously be interpreted as a non-keyword argument, add policy CMP0064 to treat it as a keyword as NEW behavior.
* | Help: Document string(FIND) return value when no match is foundJames Johnston2015-07-301-1/+1
|/
* Merge topic 'doc-apple-framework-creation'Brad King2015-07-151-0/+2
|\ | | | | | | | | eb8eaaec Help: Document Apple Framework creation with an example (#15651)
| * Help: Document Apple Framework creation with an example (#15651)Brad King2015-07-141-0/+2
| |