summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* break: Add policy CMP0055 to check calls strictlyGregor Jasny2014-11-253-0/+24
| | | | | | Reject break() without loop scope or any arguments. Signed-off-by: Gregor Jasny <gjasny@googlemail.com>
* Merge topic 'custom-command-byproducts'Brad King2014-11-251-0/+7
|\ | | | | | | | | 1f4f2aab Help: Add notes for topic 'custom-command-byproducts'
| * Help: Add notes for topic 'custom-command-byproducts'Brad King2014-11-251-0/+7
| |
* | Merge topic 'doc-drop-borland-workaround'Brad King2014-11-251-22/+0
|\ \ | | | | | | | | | | | | c2af447d Remove disallowed feature which Borland did not accept.
| * | Remove disallowed feature which Borland did not accept.Stephen Kelly2014-11-251-22/+0
| | |
* | | Merge topic 'remove-ancient-msvc-workarounds'Brad King2014-11-251-7/+1
|\ \ \ | |/ / | | | | | | | | | | | | | | | | | | | | | | | | | | | 12cb0b86 Help: Update developer manual with some C++ features now permitted. ba74465f cmGeneratorTarget: Remove MSVC7 workaround 41363c0c VisualStudio: Remove MSVC6 compatibility macro. 4efcfe52 cmSystemTools: Remove MSVC6 compatibility define. 5f4695cd cmStandardIncludes: Remove MSVC6 condition for cmArrayBegin macro. 7a064337 cmFindCommon: Remove MSVC6 workaround for nested struct private access. fdb73547 cmTarget: Remove std::min and std::max MSVC6 compatibility code.
| * | Help: Update developer manual with some C++ features now permitted.Stephen Kelly2014-11-201-7/+1
| | |
* | | Merge topic 'improve-INTERFACE-property-docs'Brad King2014-11-2516-75/+188
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | bb1111ea Help: Warn that paths should not be used in INTERFACE_ build properties. 96691d12 Help: Fix typo in genex in documentation. f8f02451 Help: Use a property-specific command instead of the generic one. 8609a884 Help: Make remaining build property docs consistent. bcface39 Help: Link to target_link_libraries from target properies. e12926e7 Help: Format the LINK_INTERFACE_LIBRARIES target properies. c8540e94 Help: Unify the help text of INTERFACE_ build properties.
| * | | Help: Warn that paths should not be used in INTERFACE_ build properties.Stephen Kelly2014-11-2510-0/+109
| | | |
| * | | Help: Fix typo in genex in documentation.Stephen Kelly2014-11-221-1/+1
| | | |
| * | | Help: Use a property-specific command instead of the generic one.Stephen Kelly2014-11-221-2/+2
| | | |
| * | | Help: Make remaining build property docs consistent.Stephen Kelly2014-11-222-7/+16
| | | | | | | | | | | | | | | | | | | | These help entries are different enough that they can not use the generic template.
| * | | Help: Link to target_link_libraries from target properies.Stephen Kelly2014-11-222-2/+4
| | | |
| * | | Help: Format the LINK_INTERFACE_LIBRARIES target properies.Stephen Kelly2014-11-222-12/+15
| | | |
| * | | Help: Unify the help text of INTERFACE_ build properties.Stephen Kelly2014-11-225-51/+41
| |/ /
* | | Merge topic 'custom-command-byproducts'Brad King2014-11-252-0/+45
|\ \ \ | |/ / |/| / | |/ | | | | 557aef0b ExternalProject: Add options to specify BYPRODUCTS (#14963) e15a7075 Add an option for explicit BYPRODUCTS of custom commands (#14963)
| * Add an option for explicit BYPRODUCTS of custom commands (#14963)Brad King2014-11-142-0/+45
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | A common idiom in CMake-based build systems is to have custom commands that generate files not listed explicitly as outputs so that these files do not have to be newer than the inputs. The file modification times of such "byproducts" are updated only when their content changes. Then other build rules can depend on the byproducts explicitly so that their dependents rebuild when the content of the original byproducts really does change. This "undeclared byproduct" approach is necessary for Makefile, VS, and Xcode build tools because if a byproduct were listed as an output of a rule then the rule would always rerun when the input is newer than the byproduct but the byproduct may never be updated. Ninja solves this problem by offering a 'restat' feature to check whether an output was really modified after running a rule and tracking the fact that it is up to date separately from its timestamp. However, Ninja also stats all dependencies up front and will only restat files that are listed as outputs of rules with the 'restat' option enabled. Therefore an undeclared byproduct that does not exist at the start of the build will be considered missing and the build will fail even if other dependencies would cause the byproduct to be available before its dependents build. CMake works around this limitation by adding 'phony' build rules for custom command dependencies in the build tree that do not have any explicit specification of what produces them. This is not optimal because it prevents Ninja from reporting an error when an input to a rule really is missing. A better approach is to allow projects to explicitly specify the byproducts of their custom commands so that no phony rules are needed for them. In order to work with the non-Ninja generators, the byproducts must be known separately from the outputs. Add a new "BYPRODUCTS" option to the add_custom_command and add_custom_target commands to specify byproducts explicitly. Teach the Ninja generator to specify byproducts as outputs of the custom commands. In the case of POST_BUILD, PRE_LINK, and PRE_BUILD events on targets that link, the byproducts must be specified as outputs of the link rule that runs the commands. Activate 'restat' for such rules so that Ninja knows it needs to check the byproducts, but not for link rules that have no byproducts.
* | Merge topic 'doc-target_include_directories-fixup'Brad King2014-11-171-2/+2
|\ \ | | | | | | | | | | | | 1d22ee67 Help: target_include_directories does not allow target names
| * | Help: target_include_directories does not allow target namesBrad King2014-11-171-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | Since commit v2.8.11~227^2~1 (Don't allow targets args in the new target commands, 2013-01-29) the target_include_directories command does not support target names on the right hand side, but that commit forgot to remove it from the docs. It was never released with such support. Update the command documentation now.
* | | Merge topic 'console-pool'Brad King2014-11-173-3/+24
|\ \ \ | | |/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | 2d75d7e5 Help: Add notes for topic 'console-pool' f42d86f0 Ninja: Implement USES_TERMINAL using the console pool if available f281ae01 Ninja: Remove unused declaration d5eae556 Ninja: factor out the test for console pool support 4d1fedf4 Give the interactive cache editor the USES_TERMINAL property fe5d6e8c Add USES_TERMINAL option for custom commands ad6ee426 Rename doing_verbatim to doing_nothing
| * | Help: Add notes for topic 'console-pool'Peter Collingbourne2014-11-141-0/+8
| | |
| * | Add USES_TERMINAL option for custom commandsPeter Collingbourne2014-11-142-3/+16
| | | | | | | | | | | | | | | | | | Teach the add_custom_command and add_custom_target commands a new USES_TERMINAL option. Use it to tell the generator to give the command direct access to the terminal if possible.
* | | Merge topic 'vs14-is-2015'Brad King2014-11-173-7/+7
|\ \ \ | | | | | | | | | | | | | | | | f5afb90d VS: Rename VS 14 generator to 'Visual Studio 14 2015'
| * | | VS: Rename VS 14 generator to 'Visual Studio 14 2015'Brad King2014-11-143-7/+7
| | | | | | | | | | | | | | | | | | | | | | | | Now that we know the year component of this VS version we can add it to the generator name. For convenience, map the name without the year to the name with the year.
| * | | Merge branch 'emacs-mode-underscore-in-symbol' into releaseBrad King2014-11-121-0/+4
| |\ \ \
| * \ \ \ Merge branch 'doc-CMAKE_INSTALL_PREFIX-link-GNUInstallDirs' into releaseBrad King2014-11-121-0/+5
| |\ \ \ \
| * \ \ \ \ Merge branch 'doc-cleanup-xrefs' into releaseBrad King2014-11-073-4/+4
| |\ \ \ \ \
| * \ \ \ \ \ Merge branch 'doc-formatting' into releaseBrad King2014-11-071-1/+2
| |\ \ \ \ \ \
* | \ \ \ \ \ \ Merge topic 'string-SUBSTRING-truncate'Brad King2014-11-171-1/+6
|\ \ \ \ \ \ \ \ | |_|_|_|_|_|/ / |/| | | | | | | | | | | | | | | | | | | | | | | 474bbb9d string: Tolerate SUBSTRING length exceeding end index
| * | | | | | | string: Tolerate SUBSTRING length exceeding end indexDomen Vrankar2014-11-131-1/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | string SUBSTRING command now ignores length if it points past end of string and uses end of string instead. String SUBSTRING tests now cover more corner cases.
* | | | | | | | Help: Document add_custom_command marking outputs GENERATEDBrad King2014-11-141-0/+2
| | | | | | | |
* | | | | | | | Help: Revise and format 'add_custom_target' docsBrad King2014-11-131-29/+64
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Format the reStructuredText markup manually. Organize the command options into a definition list. Use inline markup to cross-reference related documents.
* | | | | | | | Merge topic 'add-FindIntl'Brad King2014-11-131-0/+5
|\ \ \ \ \ \ \ \ | |/ / / / / / / |/| | | | | | | | | | | | | | | | | | | | | | | b015b469 Help: Add notes for topic 'add-FindIntl'
| * | | | | | | Help: Add notes for topic 'add-FindIntl'Brad King2014-11-131-0/+5
| | | | | | | |
* | | | | | | | Merge topic 'add-FindIntl'Brad King2014-11-132-0/+2
|\ \ \ \ \ \ \ \ | |/ / / / / / / | | | | | | | | | | | | | | | | | | | | | | | | c5e797db FindIntl: New module to find Gettext libintl
| * | | | | | | FindIntl: New module to find Gettext libintlRoger Leigh2014-11-112-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add support for Sun/Uniforum/GNU gettext libintl. This belongs in CMake rather than upstream because: * There are multiple upstreams (Sun, GNU). * It may or may not be in the glibc C library depending upon the platform and build options used. Although we already have a FindGettext module, that is for the tools. This module is for the library, and is independent because it's perfectly OK to use libintl without the gettext tools (and vice versa), and they might not all be found. Add cross references between the two modules in notes to make the relationship clearer.
* | | | | | | | Merge topic 'doc-install-SCRIPT-CODE-COMPONENT'Brad King2014-11-131-1/+2
|\ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 7361e810 Help: Document COMPONENT option of install(SCRIPT/CODE) (#14956)
| * | | | | | | | Help: Document COMPONENT option of install(SCRIPT/CODE) (#14956)Brad King2014-11-131-1/+2
| | |_|_|_|_|_|/ | |/| | | | | |
* | | | | | | | Merge topic 'ExternalProject_UPDATE_DISCONNECTED'Brad King2014-11-131-0/+6
|\ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 3c497f11 Help: Add notes for topic 'ExternalProject_UPDATE_DISCONNECTED' aba5cec6 ExternalProject: Add unit tests for UPDATE_DISCONNECTED 3f606fa7 ExternalProject: Add UPDATE_DISCONNECTED option c0b749cf ExternalProject: Always add a command to a step
| * | | | | | | | Help: Add notes for topic 'ExternalProject_UPDATE_DISCONNECTED'Brad King2014-11-131-0/+6
| | | | | | | | |
* | | | | | | | | Merge topic 'doc-CMAKE_INSTALL_PREFIX-link-GNUInstallDirs'Brad King2014-11-121-0/+5
|\ \ \ \ \ \ \ \ \ | | |_|_|_|_|_|/ / | |/| | | | | | | | | | | | | | | | | | | | | | | | | 00d4cdc9 Help: Link to GNUInstallDirs from CMAKE_INSTALL_PREFIX (#15246)
| * | | | | | | | Help: Link to GNUInstallDirs from CMAKE_INSTALL_PREFIX (#15246)Brad King2014-11-121-0/+5
| | |/ / / / / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a note to the CMAKE_INSTALL_PREFIX documentation that refers readers to the GNUInstallDirs module to make the latter easier to discover.
* | | | | | | | Merge topic 'emacs-mode-underscore-in-symbol'Brad King2014-11-121-0/+4
|\ \ \ \ \ \ \ \ | |_|_|/ / / / / |/| | | | | | / | | |_|_|_|_|/ | |/| | | | | | | | | | | | cb80e513 Help: Add 3.1 release note Emacs mode update 30f14aeb cmake-mode.el: syntax of '_' should be treated as symbol
| * | | | | | Help: Add 3.1 release note Emacs mode updateBrad King2014-11-121-0/+4
| | |_|/ / / | |/| | | |
| * | | | | Merge branch 'doc-FindITK-FindVTK-relnotes' into releaseBrad King2014-11-071-4/+11
| |\ \ \ \ \
* | \ \ \ \ \ Merge topic 'doc-cleanup-xrefs'Brad King2014-11-073-4/+4
|\ \ \ \ \ \ \ | | |_|_|_|_|/ | |/| | | | | | | | | | | | | | | | | | | 4c8c442d Help: Fix broken cross-references reported by 'nitpicky' option
| * | | | | | Help: Fix broken cross-references reported by 'nitpicky' optionBrad King2014-11-073-4/+4
| |/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | Enable the Sphinx 'nitpicky' option and fix the resulting warnings about dangling references.
| * | | | | Merge branch 'release-doc-formatting' into releaseBrad King2014-11-0715-23/+98
| |\ \ \ \ \
| * \ \ \ \ \ Merge branch 'fix-configure_file-COPYONLY' into releaseBrad King2014-11-031-1/+1
| |\ \ \ \ \ \
| * \ \ \ \ \ \ Merge branch 'doc-add_library-typo' into releaseBrad King2014-10-311-1/+1
| |\ \ \ \ \ \ \