summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* VS: Provide the default platform name to project codeBrad King2019-04-191-0/+1
| | | | | | | | | | | | | | | | | | The value of `CMAKE_VS_PLATFORM_NAME` is computed by Visual Studio generators based on `CMAKE_GENERATOR_PLATFORM` or some default. Prior to the VS 2019 generator, the default was always `Win32`. However, for the `Visual Studio 16 2019` generator, the default is based on the host platform. Store the default in a new `CMAKE_VS_PLATFORM_NAME_DEFAULT` variable for use by project code. This is particularly useful in toolchain files because they are allowed to set `CMAKE_GENERATOR_PLATFORM` and so `CMAKE_VS_PLATFORM_NAME` is not yet known. Of course the toolchain file author knows whether it will set `CMAKE_GENERATOR_PLATFORM`, and if not then `CMAKE_VS_PLATFORM_NAME_DEFAULT` provides the platform name that will be used. Fixes: #19177
* Merge branch 'docs-xcode-schemes' into release-3.14Brad King2019-03-062-19/+19
|\ | | | | | | Merge-request: !3066
| * Help: Sort lists of (CMAKE_)XCODE_SCHEME_... variables and propertiesCraig Scott2019-03-062-19/+19
| |
* | Merge branch 'ios-docs' into release-3.14Brad King2019-03-051-1/+59
|\ \ | | | | | | | | | Merge-request: !3047
| * | Help: Example of tweaking iOS/tvOS/watchOS buildRuslan Baratov2019-03-051-0/+48
| | | | | | | | | | | | | | | CMAKE_OSX_ARCHITECTURES and CMAKE_OSX_DEPLOYMENT_TARGET variables can be used to tweak iOS/tvOS/watchOS build
| * | Help: find_package with fat iOS librariesRuslan Baratov2019-03-051-1/+11
| |/
* | iOS: Add IOS variableRuslan Baratov2019-03-051-0/+1
|/ | | | | | | Since commit 11da882a12 (Apple: Introduce separate system name for iOS, tvOS, and watchOS, 2018-01-15, v3.14.0-rc1~14^2~1) we support setting `CMAKE_SYSTEM_NAME` to `iOS`. Existing iOS toolchain files already set `IOS` as a short-hand variable, so do the same here.
* Merge branch 'FindOctave-remove' into release-3.14Brad King2019-02-271-1/+0
|\ | | | | | | Merge-request: !3027
| * FindOctave: Remove module pending further workBrad King2019-02-261-1/+0
| | | | | | | | | | | | | | | | | | | | | | The `FindOctave` module added by commit 170bcb6fdc (FindOctave: Add module to find GNU octave, 2018-11-17, v3.14.0-rc1~283^2) has a few problems in its implementation that need to be worked out before the module can be included in a CMake release. These were missed during review. Remove the module for now. It can be restored later with a fresh review. Issue: #18991
* | Help: Fix --build-and-test synopsis in ctest(1)Paul Seyfert2019-02-261-2/+3
|/ | | | | | The synopsis added by commit 9d3aa95ca4 (Help: Divide ctest(1) manual options into sections, 2017-11-08, v3.11.0-rc1~359^2~2) is missing the actual `--build-and-test` argument! Add it now.
* GHS: Document usage of GHS_NO_SOURCE_GROUP_FILEFred Baksik2019-02-082-0/+2
| | | | -- Also change variable name to CMAKE_GHS_NO_SOURCE_GROUP_FILE
* Merge topic '17870-iphone-friendly-cmake'Brad King2019-02-051-0/+71
|\ | | | | | | | | | | | | | | | | e8ee8cab97 Xcode: Completely disable code signing for compiler id detection 11da882a12 Apple: Introduce separate system name for iOS, tvOS, and watchOS 36cf44a7a3 Tests: Isolate RunCMake.XcodeProject per-device cases from host arch Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2392
| * Xcode: Completely disable code signing for compiler id detectionGregor Jasny2019-02-041-0/+2
| | | | | | | | Issue: #17870
| * Apple: Introduce separate system name for iOS, tvOS, and watchOSGregor Jasny2019-02-041-0/+69
| | | | | | | | | | | | | | | | | | | | | | - Remove code signing requirements for non-macOS - Do not set deployment target for non-macOS - Build static library for compiler feature detection for non-macOS - Use framework to run CompilerId tests for watchOS - Port tests to new SDK handling - Add new Apple cross-compiling section to toolchain documentation Closes: #17870
* | Merge topic 'variables1'Brad King2019-01-311-8/+20
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | 9d20fe014f Help: moved 7 variables to "internal" section dfb2d6178e Help: "internal variables" instead of "obsolete", with some explanatory prose 9c4cdc43f6 Help: declare CMAKE_HOME_DIRECTORY obsolete Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2881
| * | Help: moved 7 variables to "internal" sectionJoachim Wuttke (o)2019-01-301-7/+7
| | |
| * | Help: "internal variables" instead of "obsolete", with some explanatory proseJoachim Wuttke (o)2019-01-301-1/+6
| | |
| * | Help: declare CMAKE_HOME_DIRECTORY obsoleteJoachim Wuttke (o)2019-01-301-1/+8
| |/
* | Help: Add documentation for MSYS variableHarry Mallon2019-01-301-0/+1
|/
* Merge topic 'add_consistent_verbose_build_flag'Brad King2019-01-292-0/+10
|\ | | | | | | | | | | | | | | | | | | | | | | 66801f4d40 cmake: Add tests for verbose output to --build mode 439fe2e253 cmake: Add options for verbose output to --build mode 638667efa2 cmake: cmcmd.cxx fix "The arguments are" comments 3ca4402966 ctest: Fix --build-and-test without --build-target on Xcode cb6c233ecc cmake: Add -hideShellScriptEnvironment xcodebuild option 1a45266cb5 cmGlobalGenerator: Add a class that represent the build command Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2708
| * cmake: Add options for verbose output to --build modeFlorian Maushart2019-01-282-0/+10
| | | | | | | | | | | | | | | | | | | | | | | | While we already support `VERBOSE` environment variable and `CMAKE_VERBOSE_MAKEFILE` cached variable, add `-v` and `--verbose` command line options to be able to activate verbose output directly from CMake's build tool mode command line. Also make `msbuild` honor the verbosity setting. `xcodebuild` still doesn't honor the verbosity setting as it will need a policy added and reworking of cmGlobalGenerator and cmsys to support multiple command invocation.
* | Merge topic 'cmake-gui-s-b'Brad King2019-01-281-0/+9
|\ \ | | | | | | | | | | | | | | | | | | | | | ad0853b3d4 QtDialog: Clean up and document -S and -B options Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Robert Maynard <robert.maynard@kitware.com> Merge-request: !2863
| * | QtDialog: Clean up and document -S and -B optionsKyle Edwards2019-01-251-0/+9
| | |
* | | cmake: Add --ignore-eol option to `-E compare_files` commandTaylor Braun-Jones2019-01-281-2/+3
|/ / | | | | | | Fixes: #13007
* | cmMakefile: Impose maximum recursion limitKyle Edwards2019-01-231-0/+1
|/ | | | | | | | | In order to keep infinitely-recursive scripts from causing a stack overflow in the CMake executable, CMake now imposes a maximum recursion limit before issuing an error message. The limit can be adjusted at runtime with CMAKE_MAXIMUM_RECURSION_DEPTH. Fixes: #18694
* Merge topic 'fortran-compiler-id'Brad King2019-01-211-0/+13
|\ | | | | | | | | | | | | a080914274 Fortran: Add compiler ID/Version generator expressions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2804
| * Fortran: Add compiler ID/Version generator expressionsAndrew Paprocki2019-01-181-0/+13
| | | | | | | | | | | | | | | | | | | | | | | | Adds `Fortran_COMPILER_ID` and `Fortran_COMPILER_VERSION` generator expression support to match equivalent `C_COMPILER_ID`, `CXX_COMPILER_ID`, `C_COMPILER_VERSION`, and `CXX_COMPILER_VERSION` support. This is very helpful in the case where the C/C++ compiler suite is a different type of compiler from the platform Fortran compiler and projects use generator expressions to assign compiler flags and definitions. (e.g. `GNU` C/C++ and `SunPro` Fortran on Linux)
* | Merge topic 'find-package-resolve-symlinks'Brad King2019-01-211-0/+1
|\ \ | | | | | | | | | | | | | | | | | | | | | b773e58099 find_package: add test coverage for CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS a5e948a36f find_package: optionally resolve symlinks when discovering packages Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2798
| * | find_package: optionally resolve symlinks when discovering packagesDavid Aguilar2019-01-161-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | Teach find_package() to resolve symlinks when constructing relocatable prefix paths from discovered cmake config files. The `CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS` variable enables this behavior when set to `TRUE`. Fixes: #18704
* | | Merge topic 'submit-url'Brad King2019-01-212-8/+24
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2915a75615 CTest: Add documentation and release notes for SubmitURL d6475daa79 Modules/CTest: Set SubmitURL 938f06fda6 ctest_submit: Add parameter SUBMIT_URL 65e725c957 CTest: Add option SubmitURL 65f1fc9d63 CTest: Add function GetSubmitURL 2bedd5fb7c ctest_submit: Remove submit method from log output Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2719
| * | CTest: Add documentation and release notes for SubmitURLRegina Pfeifer2019-01-162-8/+24
| |/
* | Merge topic 'GHS_updates'Brad King2019-01-182-5/+1
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 21ab58d3f8 GHS: Update test suite 72e0c115b7 GHS: Add Compiler ID detection 436cc5e991 GHS: try_compile() now uses GHS platform variables 4a1ec0de3d GHS: Fix toolset selection 1a66acdef2 GHS: Append ".gpj" to target name when generating build command 0c9e47d7cd GHS: Integrity Application updates 8044318431 GHS: Add support for some of the source file properties 73092b2213 GHS: Add support for object libraries ... Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2231
| * | GHS: Integrity Application updatesFred Baksik2019-01-161-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | -- Check the property "ghs_integrity_app" on executables to set [INTEGRITY Application] If the property is not set then check if an integrate file is one of the source files (.int file). Dynamic Downloads that do not have an integrate file can use this property along with setting the compiler flag "-dynamic". -- Remove parsing for -dynamic flag; it is only used to print a comment The MULTI GUI will show if it is a Monolith or Dynamic Download application -- Use project references to specify which executables are part of the Integrity Application Usually Implicit Dependency Analysis will ensure that executable targets become part of the application. This does not work for Dynamic Download without integrate files. Use `add_dependencies(dd vas)` to mark that the vas target is part of dd target. -- Update file locations in the Integrate files.
| * | GHS: Use the correct compiler flags for CMAKE_BUILD_TYPEFred Baksik2019-01-161-5/+0
| |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | -- Do not use CMAKE_C_FLAGS_RELEASE flags when CMAKE_BUILD_TYPE is empty if CMAKE_BUILD_TYPE was not set the generator would use Release settings this does not match the documented behavior of CMAKE_BUILD_TYPE -- CMAKE_C_FLAGS_<CONFIG> not used when -kernel is present Fixes issue where CMAKE_C_FLAGS_<CONFIG> is ignored when -kernel option is present as a compiler option When the -kernel option is added to an executable it uses a different set of language flags This does not occur -kernel=<type> is used or if it is added as part of a link flag The variables CMAKE_<LANG>_GHS_KERNEL_FLAGS_<CONFIG> are removed NOTE: By default this only added the flag -ldebug which links in the debugger library. -- Separate compiler options by newlines
* | Merge topic 'remove-duplicate-link'Brad King2019-01-181-1/+0
|\ \ | | | | | | | | | | | | | | | | | | 00c7e006a5 Help: Remove duplicate reference to IMPORTED_LINK_DEPENDENT_LIBRARIES_<CONFIG> Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2818
| * | Help: Remove duplicate reference to IMPORTED_LINK_DEPENDENT_LIBRARIES_<CONFIG>Kyle Edwards2019-01-171-1/+0
| | |
* | | Merge topic 'cmake_role-global-property'Brad King2019-01-171-0/+1
|\ \ \ | |/ / |/| | | | | | | | | | | | | | 4568d046c4 Properties: Add CMAKE_ROLE global property Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2805
| * | Properties: Add CMAKE_ROLE global propertyKyle Edwards2019-01-171-0/+1
| |/ | | | | | | | | This property allows scripts to determine whether they're in project mode, script mode, find-package mode, CTest, or CPack.
* | Merge topic 'qt_wrap_command_deprecations'Craig Scott2019-01-161-5/+6
|\ \ | |/ |/| | | | | | | | | | | 74dc68b406 qt_wrap_*: Add deprecation notes to command docs Acked-by: Kitware Robot <kwrobot@kitware.com> Reviewed-by: Brad King <brad.king@kitware.com> Merge-request: !2738
| * qt_wrap_*: Add deprecation notes to command docsTobias Hunger2019-01-151-5/+6
| | | | | | Co-authored-by: Craig Scott <craig.scott@crascit.com>
* | Merge topic 'vs2019'Brad King2019-01-151-0/+1
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | 57e48f16f2 VS: Add Visual Studio 16 2019 generator bdef729646 VS: Parameterize VS 2017 generator to support future versions 68d316e0cf VS: Rename VS 2017 generator sources to be version-independent d8ed309d05 VS: Parameterize cmVSSetupAPIHelper instances with VS version Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2789
| * | VS: Add Visual Studio 16 2019 generatorBrad King2019-01-111-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add this generator *without* support for specifying the target architecture in the generator name. cmake-gui will be taught to provide a field for this, and command-line builds can use -A. Also, teach this generator to select a default target architecture based on the host architecture. Fixes: #18689 Inspired-by: Egor Pugin <egor.pugin@gmail.com>
* | | Merge topic 'extendwhitelist'Brad King2019-01-151-0/+1
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 59c408d053 cmTargetPropertyComputer: whitelist 'MANUALLY_ADDED_DEPENDENCIES'. Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2808
| * | | cmTargetPropertyComputer: whitelist 'MANUALLY_ADDED_DEPENDENCIES'.Sebastian Lipponer2019-01-141-0/+1
| |/ /
* | | Merge topic 'check-fortran-run'Brad King2019-01-151-0/+1
|\ \ \ | |/ / |/| | | | | | | | | | | | | | 10a1477b63 CheckFortranSourceRuns: Add module to check if Fortran code runs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2714
| * | CheckFortranSourceRuns: Add module to check if Fortran code runsMichael Hirsch, Ph.D2019-01-101-0/+1
| | | | | | | | | | | | | | | Add a Fortran equivalent to the existing `Check{C,CXX}SourceRuns` modules.
* | | Merge topic 'bison_target_policy'Brad King2019-01-111-0/+1
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 5000fed5af FindBISON: Add policy CMP0088 to run bison in build tree Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2774
| * | | FindBISON: Add policy CMP0088 to run bison in build treeRobert Maynard2019-01-101-0/+1
| | | |
* | | | Merge topic 'fix-doc-typo'Brad King2019-01-111-1/+1
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 261ae28ccd Help: fix typo for CTEST_CUSTOM_TESTS_IGNORE Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2770
| * | | | Help: fix typo for CTEST_CUSTOM_TESTS_IGNOREBen Boeckel2019-01-021-1/+1
| |/ / / | | | | | | | | | | | | | | | | | | | | In commit v3.4.0-rc1~57^2 (Help: document CTEST_CUSTOM_* variables, 2015-09-17), the CTEST_CUSTOM_TESTS_IGNORE variable was documented with a typo.