summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* 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 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 'list-SORT-docs' into release-3.13Brad King2018-10-081-11/+15
| |\ \ \ | | | | | | | | | | | | | | | Merge-request: !2453
* | | | | Help: Override pygments CMakeLexer to support <..> and [..]Joachim Wuttke (o)2018-10-181-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * 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 branch 'backport-revert-install-code-script-genex' into ↵Brad King2018-10-111-4/+0
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | revert-install-code-script-genex
| * | | | | install: Revert CODE,SCRIPT support for generator expressionsBrad King2018-10-111-4/+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 'ctest-done'Brad King2018-10-111-0/+1
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-101-0/+1
| |/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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 '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
| * | | | | | Help: Fix documentation of escape sequences in a regexBrad King2018-10-091-6/+13
| |/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Documentation added by commit 4b35dab891 (Help: Document how escape sequences work in a regex, 2018-07-18) is only correct for backslashes inside `[]` groups. The regex engine does interpret `\` escapes elsewhere. Fix the docs. Inspired-by: R2RT <artur.ryt@gmail.com> Fixes: #18428
* | | | | | Merge topic 'doc-target_link_libraries-keywords-not-genex'Brad King2018-10-091-6/+18
|\ \ \ \ \ \ | | |_|_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | cd8c79e163 Help: Clarify target_link_libraries keywords and generator expressions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2449
| * | | | | Help: Clarify target_link_libraries keywords and generator expressionsBrad King2018-10-081-6/+18
| |/ / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The `optimized` and `debug` keyword items are meaningful only to the `target_link_libraries` command and have no meaning when produced by a generator expression. State this explicitly. Also recommend use of a quoted argument when the genex itself may contain a semicolon. Fixes: #18424
* | | | | Merge topic 'project-always-set-desc-url'Brad King2018-10-081-0/+2
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | f8a086a86b project(): Ensure DESCRIPTION and HOMEPAGE_URL variables are set b27247c8df project(): Add tests verifying variables set by second project() call Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2457
| * | | | project(): Ensure DESCRIPTION and HOMEPAGE_URL variables are setCraig Scott2018-10-071-0/+2
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | If a project() call does not have DESCRIPTION or HOMEPAGE_URL options, it must still set the relevant variables or else those variables will inherit values from an earlier project() call. That is inconsistent with how VERSION is handled and is likely to be unexpected. The docs were also ambiguous about what should happen in such cases.
* | | | Merge topic 'list-SORT-docs'Brad King2018-10-081-11/+15
|\ \ \ \ | |_|/ / |/| | / | | |/ | |/| | | | | | | cdf8d79e9f Help: Improve/fix incorrect docs for list(SORT) sub-options Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2453
| * | Help: Improve/fix incorrect docs for list(SORT) sub-optionsCraig Scott2018-10-061-11/+15
| |/
* | Help: Clarify find_package Module and Config mode relationJoachim Wuttke (l)2018-10-041-17/+17
| |
* | Help: Remove redundant recommendationBrad King2018-10-041-12/+4
| | | | | | | | | | We suggest that users prefer the basic signature in two places. Drop the latter and move its related content to a better section.
* | Help: Add internal section link to find_package command docsJoachim Wuttke (l)2018-10-041-6/+8
| |
* | Help: Add section headers to find_package commandJoachim Wuttke (l)2018-10-041-0/+15
| | | | | | | | | | The document is pretty long but is already mostly organized into sections. Add explicit section headers.
* | Help: Move find_package NO_POLICY_SCOPE to more appropriate locationJoachim Wuttke (l)2018-10-041-3/+3
| |
* | Help: Add table of contents to find_package command docsJoachim Wuttke (l)2018-10-041-0/+4
| |
* | Help: Rephrase summary in find_package command docsJoachim Wuttke (l)2018-10-041-1/+1
|/
* Help: Add note about CMAKE_INSTALL_DEFAULT_DIRECTORY_PERMISSIONSKyle Edwards2018-10-011-0/+7
|
* Merge topic 'customcommandworkingdirectory'Brad King2018-09-282-0/+6
|\ | | | | | | | | | | | | f158ac19e1 add_custom_{command,target}: WORKING_DIRECTORY generator expressions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2409
| * add_custom_{command,target}: WORKING_DIRECTORY generator expressionsJon Chronopoulos2018-09-282-0/+6
| | | | | | | | | | | | | | This teaches add_custom_command and add_custom_target WORKING_DIRECTORY about generator expressions Fixes: #14089
* | link_directories(): enhance capabilitiesMarc Chevrier2018-09-251-1/+7
| |
* | LINK_DIRECTORIES: Add new properties and commandsMarc Chevrier2018-09-252-9/+90
|/ | | | | | | | | | | | These new capabilities enable to manage link directories Two new properties: * target properties: LINK_DIRECTORIES and INTERFACE_LINK_DIRECTORIES One new command * target_link_directories(): to populate target properties Fixes: #17215
* Help: Clarify handling of non-integer components in if() version testsCraig Scott2018-09-171-5/+15
|
* Merge topic 'out-of-dir-linking'Brad King2018-09-141-4/+7
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | a1ad0a699b target_link_libraries: Allow use with targets in other directories 9bbae5ae28 cmTarget: Future-proof AddLinkLibrary target lookup scope f9cb6f618a cmExportFileGenerator: Use cmGeneratorTarget::ResolveTargetReference 18441a6269 cmGeneratorTarget: Factor target name resolution out of link item resolution 2f708f5d65 Make internal TARGET_PROPERTY generator expressions more robust 94a75801c8 Android.mk: De-duplicate link libraries logic during export 8a63b23d16 cmGlobalGenerator: Remove unused FindLocalGenerator method Acked-by: Kitware Robot <kwrobot@kitware.com> Reviewed-by: Patrick Stotko <stotko@cs.uni-bonn.de> Merge-request: !2370
| * target_link_libraries: Allow use with targets in other directoriesBrad King2018-09-121-4/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Previously the command did not allow naming targets on the LHS that were not created in the calling directory. Lift this restriction to enable more flexible use by projects. Targets named on the RHS will need to be looked up during generation in the scope of the call site rather than the scope of the LHS target. Introduce an internal syntax in `[INTERFACE_]LINK_LIBRARIES` properties to specify target names that need to be looked up in a directory other than that containing the target on which the property is set. Add minimal documentation of the syntax to help users that encounter it. Unfortunately CMake previously did allow such calls in the case that only `INTERFACE` libraries are specified, but those libraries would be looked up in the target's directory rather than the caller's. Add policy `CMP0079` to enable the new behavior with new lookup scope in a compatible way. Fixes: #17943
* | Merge topic 'replace-os-x-name-with-macos'Brad King2018-09-114-8/+8
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | ab2e35d614 Replace occurrences of "Mac OS X" with "macOS" in comments fc1602456a Help: Replace occurrences of "Mac OS X" with "macOS" Acked-by: Kitware Robot <kwrobot@kitware.com> Reviewed-by: Gregor Jasny <gjasny@googlemail.com> Reviewed-by: Clinton Stimpson <clinton@elemtech.com> Merge-request: !2351
| * | Help: Replace occurrences of "Mac OS X" with "macOS"Bartosz Kosiorek2018-09-054-8/+8
| | | | | | | | | | | | | | | | | | | | | | | | Apple's main Operating system changed their name from OS X to macOS: https://www.engadget.com/2016/06/13/os-x-is-now-macos/ Revise documentation accordingly.
* | | Merge topic 'docs/setdirproprs'Brad King2018-09-111-4/+3
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | | | | 6d8cabe8d4 Help: Clarify INCLUDE_DIRECTORIES directory property behavior 7b9d8ce168 Help: Clarify wording of set_directory_properties docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2337
| * | Help: Clarify wording of set_directory_properties docsBrian Heim2018-09-101-4/+3
| |/
* | Help: Clarify cmake_host_system_information memory unitsTaylor Holberton2018-09-101-4/+8
|/ | | | | | The memory size query implementations report in units of one mebibyte (2^20). Clarify the unit in the documentation because "megabyte" might also be interpreted as 10^6.
* Help: Add CAPTURE_CMAKE_ERROR to ctest_submit and ctest_update documentationBetsy McPhail2018-08-292-1/+13
| | | | | Also, added CAPTURE_CMAKE_ERROR to vim synax file for ctest_submit, ctest_update and ctest_memcheck.
* Help: Document alternative to include_directoriesDavid Demelier2018-08-231-0/+6
| | | | | | Many existing tutorials suggest `include_directories` but that does not handle propagation to dependencies and such. Add a link to its documentation suggesting `target_include_directories` instead.
* Help: Clarify the unset commandRobert Maynard2018-08-211-3/+10
|
* Help: Add RETURN_VALUE as an option to ctest_submit(CDASH_UPLOADBetsy McPhail2018-08-151-2/+3
|
* Merge topic 'doc-consistently-reference-packagename'Craig Scott2018-08-152-42/+42
|\ | | | | | | | | | | | | 30d08bdce9 doc: Consistently use <PackageName> for describing the name of a package Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2283
| * doc: Consistently use <PackageName> for describing the name of a packageJean-Christophe Fillion-Robin2018-08-142-42/+42
| |
* | Help: Document when LINK_FLAGS and STATIC_LIBRARY_FLAGS are usedRobert Maynard2018-08-091-1/+1
|/