summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* project: Only check non-cache vars when setting project varsCraig Scott2024-10-071-4/+20
| | | | | | | | | | | | | | The change in commit 86ad7cc886 (project: Only define non-cache vars if already defined, 2024-09-15, v3.30.4~2^2) was meant to only check for non-cache variables when deciding whether to set non-cache project variables for the current call. However, it erroneously checked for any variable, including cache variables. This gives the intended result on the first run, but on subsequent runs a cache variable will exist that did not on the first run, leading to different behavior between the two runs. Fix the logic to only check for a pre-existing non-cache variable, as was originally intended. Fixes: #26355
* project: Only define non-cache vars if already definedCraig Scott2024-09-201-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In c1ece78d11 (project: non cache <project> prefix variables are also created, 2024-08-27), we started explicitly setting the non-cache variable for <projectName>_SOURCE_DIR, <projectName>_BINARY_DIR, and <projectName>_IS_TOP_LEVEL in addition to setting them as cache variables. This changed the behavior when a project name was used more than once, and the second project call happens in the same scope or a child scope of the first. Previously, the first project call would set cache variables, and the second project call would not overwrite those cache variables. With the change in c1ece78d11, after the second project call the non-cache variables would mask the cache variables and the project code would see a different value to what it did before. Setting the non-cache variable was added to handle the case where a call to FetchContent_MakeAvailable() would set some non-cache variables, and it just so happened those matched the same cache variables that the project() command would set in the project being fetched. The fetched project would then see a different set of project-specific variables compared to when it was built standalone. This commit here narrows the change from c1ece78d11 such that the non-cache variable is only set by project() if there was already a non-cache variable set. This still fixes the motivating problem c1ece78d11 was intended to solve, but it avoids changing the variable values seen by a project that re-uses the same project name in related scopes. Issue: #26243, #25714 Fixes: #26281
* Help: State valid scopes for using proj_SOURCE_DIR and proj_BINARY_DIRCraig Scott2024-09-201-2/+9
| | | | Issue: #25714
* Help: file(CONFIGURE) only updates output file timestamp if it changesCraig Scott2024-09-061-1/+3
|
* Help: Fix typo in add_test documentationBrad King2024-07-261-1/+1
|
* Merge topic 'doc-add_subdirectory-EXCLUDE_FROM_ALL' into release-3.30Brad King2024-06-061-13/+4
|\ | | | | | | | | | | | | 2449c04d8d Help: improve docs for the EXCLUDE_FROM_ALL directory property Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9497
| * Help: improve docs for the EXCLUDE_FROM_ALL directory propertyAlex Neundorf2024-06-041-13/+4
| | | | | | | | | | | | This patch improves the wording of the documentation of the EXCLUDE_FROM_ALL directory property, and makes the add_subdirectory()- and fetchcontent-documentation refer to it.
* | Merge topic 'file-accept-empty-lists'Brad King2024-06-031-0/+8
|\ \ | | | | | | | | | | | | | | | | | | | | | 7c516f7e28 file(): TOUCH, TOUCH_NOCREATE and MAKE_DIRECTORY accept empty lists Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !9570
| * | file(): TOUCH, TOUCH_NOCREATE and MAKE_DIRECTORY accept empty listsCraig Scott2024-05-311-0/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | Projects may be generating a list of files or directories to pass as arguments to file(TOUCH), file(TOUCH_NOCREATE), or file(MAKE_DIRECTORY). Those lists might end up being empty, so rather than requiring at least one item, allow an empty list. Fixes: #24897
* | | Merge topic 'doc-find_package-typical-usage'Craig Scott2024-06-011-6/+24
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 4b55d56259 Help: Start find_package() docs with a new "Typical Usage" section Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9567
| * | | Help: Start find_package() docs with a new "Typical Usage" sectionCraig Scott2024-05-311-6/+24
| |/ / | | | | | | | | | Fixes: #22680
* | | Merge topic 'dep-provider-try_compile'Brad King2024-05-312-0/+16
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | 4cb5bb014d try_compile: Propagating top level includes into whole-project calls Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Robert Maynard <robertjmaynard@gmail.com> Merge-request: !9532
| * | try_compile: Propagating top level includes into whole-project callsCraig Scott2024-05-302-0/+16
| | | | | | | | | | | | Fixes: #24151
* | | Merge topic 'doc-macro'Brad King2024-05-211-1/+1
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | 67171a99be Help: Fix inaccurate use of "function" in macro docs Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Juan Ramos <juan.ramos@kitware.com> Merge-request: !9534
| * | Help: Fix inaccurate use of "function" in macro docsDave Abrahams2024-05-211-1/+1
| |/
* | Merge topic 'custom-command-output-hash-character'Brad King2024-05-161-0/+6
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 8d2a503c1e add_custom_command: Allow OUTPUT filenames containing a hash '#' character b38000d774 cmGlobalXCodeGenerator: Re-implement legacy makefile path escaping d929089687 cmGlobalXCodeGenerator: Do not use legacy makefile escaping in shell commands d61fc2c52e cmGlobalXCodeGenerator: Migrate legacy makefile path escaping to local helper 6010e007c7 cmState: Add method to check for the Borland Makefiles generator Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9514
| * | add_custom_command: Allow OUTPUT filenames containing a hash '#' characterGlenn Coombs2024-05-151-0/+6
| |/ | | | | | | | | | | | | Most generators now support this character after escaping and quoting cleanups over time. Disallow it only on generators that do support it. Fixes: #25604
* | Help: try_compile how to pass compiler optionsscivision2024-05-121-2/+3
|/ | | | | | it wasn't obvious how to pass compiler options. Since the old add_definitions() is used we can workaround this by passing compiler options there.
* Help: Fix cmake_path exampleJuan Ramos2024-04-261-1/+1
| | | | Fixes: #25938
* Merge topic 'doc-genex'Brad King2024-04-252-6/+6
|\ | | | | | | | | | | | | | | | | | | 263f6b888c Help: Document TARGET_PROPERTY genex handling of transitive properties f70eb84be7 Help: Clarify role of TARGET_NAME generator expression 36145e2680 Help: Organize target-dependent generator expressions into subsections 50eadd794e Help: Clarify cross-references to target-dependent generator expressions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9460
| * Help: Clarify cross-references to target-dependent generator expressionsBrad King2024-04-252-6/+6
| |
* | Merge topic 'help.file'Brad King2024-04-251-318/+324
|\ \ | |/ |/| | | | | | | | | | | | | d2d2ffe1c1 Help: file: document GET_RUNTIME_DEPENDENCIES separately Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: Juan Ramos <juan.ramos@kitware.com> Merge-request: !9456
| * Help: file: document GET_RUNTIME_DEPENDENCIES separatelyJoachim Wuttke (h)2024-04-241-318/+324
| | | | | | | | | | | | | | | | Moved documentation of file(GET_RUNTIME_DEPENDENCIES ...) from the 'Reading' section to a separate section at the bottom of the page. Because it is a very long text, and because this signature is quite different from all the others in the 'Reading' section.
* | Help: Update cmake-buildsystem(7) build and usage requirementsBrad King2024-04-248-8/+8
|/ | | | | | | Re-organize the section to explicitly describe target-specific commands, build properties, and usage requirement properties. Add builtin transitive properties that have been created since the document was first written.
* Help: Clarify documentation on regex character classesMartin Stadler2024-04-111-7/+8
| | | | In particular, give an example of matching `]`.
* enable_language(): Fail if called before project()Craig Scott2024-04-021-6/+10
| | | | Fixes: #25550
* Merge topic 'patch-help-manually-added-dependencies'Brad King2024-04-011-0/+4
|\ | | | | | | | | | | | | e722f73e40 Help: Document MANUALLY_ADDED_DEPENDENCIES in add_dependencies Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9388
| * Help: Document MANUALLY_ADDED_DEPENDENCIES in add_dependenciesPeter Kokot2024-03-291-0/+4
| | | | | | | | | | This adds a note about the MANUALLY_ADDED_DEPENDENCIES target property to the add_dependencies documentation page. It was introduced in v3.8.0.
* | Merge topic 'add_library-no-static-fallback'Brad King2024-04-011-0/+7
|\ \ | | | | | | | | | | | | | | | | | | | | | a61c9afdf8 add_library: Reject shared libraries on platforms that do not support them Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9347
| * | add_library: Reject shared libraries on platforms that do not support themAsit Dhal2024-03-291-0/+7
| |/ | | | | | | | | | | Add policy CMP0164 to provide compatibility. Fixes: #25759
* | file(DOWNLOAD|UPLOAD): Document TLS_VERSION fallback to environment variableBrad King2024-03-291-2/+3
|/ | | | | This was missed by commit 434fe8a34b (file(DOWNLOAD|UPLOAD): Add CMAKE_TLS_VERSION environment variable, 2024-02-26).
* Merge topic 'move-install-note'Brad King2024-03-291-10/+10
|\ | | | | | | | | | | | | 8cbd6f5754 Help: Fix location of install() note about superseded commands Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9382
| * Help: Fix location of install() note about superseded commandsFeRD (Frank Dana)2024-03-281-10/+10
| | | | | | | | | | | | | | The note regarding commands superseded by install() somehow wound up nested under the install(EXPORT) signature, when it has nothing to do with install(EXPORT). Move it to the top level, immediately before the Examples section.
* | add_dependencies: Document behavior under Ninja generatorsJuan Ramos2024-03-281-0/+7
| | | | | | | | Closes: #25796
* | Merge topic 'doc-linker-vars'Brad King2024-03-271-1/+1
|\ \ | |/ | | | | | | | | | | | | | | | | | | 6ba2bbc0f3 Help: Restructure and improve LINKER_TYPE docs c39bc6e412 Help: CMAKE_<LANG>_USING_LINKER_<TYPE> can be a list of flags 1c7ccefd83 Help: Add custom linker example for CMAKE_<LANG>_USING_LINKER_<TYPE> aecea7b28b Help: Grammar, typos and wording improvements for linker variables 5b21897c6e Help: Remove stray formatting for try_compile() LINKER_LANGUAGE keyword Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9362
| * Help: Remove stray formatting for try_compile() LINKER_LANGUAGE keywordCraig Scott2024-03-221-1/+1
| |
| * Merge topic 'doc-release-3.29-typos' into release-3.29Brad King2024-03-191-1/+1
| |\ | | | | | | | | | | | | | | | | | | | | | eceb368ccc Help: Fix typos in 3.29 docs 31fb693d06 Help: Fix typos and grammar in pre-3.29 docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9353
* | \ Merge topic 'doc-release-3.29-typos'Brad King2024-03-191-1/+1
|\ \ \ | | |/ | |/| | | | | | | | | | | | | | | | eceb368ccc Help: Fix typos in 3.29 docs 31fb693d06 Help: Fix typos and grammar in pre-3.29 docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9353
| * | Help: Fix typos in 3.29 docsCraig Scott2024-03-191-1/+1
| | |
* | | Merge topic 'doc-exit-code-range'Brad King2024-03-191-2/+7
|\ \ \ | | |/ | |/| | | | | | | | | | | | | c980745b82 Help: Specify advisable range for exit code in cmake_language(EXIT) Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9352
| * | Help: Specify advisable range for exit code in cmake_language(EXIT)Craig Scott2024-03-191-2/+7
| |/ | | | | | | | | The limitations added here are documented in the bash shell's reference manual.
* | Merge topic 'doc-project-include-vars-3.29'Brad King2024-03-181-6/+6
|\ \ | |/ | | | | | | | | | | | | dcb894fb00 Help: Update project() code injection for new 3.29 include behavior 09cf39ab07 Help: Improve wording of CMAKE_PROJECT_..._INCLUDE... changes for 3.29 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9343
| * Help: Update project() code injection for new 3.29 include behaviorCraig Scott2024-03-161-6/+6
| | | | | | | | | | | | Specifically, the various CMAKE_PROJECT_...INCLUDE... variables can now take a list of things, and those things can be module names too, not just file names.
* | Merge topic 'export-find_dependency-calls'Brad King2024-03-132-2/+10
|\ \ | |/ | | | | | | | | | | | | 3a739d4dcb EXPORT_PACKAGE_DEPENDENCIES: Add experimental feature gate Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9336
| * EXPORT_PACKAGE_DEPENDENCIES: Add experimental feature gateBrad King2024-03-122-2/+10
| | | | | | | | | | | | | | Some design concerns have been raised after trying the 3.29 release candidates. Avoid committing to a stable public interface for now. Issue: #25767
* | Merge topic 'ctest-j-default'Brad King2024-03-111-4/+9
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | 5de1e21659 ctest: Allow passing -j without value to choose a contextual default bbcbcff7d9 cmCTestMultiProcessHandler: Modernize member initialization 7457b474a1 Tests: Remove unnecessary parallel suppression from CTestCoverageCollectGCOV ae69801d96 Tests: Convert CTestTestSkipReturnCode to RunCMake.ctest_test case 30dda49416 Tests: Convert CTestTestSerialOrder to RunCMake.ctest_test case Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: scivision <michael@scivision.dev> Merge-request: !9315
| * ctest: Allow passing -j without value to choose a contextual defaultBrad King2024-03-101-4/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | Under job server integration, added by commit 80fe56c481 (ctest: Add support for running under a make job server on POSIX systems, 2023-11-15, v3.29.0-rc1~324^2), use a very high default so that parallelism is effectively limited only by available job server tokens. Otherwise, choose a default limit based on the number of processors. Also allow passing `0` to specify unbounded parallelism. Fixes: #25739
* | Merge topic 'Help-add_custom_command-grammo'Brad King2024-02-291-1/+1
|\ \ | |/ | | | | | | | | | | b03356f954 Help/add_custom_command: fix verb grammo Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9297
| * Help/add_custom_command: fix verb grammoBen Boeckel2024-02-281-1/+1
| |
| * Merge topic 'Help-file-ARCHIVE_EXTRACT-mention-working-dir' into release-3.29Brad King2024-02-271-0/+7
| |\ | | | | | | | | | | | | | | | | | | 189d28d77d Help/file: mention the working directory for `ARCHIVE_EXTRACT` Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9291
generated by cgit v0.12 at 2026-01-17 16:36:25 (GMT)