summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'scripting-commands'Brad King2018-10-2441-319/+472
|\ | | | | | | | | | | | | c2efb3efcd Help: Revise docs on Scripting Commands Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2504
| * Help: Revise docs on Scripting CommandsJoachim Wuttke (l)2018-10-2341-319/+472
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Revise docs for all "Scripting Commands", except four find_XXX that use a macro suite of their own. * Take full advantage of the improved syntax highlighting. * Make consequential use of <..> placeholders. * Clarify things here and there in the text. Specific improvements to some command docs: * "math": Correct description of novel hexadecimal capability. * "if", "foreach", "while": Provide link to "endif" etc * "foreach", "while": Mention "break" and "continue". * "foreach": Simplify explanation of ``RANGE`` and ``IN`` signatures; advise against negative arguments or reverse ranges (compare issue #18461) * "endif", "endfunction" etc: Explain that the argument is optional and maintained for compatibility only
* | ExternalProject: option LOG_MERGED_STDOUTERR to combine stdout and stderrWouter Klouwen2018-10-191-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | In some circumstances the user of ExternalProject may not desire the split log files for stdout and stderr. In particular with a project has many errors it can be difficult to correlate the output error with the command that it resulted from. This commit adds the LOG_MERGED_STDOUTERR option that when enabled outputs into a unified <name>-<step>.log for each step. If disabled it will default to the previous behaviour of <name>-<step>-out.log and <name>-<step>-err.log.
* | Merge topic 'find_fontconfig'Brad King2018-10-193-0/+8
|\ \ | | | | | | | | | | | | | | | | | | 84e7920b3a FindFontconfig: Add module to find Fontconfig Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2487
| * | FindFontconfig: Add module to find FontconfigFrederik Gladhorn2018-10-183-0/+8
| | | | | | | | | | | | This module is inspired by one from KDE's KWin.
* | | Merge topic 'doc-target_link_libraries-item-quoting'Brad King2018-10-191-0/+12
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | 18cff26e3a Help: Clarify command-line encoding of target_link_libraries items Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2503
| * | Help: Clarify command-line encoding of target_link_libraries itemsBrad King2018-10-181-0/+12
| | | | | | | | | | | | | | | | | | | | | | | | Items that have full paths will be quoted automatically. Other items are treated as command-line string fragments and get no automatic escaping. Document the behavior for each item kind. Fixes: #18467
* | | Merge topic 'help-syntax-highlighting'Craig Scott2018-10-193-13/+16
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 93f3f65516 Help: Revise docs of modules AddFileDependencies..CheckFunctionExists fc7ee1ca45 Help: Override pygments CMakeLexer to support <..> and [..] 74b3eacdc7 Help: Use appropriate list types in FindPkgConfig Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2468
| * | | Help: Override pygments CMakeLexer to support <..> and [..]Joachim Wuttke (o)2018-10-183-13/+16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * The code snippets in the docs consist of CMake code mixed with syntax definition punctuation like < > [ ] ... Therefore a pure CMake lexer is inadequate. Here it is replaced by a CMake syntax definition parser. * Fixed syntax definition snippets in FindPkgConfig.cmake to make best use of syntax highlighting. This source file is the hardest to support because it contains comparison operators <= = >=, which need special attention to avoid confusion with the placeholder indicators <...>. * Fixed syntax in execute_process.rst (there were unbalanced brackets). * Disabled syntax highlighting for long string examples in cmake-language.7.rst. * No highlighting of removed syntax in CMP0049 * To inspect the outcome of this patch, see e.g. the pages * manual/cmake-buildsystem.7.html * module/ExternalProject.html * module/FindPkgConfig.html which are particularly rich in complex code snippets.
* | | | Merge topic 'rel-doc-qthelp'Brad King2018-10-181-0/+3
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 1d5c8b81db Utilities/Release: Add qthelp docs to binary archives Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2497
| * | | | Utilities/Release: Add qthelp docs to binary archivesBrad King2018-10-171-0/+3
| | | | | | | | | | | | | | | | | | | | Fixes: #18465
* | | | | Merge topic 'revert-server-iface-sources'Brad King2018-10-181-7/+0
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 284a38e42f cmake-server: Revert "Support codemodel filegroups for INTERFACE_SOURCES" Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2495
| * | | | | cmake-server: Revert "Support codemodel filegroups for INTERFACE_SOURCES"Brad King2018-10-171-7/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Revert commit v3.13.0-rc1~144^2 (cmake-server: Support codemodel filegroups for INTERFACE_SOURCES, 2018-08-10). The changes activate code paths not meant to be used with interface libraries. Another approach will be needed to expose this information later. This revert has to be done by hand because the code in question has been changed somewhat since the changes were made, and was also factored out to another source file. Fixes: #18463
* | | | | | Merge topic 'better-empty-list-behavior'Brad King2018-10-171-0/+9
|\ \ \ \ \ \ | |_|_|/ / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 121a036f73 cmListCommand: handle empty lists for list(REMOVE_AT) acfe53c588 cmListCommand: make list(ACTION not_a_list) succeed when idempotent bf572ac952 cmListCommand: check list(FILTER) operation before the list Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2478
| * | | | | cmListCommand: handle empty lists for list(REMOVE_AT)Ben Boeckel2018-10-161-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Treat an empty list as a list with no valid bounds and return an error message indicating that any given indices are out-of-bounds.
| * | | | | cmListCommand: make list(ACTION not_a_list) succeed when idempotentBen Boeckel2018-10-161-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The operations changed here all are no-ops on empty lists anyways, so just have them succeed when given non-extant lists. - `list(REMOVE_ITEM)` - `list(REMOVE_DUPLICATES)` - `list(SORT)` - `list(FILTER)` - `list(REVERSE)`
* | | | | | Merge topic 'document-dollar-in-varnames'Brad King2018-10-162-2/+7
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 82a4822610 CMP0053: document that `$` is a valid literal variable character Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2479
| * | | | | | CMP0053: document that `$` is a valid literal variable characterBen Boeckel2018-10-152-2/+7
| | |/ / / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This was overlooked in the initial implementation of CMP0053. However, an additional policy to reject it again is not worth it. Instead, add tests and document the behavior. Fixes: #17883
* | | | | | Merge topic 'update_debug_target_properties'Brad King2018-10-151-7/+16
|\ \ \ \ \ \ | |_|_|_|_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | 86921f0264 Help: document CMAKE_DEBUG_TARGET_PROPERTIES support for LINK properties Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2480
| * | | | | Help: document CMAKE_DEBUG_TARGET_PROPERTIES support for LINK propertiesRobert Maynard2018-10-121-7/+16
| | |_|/ / | |/| | |
| * | | | Merge branch 'doc-regex-backslash' into release-3.13Brad King2018-10-091-6/+13
| |\ \ \ \ | | |_|_|/ | |/| | | | | | | | Merge-request: !2460
| * | | | Merge branch 'doc-target_link_libraries-keywords-not-genex' into release-3.13Brad King2018-10-081-6/+18
| |\ \ \ \ | | | | | | | | | | | | | | | | | | Merge-request: !2449
| * \ \ \ \ Merge branch 'project-always-set-desc-url' into release-3.13Brad King2018-10-081-0/+2
| |\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | Merge-request: !2457
| * \ \ \ \ \ Merge branch 'add_ctest_progress_docs' into release-3.13Brad King2018-10-083-4/+32
| |\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | Merge-request: !2454
| * \ \ \ \ \ \ Merge branch 'list-SORT-docs' into release-3.13Brad King2018-10-081-11/+15
| |\ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | Merge-request: !2453
| * \ \ \ \ \ \ \ Merge branch 'doc-find_package-update' into release-3.13Brad King2018-10-051-35/+48
| |\ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Merge-request: !2446
| * \ \ \ \ \ \ \ \ Merge branch 'doc-osx-vars-as-cache' into release-3.13Brad King2018-10-041-0/+2
| |\ \ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Merge-request: !2443
| * \ \ \ \ \ \ \ \ \ Merge branch 'pkgc-op-lt-gt' into release-3.13Brad King2018-10-041-0/+4
| |\ \ \ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Merge-request: !2435
| * \ \ \ \ \ \ \ \ \ \ Merge branch 'misc-typos' into release-3.13Brad King2018-10-041-1/+1
| |\ \ \ \ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Merge-request: !2440
| * \ \ \ \ \ \ \ \ \ \ \ Merge branch 'doc-cmp0077' into release-3.13Brad King2018-10-042-6/+44
| |\ \ \ \ \ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Merge-request: !2439
| * | | | | | | | | | | | | Help: Drop development topic notes to prepare releaseBrad King2018-10-032-9/+0
| | |_|_|_|_|_|_|_|_|_|/ / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Release versions do not have the development topic section of the CMake Release Notes index page.
* | | | | | | | | | | | | Merge topic 'cppcheck-exit-code'Brad King2018-10-122-1/+9
|\ \ \ \ \ \ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 3b80cd77fb Fail the build if cppcheck returns a non-zero exit code Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2459
| * | | | | | | | | | | | | Fail the build if cppcheck returns a non-zero exit codeHarald Brinkmann2018-10-112-1/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This allows the build failure to be tuned with cppcheck's options --error-exitcode=<n> and --exitcode-suppressions=<file>.
* | | | | | | | | | | | | | Merge topic 'find_libinput'Brad King2018-10-123-0/+8
|\ \ \ \ \ \ \ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | f76047f34a FindLibinput: Add module to find libinput Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2420
| * | | | | | | | | | | | | | FindLibinput: Add module to find libinputFrederik Gladhorn2018-10-113-0/+8
| | |_|_|_|_|_|_|_|_|_|_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This module is inspired by one from KDE's KWin.
* | | | | | | | | | | | | | Merge branch 'backport-revert-install-code-script-genex' into ↵Brad King2018-10-112-7/+0
|\ \ \ \ \ \ \ \ \ \ \ \ \ \ | |/ / / / / / / / / / / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | revert-install-code-script-genex
| * | | | | | | | | | | | | install: Revert CODE,SCRIPT support for generator expressionsBrad King2018-10-112-7/+0
| | |/ / / / / / / / / / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Revert commit v3.13.0-rc1~441^2 (install: Teach CODE,SCRIPT modes to evaluate generator expressions, 2018-05-29). Unfortunately it has been found to break existing code in a real project, e.g. install(CODE [[ message("$<FOOBAR>") ]]) Address this regression by reverting support for the 3.13 release series. Support can be restored later with a policy for compatibility. Issue: #15785 Fixes: #18435
* | | | | | | | | | | | | Merge topic 'install-subdirectory-order'Brad King2018-10-114-0/+39
|\ \ \ \ \ \ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | b56f2db87a Testing: Add test for CMP0082 fc8955e889 add_subdirectory: Run subdirectory install rules in correct order 514f0b572e Testing: Update hard-coded line numbers to [0-9]+ in some tests Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2434
| * | | | | | | | | | | | | add_subdirectory: Run subdirectory install rules in correct orderKyle Edwards2018-10-104-0/+39
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Before this change, install rules created by add_subdirectory() would be executed after all of the top-level install rules, even if they were declared before the top-level rules. This change adds a new policy, CMP0082, which interleaves the add_subdirectory() install rules with the other install rules so they are run in the correct order.
* | | | | | | | | | | | | | Merge topic 'ctest-done'Brad King2018-10-112-0/+6
|\ \ \ \ \ \ \ \ \ \ \ \ \ \ | |/ / / / / / / / / / / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | a6e0158712 ctest_submit: Add support for a "Done" part f460bbd4c8 ctest_submit: Refactor file list to use a vector instead of a set Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Zack Galbreath <zack.galbreath@kitware.com> Merge-request: !2405
| * | | | | | | | | | | | | ctest_submit: Add support for a "Done" partBetsy McPhail2018-10-102-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Teach CTest to submit Done.xml. Submission of this file indicates to CDash that a build is complete and no more files will be uploaded. It contains the build id returned by CDash and the current time. This file is submitted last for a given build when using the `ctest_submit()` command. If submitting by PARTS, use `ctest_submit(PARTS Done)`.
* | | | | | | | | | | | | | Merge topic 'module-index-restructure'Craig Scott2018-10-101-36/+66
|\ \ \ \ \ \ \ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | dc372f6eef Help: Document Use_wxWindows.cmake as deprecated 846e3d2ceb Help: Reorganise module index into sections c9cedd675b Help: Add link to cmake-qt(7) to FindQt.cmake. Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2463
| * | | | | | | | | | | | | | Help: Document Use_wxWindows.cmake as deprecatedCraig Scott2018-10-091-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The implementation already logged a message saying that the module was deprecated. This change adds that message to the module docs.
| * | | | | | | | | | | | | | Help: Reorganise module index into sectionsJoachim Wuttke (l)2018-10-091-37/+66
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Split up module list into separate sections for utility modules and find modules. * Improve wording to explain how the different module types are expected to be called/used. * Move deprecated modules to their own separate sections.
* | | | | | | | | | | | | | | Merge topic 'project-version'Brad King2018-10-101-59/+88
|\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2f43bd3b6c Help: move description of CMAKE_PROJECT_* variables e3e5445d83 Help: Describe options of command project in a definition list. 5b56795d57 Help: make the two signatures of command "project" orthogonal Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2450
| * | | | | | | | | | | | | | | Help: move description of CMAKE_PROJECT_* variablesJoachim Wuttke (o)2018-10-091-8/+16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Describe these variables along with the other variables.
| * | | | | | | | | | | | | | | Help: Describe options of command project in a definition list.Joachim Wuttke (l)2018-10-091-51/+72
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Also add section headers; explain default setting of optional argument variables.
| * | | | | | | | | | | | | | | Help: make the two signatures of command "project" orthogonalJoachim Wuttke (l)2018-10-091-1/+1
| |/ / / / / / / / / / / / / /
* | | | | | | | | | | | | | | Help: Make synopsis of if command more compact; add section headersJoachim Wuttke (l)2018-10-091-41/+49
|/ / / / / / / / / / / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Also replace 'expression' by 'condition' (as in the while command); relegate optional arguments of else() and endif() to the text; revise explanation of operator precedence in Condition Syntax section.
* | | | | | | | | | | | | | Merge topic 'doc-regex-backslash'Brad King2018-10-091-6/+13
|\ \ \ \ \ \ \ \ \ \ \ \ \ \ | | |_|_|_|_|_|_|_|_|_|_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | fab2c2339b Help: Fix documentation of escape sequences in a regex Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2460
generated by cgit v0.12 at 2025-02-05 22:54:37 (GMT)