summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'help_toplevel'Brad King2021-07-082-0/+20
|\ | | | | | | | | | | | | 2df4badc5f Help: Note PROJECT_IS_TOP_LEVEL behavior w.r.t. ExternalProject Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6307
| * Help: Note PROJECT_IS_TOP_LEVEL behavior w.r.t. ExternalProjectMichael Hirsch2021-07-082-0/+20
| | | | | | | | | | | | | | Extend the documentation added by commit 96a7040107 (project: Define variables indicating whether project is top level, 2021-03-24, v3.21.0-rc1~443^2) to give some examples of how the variables are set in each context.
* | Merge topic 'doc-lang-std'Brad King2021-07-083-3/+54
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | d69b46bf01 Help: Document when CUDA_STANDARD values were added bdb59839b9 Help: Document when OBJCXX_STANDARD values were added 627aca946b Help: Document when OBJC_STANDARD values as definition list Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6321
| * | Help: Document when CUDA_STANDARD values were addedBrad King2021-07-081-1/+23
| | | | | | | | | | | | | | | | | | | | | | | | Note that some CUDA C++ language standard levels were added before any compilers actually supported them. In such cases, the value of `CUDA_STANDARD` gracefully degrades to the highest supported by the compiler (unless `CUDA_STANDARD_REQUIRED` is enabled). Therefore we can document support for each value based on when CMake learned of it.
| * | Help: Document when OBJCXX_STANDARD values were addedBrad King2021-07-081-1/+21
| | |
| * | Help: Document when OBJC_STANDARD values as definition listBrad King2021-07-081-1/+10
| |/
* | find_package: Add variable to make package REQUIREDEugene Shalygin2021-07-086-3/+34
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a `CMAKE_REQUIRE_FIND_PACKAGE_<PackageName>` variable is complement to `CMAKE_DISABLE_FIND_PACKAGE_<PackageName>` with just the opposite behaviour: it turns non-required find_package call into the required one. While optional package dependencies usually result in simple and clean build logic, sometimes people want to be sure those optional dependencies will be found and used. Examples are reproducible builds and build instructions for 3rd parties. People choose to make find_package calls REQUIRED and put them behind an option(). Such workarounds blend build logic with build environment management and do not look elegant.
* | Merge topic 'help_cxxstd'Brad King2021-07-071-1/+25
|\ \ | |/ | | | | | | | | | | 5650bebc2f Help: Note CXX_STANDARD values added vs. CMake version Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6305
| * Help: Note CXX_STANDARD values added vs. CMake versionMichael Hirsch2021-07-061-1/+25
| |
* | Merge topic 'doc-3.21-release'Craig Scott2021-07-062-61/+75
|\ \ | |/ | | | | | | | | | | | | | | 24b76eaa93 Help: Improve readability and accuracy of runtime deps-related content 308e5b30c9 Help: Tighten install(SCRIPT) wording for ALL_COMPONENTS option 52dec01729 Help: Add missing versionadded 3.21 for file(RENAME) options Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6302
| * Help: Improve readability and accuracy of runtime deps-related contentCraig Scott2021-07-042-55/+64
| | | | | | | | | | | | Duplicated textual patterns are factored out to make the text more readable. The POST_INCLUDE_FILES and POST_EXCLUDE_FILES were also previously missing from the main syntax block for install(RUNTIME_DEPENDENCY_SET).
| * Help: Tighten install(SCRIPT) wording for ALL_COMPONENTS optionCraig Scott2021-07-031-6/+7
| | | | | | | | | | In particular, mention the mutually exclusive nature with the COMPONENT option. Fix the inconsistent way the versionadded details were added for that text too.
| * Help: Add missing versionadded 3.21 for file(RENAME) optionsCraig Scott2021-07-031-0/+4
| |
| * Merge topic 'help_cstd' into release-3.21Brad King2021-07-021-1/+20
| |\ | | | | | | | | | | | | | | | | | | 9c310ff075 Help: Note C_STANDARD values added in CMake 3.21 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6294
* | \ Merge topic 'ctest_not_dart'Brad King2021-07-021-13/+19
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 0962cbf21d help: update ctest attached file example 5489ce74b3 ctest: support <CTestMeasurement> for runtime measurements 7817aa6fa4 ctest: improve test for runtime labels Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6296
| * | | help: update ctest attached file exampleZack Galbreath2021-07-011-2/+4
| | | | | | | | | | | | | | | | Clarify that multiple files can be attached to a given test at runtime
| * | | ctest: support <CTestMeasurement> for runtime measurementsZack Galbreath2021-07-011-13/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Teach CTest to parse output for <CTestMeasurement> in addition to <DartMeasurement> for measurements defined at runtime. Use a new class (cmCTestTestMeasurementXMLParser) derived from cmXMLParser to parse the data and attributes these XML elements. This is an improvement over our previous approach of using a series of regular expressions. As part of this commit we also rename some member variables and methods to make their purpose more clear. DartStuff -> AllTestMeasurementsRegex DartStuff1 -> SingleTestMeasurementRegex DartString -> TestMeasurementsOutput GenerateDartOutput() -> GenerateCTestXML() GenerateRegressionImages() -> RecordCustomTestMeasurements() cmCTestRunTest::DartProcessing() -> ParseOutputForMeasurements()
* | | | Merge topic 'help_cstd'Brad King2021-07-021-1/+20
|\ \ \ \ | | |_|/ | |/| | | | | | | | | | | | | | | | | | 9c310ff075 Help: Note C_STANDARD values added in CMake 3.21 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6294
| * | | Help: Note C_STANDARD values added in CMake 3.21Michael Hirsch2021-07-011-1/+20
| | | | | | | | | | | | | | | | Issue: #22366
* | | | cmake: Allow CMAKE_CONFIGURATION_TYPES to be set by environment variableBrad King2021-06-304-1/+19
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When no `CMAKE_CONFIGURATION_TYPES` is explicitly specified while creating a new build tree, check for an environment variable of the same name. Issue: #20983
* | | | cmake: Allow CMAKE_BUILD_TYPE to be set by environment variableBrad King2021-06-304-2/+19
| | | | | | | | | | | | | | | | | | | | | | | | | | | | When no `CMAKE_BUILD_TYPE` is explicitly specified while creating a new build tree, check for an environment variable of the same name. Issue: #20983
* | | | Help: Document when CMAKE_BUILD_TYPE and CMAKE_CONFIGURATION_TYPES are setBrad King2021-06-302-0/+9
| | | | | | | | | | | | | | | | Fixes: #19247
* | | | Help: Cross-reference CMAKE_CONFIGURATION_TYPES from CMAKE_BUILD_TYPEBrad King2021-06-301-0/+3
| |/ / |/| | | | | | | | The other direction is already linked.
* | | Merge topic 'doc-vs-fortran'Brad King2021-06-307-14/+21
|\ \ \ | | |/ | |/| | | | | | | | | | | | | ab06f78182 Help: Document VS generator support for Intel Fortran Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6289
| * | Help: Document VS generator support for Intel FortranBrad King2021-06-307-14/+21
| |/ | | | | | | | | | | | | Extend the list of project types added by commit a82eb539f0 (Help: Describe the type of Visual Studio projects that can be generated, 2018-08-04, v3.13.0-rc1~227^2) to mention that Fortran projects are supported with Intel compiler integration.
| * Merge topic 'CMP0126-WARNING' into release-3.21Brad King2021-06-302-1/+5
| |\ | | | | | | | | | | | | | | | | | | | | | 16208ac113 CMP0126: Add control for warnings Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !6282
* | \ Merge topic 'ninja-edit_cache'Brad King2021-06-301-0/+5
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 51bf4094fb Ninja: Use `ccmake` for `edit_cache` 7cb4ad7e39 cmGlobalCommonGenerator: Adopt GetEditCacheCommand 23af78bb78 cmGlobalCommonGenerator: Adopt GetEditCacheTargetName 1db4d74628 cmGlobalCommonGenerator: Add SupportsDirectConsole 61a737b088 cmGlobalNinjaGenerator: Rename SupportsConsolePool to SupportsDirectConsole Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6272
| * | | Ninja: Use `ccmake` for `edit_cache`NAKAMURA Takumi2021-06-291-0/+5
| | | | | | | | | | | | | | | | | | | | If `ninja` is new enough to support the console pool, and `ccmake` is available, use it for `edit_cache`.
* | | | Merge topic 'CMP0126-WARNING'Brad King2021-06-302-1/+5
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 616972197a Merge branch 'backport-3.21-CMP0126-WARNING' into CMP0126-WARNING 16208ac113 CMP0126: Add control for warnings Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !6282
| * \ \ \ Merge branch 'backport-3.21-CMP0126-WARNING' into CMP0126-WARNINGMarc Chevrier2021-06-292-1/+5
| |\ \ \ \ | | |/ / / | |/| | / | | | |/ | | |/|
| | * | CMP0126: Add control for warningsMarc Chevrier2021-06-292-1/+5
| | | | | | | | | | | | | | | | Fixes: #22353
* | | | Merge topic 'rpm-suggests'Brad King2021-06-301-2/+4
|\ \ \ \ | |/ / / |/| | / | | |/ | |/| | | | | | | 9b53eca317 CPack/RPM: Fix weak dep support Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6274
| * | CPack/RPM: Fix weak dep supportAlex Sweet2021-06-291-2/+4
| |/ | | | | | | | | | | | | | | | | | | RPM 4.11.3 for el7 contains backported support for the RPM weak dep tags. It only supports querying those tags, but rpmbuild can not make use of them. Since CPack relies on rpmbuild --querytags to check for support, this commit switches to rpm --suggests to check for support of weak dependencies. Fixes: #22350
| * Merge topic 'genex-versionadded' into release-3.21Brad King2021-06-281-5/+105
| |\ | | | | | | | | | | | | | | | | | | 7993aa3075 Help: Add versionadded tags to cmake-generator-expressions(7) Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6270
| * \ Merge topic 'Help-CMP0102-mention-warning-variable' into release-3.21Brad King2021-06-281-1/+3
| |\ \ | | | | | | | | | | | | | | | | | | | | | | | | 894645d4a6 Help/CMP0102: mention the varible that controls CMP0102 warnings Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6275
| * \ \ Merge topic 'doc-3.21-relnotes-supportedPlatforms' into release-3.21Brad King2021-06-281-3/+3
| |\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 82ea0aeae4 Help: Clarify 3.21 release note on supportedPlatforms Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6277
* | \ \ \ Merge topic 'genex-versionadded'Brad King2021-06-281-5/+105
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | 7993aa3075 Help: Add versionadded tags to cmake-generator-expressions(7) Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6270
| * | | | Help: Add versionadded tags to cmake-generator-expressions(7)FeRD (Frank Dana)2021-06-281-5/+105
| |/ / /
* | | | Merge topic 'Help-CMP0102-mention-warning-variable'Brad King2021-06-281-1/+3
|\ \ \ \ | | |_|/ | |/| | | | | | | | | | | | | | | | | | 894645d4a6 Help/CMP0102: mention the varible that controls CMP0102 warnings Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6275
| * | | Help/CMP0102: mention the varible that controls CMP0102 warningsBen Boeckel2021-06-281-1/+3
| | | | | | | | | | | | | | | | | | | | This was missed in the review of !4150, but was noticed during discussion of #22353.
* | | | Merge topic 'doc-3.21-relnotes-supportedPlatforms'Brad King2021-06-281-3/+3
|\ \ \ \ | | |_|/ | |/| | | | | | | | | | | | | | | | | | 82ea0aeae4 Help: Clarify 3.21 release note on supportedPlatforms Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6277
| * | | Help: Clarify 3.21 release note on supportedPlatformsBrad King2021-06-281-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | Avoid implying that the field is always present. Fixes: #22352
* | | | Merge topic 'p1689r4-updates'Brad King2021-06-281-8/+2
|\ \ \ \ | | |_|/ | |/| | | | | | | | | | | | | | | | | | cf22263531 Help/dev/experimental: Link to published P1689R4 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6278
| * | | Help/dev/experimental: Link to published P1689R4Brad King2021-06-281-8/+2
| |/ /
* | | Merge topic 'target_compile_features-only-apply-to-enabled-languages'Brad King2021-06-281-0/+5
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | a3cafa4237 compile_features: Ignore features that map to languages that aren't enabled Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6255
| * | | compile_features: Ignore features that map to languages that aren't enabledRobert Maynard2021-06-251-0/+5
| | | | | | | | | | | | | | | | | | | | Remove the Cuda/ConsumeCompileFeatures test as it only existed to validate that using `cxx_std_XY` would cause the paired language (CUDA) to also build in mode XY.
* | | | Merge topic 'vs2022'Brad King2021-06-289-14/+90
|\ \ \ \ | | |/ / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 93c718791e VS: Use 64-bit MSBuild in VS 2022 c46b265839 VS: Add Visual Studio 17 2022 generator b610b7a35c VS: Update v142 CL flag table for VS 17.0 Preview 1 43375c6418 Help: Remove unnecessary Sphinx versionadded markup in VS toolset selection Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6268
| * | | VS: Add Visual Studio 17 2022 generatorBrad King2021-06-254-0/+69
| | | | | | | | | | | | | | | | Fixes: #22339
| * | | Help: Remove unnecessary Sphinx versionadded markup in VS toolset selectionBrad King2021-06-255-14/+21
| | |/ | |/| | | | | | | | | | In a document that says "New in version 3.14", we do not need any blocks that say "New in version 3.8".
| * | Merge branch 'release-3.20' into release-3.21Brad King2021-06-211-0/+7
| |\ \