summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'doc-clarify-shared-lib'Brad King2015-10-121-1/+6
|\ | | | | | | | | 6556481e Help: Document that SHARED libraries must export a symbol (#15775)
| * Help: Document that SHARED libraries must export a symbol (#15775)James Johnston2015-10-081-1/+6
| | | | | | | | | | | | | | CMake assumes that a SHARED library compiled on Windows will export a LIB file. This is not actually the case on Visual C++ if the library does not export any symbols, and causes incremental builds to break if the user specifies SHARED anyway. (Users should use MODULE libraries instead.)
* | Merge topic 'revert-compiler-features-solaris'Brad King2015-10-121-1/+1
|\ \ | |/ |/| | | | | 340d0897 Revert topic 'compiler-features-solaris'
| * Revert topic 'compiler-features-solaris'Brad King2015-10-081-1/+1
| | | | | | | | | | | | | | | | Revert commit v3.4.0-rc1~10^2~2 (Features: Disable support for Oracle SolarisStudio on non-Linux, 2015-09-29) and two follow-up commits. The support of compile features and language standards on Orcale SolarisStudio needs more investigation so for CMake 3.4 we should just act as 3.3 did.
* | Merge topic 'vs-win10-store'Brad King2015-10-052-0/+22
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | 2402bb8c Help: Document Windows 10 Universal Applications in cmake-toolchains(7) 1be2f12c VS: Add support for Windows 10 Universal (Store) Applications 2798dbda VS: Refactor indentation of LinkLibraryDependencies 8c426183 MSVC: Add system libs for WindowsStore on VS 2015 d1b87d72 VS: Select Windows 10 Store SDK and toolset for VS 2015
| * | Help: Document Windows 10 Universal Applications in cmake-toolchains(7)Brad King2015-10-051-0/+17
| | |
| * | VS: Add support for Windows 10 Universal (Store) ApplicationsGilles Khouzam2015-10-051-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Teach the VS 2015 generator to support WindowsStore 10.0 applications. Add target properties to customize them: * VS_WINDOWS_TARGET_PLATFORM_MIN_VERSION: Specifies the minimum version of the OS that the project can target. * VS_DESKTOP_EXTENSIONS_VERSION, VS_MOBILE_EXTENSIONS_VERSIONS, VS_IOT_EXTENSIONS_VERSION: Add a reference to the version of the SDK specified to the target allowing to target the extended functionality in a universal project. * VS_IOT_STARTUP_TASK: Specifies that the target should be built as an IOT continuous background task.
* | | Merge topic 'compiler-features-solaris'Brad King2015-10-021-1/+1
|\ \ \ | |/ / |/| / | |/ | | | | | | 5fdf7594 Tests: Suppress WriteCompilerDetectionHeader failure on SunPro c824b23d Features: Fix C++98 flags on Oracle SolarisStudio 12.4 on Linux 61bc0f73 Features: Disable support for Oracle SolarisStudio on non-Linux
| * Features: Disable support for Oracle SolarisStudio on non-LinuxBrad King2015-09-291-1/+1
| | | | | | | | | | | | On SunOS the -std=c++11 flag must be used for linking as well as compiling. Until we implement support for this we cannot support the CXX_STANDARD property except on Linux (where it was tested).
* | VS: Add support for selecting the Windows 10 SDK (#15670)Gilles Khouzam2015-10-021-0/+1
|/ | | | | | | | | Teach the VS 2015 generator to produce a WindowsTargetPlatformVersion value. Use the CMAKE_SYSTEM_VERSION to specify the version and if not set choose a default based on available SDKs. Activate this behavior when targeting Windows 10. Co-Author: Brad King <brad.king@kitware.com>
* Merge topic 'link-https-cmake.org'Brad King2015-09-291-5/+5
|\ | | | | | | | | da7276cf Replace http://www.cmake.org URLs with https://cmake.org
| * Replace http://www.cmake.org URLs with https://cmake.orgBrad King2015-09-251-5/+5
| | | | | | | | | | | | | | The latter is now the preferred URL for visiting cmake.org with a browser. Convert using the shell code: git ls-files -z | xargs -0 sed -i 's|http://www\.cmake|https://cmake|g'
* | Merge topic 'genex-SHELL_PATH'Brad King2015-09-281-0/+4
|\ \ | | | | | | | | | | | | | | | ca6ba3fe Genex: Add a SHELL_PATH expression 7de868c4 Tests: Simplify GeneratorExpression check implementation
| * | Genex: Add a SHELL_PATH expressionStefan Kislinskiy2015-09-281-0/+4
| |/ | | | | | | | | | | | | | | | | Some commands on Windows do not understand forward slash paths and require backslashes. In order to help projects generate shell invocations of such commands, provide a generator expression to convert paths to the shell-preferred path format for the current generator. This will allow custom commands to generate paths the same way CMake does for compiler command invocations.
* | Merge topic 'revert-cmake-W-options'Brad King2015-09-251-41/+2
|\ \ | |/ |/| | | | | | | 2e606306 Merge branch 'improve-variable-help-formatting' into revert-cmake-W-options 81739e92 Revert topic 'cmake-W-options' (#15747)
| * Merge branch 'improve-variable-help-formatting' into revert-cmake-W-optionsBrad King2015-09-223-0/+5
| |\ | | | | | | | | | | | | | | | | | | | | | | | | Resolve conflicts in Help/variable/CMAKE_ERROR_DEPRECATED.rst Help/variable/CMAKE_WARN_DEPRECATED.rst by integrating changes from both sides.
| * | Revert topic 'cmake-W-options' (#15747)Brad King2015-09-221-41/+2
| | | | | | | | | | | | | | | | | | | | | | | | The changes in commit c96fe0b4 (cmake: Add -W options to control deprecation warnings and errors, 2015-07-28) fail to account for -Wdev warnings produced by places in CMake other than message(). This causes a regression in which -Wno-dev fails to suppress such warnings. Revert the feature until it can be revised accordingly.
* | | Merge topic 'ctest-variable-docs'Brad King2015-09-221-0/+16
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 4da5a227 Help: document CTEST_CUSTOM_* variables 70c0cc72 ctest_read_custom_files: mention that ctest does this automatically 71c67e83 CTEST_CUSTOM_*: treat variables as lists 936a95d4 CTestCoverageCollectGCOV: replace tabulators
| * | | Help: document CTEST_CUSTOM_* variablesBen Boeckel2015-09-221-0/+16
| | | |
* | | | CMP0065: Restrict the use of CMAKE_SHARED_LIBRARY_LINK_<LANG>_FLAGSChuck Atkins2015-09-212-0/+2
|/ / / | | | | | | | | | | | | This new policy restricts the addition of the shared library link flags to executables only when the ENABLE_EXPORTS property is set to True.
* | | Merge topic 'ctest-custom-output-size'Brad King2015-09-212-0/+8
|\ \ \ | | | | | | | | | | | | | | | | | | | | fd47df45 CTest: Add options to limit output of passed and failed tests 6e3151f6 CTest: Document and test custom output size settings
| * | | CTest: Add options to limit output of passed and failed testsRoman Wüger2015-09-181-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add ctest command-line options: --test-output-size-passed <n> --test-output-size-failed <n> to set the amount of test output to store in Test.xml as a command-line dashboard client.
| * | | CTest: Document and test custom output size settingsBrad King2015-09-181-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add documentation and tests for the existing CTEST_CUSTOM_MAXIMUM_PASSED_TEST_OUTPUT_SIZE CTEST_CUSTOM_MAXIMUM_FAILED_TEST_OUTPUT_SIZE CTest variables.
* | | | Project: Determine default language dialect for the compiler.Stephen Kelly2015-09-181-3/+3
|/ / / | | | | | | | | | | | | | | | Use the __cplusplus and __STDC_VERSION__ macros to automatically determine the default dialect for the compiler while determining its id and version.
* | | Help: Fix classification of load_command in command TOC.James Johnston2015-08-251-1/+1
| |/ |/| | | | | | | | | In CMake 3.0, the load_command command was deprecated. However, the position of load_command in the help TOC was not fixed at that time: it was still listed as a "Normal Command".
* | Help: Improve formatting of variable documentationJames Johnston2015-08-211-0/+2
| | | | | | | | | | | | | | | | Improve formatting, primarily by: * Adding links to relevant commands, properties, generators, and so on. * Converting code, symbols, paths, and so on to fixed-width fonts. * Hard wrapping lines to 80 characters or less.
* | Allow LINK_SEARCH_{START,END}_STATIC props to have default values.Chuck Atkins2015-08-131-0/+2
| | | | | | | | | | | | Use the CMAKE_LINK_SEARCH_START_STATIC and CMAKE_LINK_SEARCH_END_STATIC variables to initialize the LINK_SEARCH_START_STATIC and LINK_SEARCH_END_STATIC target properties respectively.
* | Merge topic 'if-test'Brad King2015-08-031-0/+1
|\ \ | |/ |/| | | | | | | 14e49ed1 if: Add "TEST <test>" condition 623dcc85 ExternalProject: Avoid if() auto-dereference of a "TEST" variable
| * if: Add "TEST <test>" conditionMatt McCormick2015-08-031-0/+1
| | | | | | | | | | | | | | | | if(TEST TestNameThatExists) will return true if a test with the name TestNameThatExists has been added with add_test. The syntax is similar to if(TARGET TargetName). Since use of "TEST" as an argument to if() could previously be interpreted as a non-keyword argument, add policy CMP0064 to treat it as a keyword as NEW behavior.
* | cmake: Add -W options to control deprecation warnings and errorsMichael Scott2015-07-291-2/+41
|/ | | | | | | | | | | Refactor the -Wdev and -Wno-dev to use a generic -W parser that follows the GCC pattern. Include support for setting CMAKE_ERROR_DEPRECATED and CMAKE_WARN_DEPRECATED via the deprecated warning. Add -Werror=dev and -Wno-error=dev options so that dev warning options are in line with deprecated warning options. Use a new CMAKE_SUPPRESS_DEVELOPER_ERRORS internal cache entry to store the above new dev options persistently. Add tests for new options and updated cmake documentation and release notes to list new options.
* Merge topic 'trace-expand'Brad King2015-07-271-3/+7
|\ | | | | | | | | 594bafe5 cmake: add --trace-expand option
| * cmake: add --trace-expand optionBen Boeckel2015-07-231-3/+7
| | | | | | | | | | | | | | | | The --trace option is helpful, but sometimes, what you're looking for is deep under many layers of function calls and figuring out what instance of the function call you're looking at is tedious to determine (usually involving patching and message()). Instead, add a --trace-expand option to trace while expanding commands into what CMake actually sees.
* | Add SOURCE_DIR and BINARY_DIR target propertiesClifford Yapp2015-07-211-0/+2
|/ | | | | This will allow project code to recover the directory information about where a target was created.
* Merge topic 'ctest-change-id'Brad King2015-07-171-0/+1
|\ | | | | | | | | 601ff0ec CTest: Optionally add a ChangeId attribute on XML Site tags
| * CTest: Optionally add a ChangeId attribute on XML Site tagsZack Galbreath2015-07-171-0/+1
| | | | | | | | | | | | | | Add variable CTEST_CHANGE_ID to configure the setting. This allows CTest clients to give CDash information about what change is being tested so that CDash can take actions to report the results (e.g. to a pull request page).
* | Merge topic 'makefile-target-messages'Brad King2015-07-151-0/+1
|\ \ | | | | | | | | | | | | | | | | | | f0cad193 Tests: Add test for TARGET_MESSAGES global property 1d398478 Makefile: Optionally disable target completion messages in build output d560b46f CMakeGenericSystem: Recognize Watcom WMake generator as Makefile generator
| * | Makefile: Optionally disable target completion messages in build outputMichael Ensslin2015-07-141-0/+1
| |/ | | | | | | | | | | Add a TARGET_MESSAGES property to control whether Makefile targets print the "Built target " completion messages. Default to ON to preserve existing behavior.
* | Merge topic 'vs-nsight-tegra-attributes'Brad King2015-07-153-3/+47
|\ \ | | | | | | | | | | | | 8c0afaf4 VS: Add more Nsight Tegra generator Android property settings
| * | VS: Add more Nsight Tegra generator Android property settingsMikhail Filimonov2015-07-143-3/+47
| |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Extend the Nsight Tegra project generator to add bunch of properties with the backing variables to fine-tune the generated projects. Add target properties that map to all "Configuration" PropertyGroups for each configuration: * ANDROID_ARCH * ANDROID_STL_TYPE Add target properties that map to the AntBuild section of vcxproj files: * ANDROID_ANT_ADDITIONAL_OPTIONS * ANDROID_ASSETS_DIRECTORIES * ANDROID_JAR_DEPENDENCIES * ANDROID_JAR_DIRECTORIES * ANDROID_JAVA_SOURCE_DIR * ANDROID_NATIVE_LIB_DEPENDENCIES * ANDROID_NATIVE_LIB_DIRECTORIES * ANDROID_PROCESS_MAX * ANDROID_PROGUARD * ANDROID_PROGUARD_CONFIG_PATH * ANDROID_SECURE_PROPS_PATH * ANDROID_SKIP_ANT_STEP Reviewed-by: Dmitry Polyanitsa <dpolyanitsa@nvidia.com>
* | Help: Document Apple Framework creation with an example (#15651)Brad King2015-07-142-0/+17
|/
* Merge topic 'auto_export_dll_symbols'Brad King2015-07-082-0/+2
|\ | | | | | | | | | | | | | | | | | | | | | | | | 8f86407c Windows: Optionally generate DLL module definition files automatically 069aa93b bindexplib: Add support for "/bigobj" format objects 61bbbdcf bindexplib: Fix treatment of some symbols de70c922 bindexplib: Teach DumpFile to return errors 8ea69dfe bindexplib: Build source as part of CMakeLib 2963cb2a bindexplib: Wrap long lines 4ff09893 bindexplib: Drop code that CMake does not need 7de8276c bindexplib: Add copyright/license notice block 65086ad7 bindexplib: Import original implementation from CERN
| * Windows: Optionally generate DLL module definition files automaticallyBill Hoffman2015-07-062-0/+2
| | | | | | | | | | | | | | Create target property WINDOWS_EXPORT_ALL_SYMBOLS to automatically generate a module definition file from MS-compatible .obj files and give it to the linker in order to export all symbols from the .dll part of a SHARED library.
* | ctest: Optionally avoid starting tests that may exceed a given CPU loadBetsy McPhail2015-06-302-0/+15
|/ | | | | | | | | | | | | | Add a TestLoad setting to CTest that can be set via a new --test-load command-line option, CTEST_TEST_LOAD variable, or TEST_LOAD option to the ctest_test command. Teach cmCTestMultiProcessHandler to measure the CPU load and avoid starting tests that may take more than the spare load currently available. The expression <current_load> + <test_processors> <= <max-load> must be true to start a new test. Co-Author: Zack Galbreath <zack.galbreath@kitware.com>
* Merge topic 'doc-cmake-buildsystem-typo'Brad King2015-06-221-1/+1
|\ | | | | | | | | 17c51521 Help: Fix a typo in cmake-buildsystem(7) manual
| * Help: Fix a typo in cmake-buildsystem(7) manualErik Sjölund2015-06-221-1/+1
| | | | | | | | | | Add the property name INTERFACE_INCLUDE_DIRECTORIES that was missing from a set_property command.
* | Merge topic 'compiler-launcher'Brad King2015-06-152-0/+2
|\ \ | | | | | | | | | | | | 698f7597 Add options to launch the compiler through tools like ccache or distcc
| * | Add options to launch the compiler through tools like ccache or distccBill Hoffman2015-06-152-0/+2
| |/ | | | | | | | | | | | | | | | | | | | | | | | | Create a <LANG>_COMPILER_LAUNCHER target property (initialized by a CMAKE_<LANG>_COMPILER_LAUNCHER variable) to specify a compiler launcher tool. This will supersede the CMAKE_<LANG>_COMPILER_ARG1 approach to using such tools. The old approach set CMAKE_<LANG>_COMPILER to the launcher tool while the new approach leaves this variable set to the actual compiler. Implement this property for Makefile and Ninja generators. It cannot be implemented for VS or Xcode generators as the IDE build tools offer no such hooks.
* | Merge topic 'doc-policy-OLD-deprecated'Brad King2015-06-091-5/+5
|\ \ | | | | | | | | | | | | 482a3bf3 Help: Document explicitly that policy OLD behavior is deprecated
| * | Help: Document explicitly that policy OLD behavior is deprecatedBrad King2015-06-091-5/+5
| |/ | | | | | | | | | | | | | | | | | | | | The most likely documentation page a project author will read in response to a policy warning is the page for the policy itself. Add to every policy documentation page a note explicitly stating that the OLD behavior is deprecated. Also mention this in the cmake_policy() command documentation that explains how to set a policy to OLD. Suggested-by: Fraser Hutchison <fraser.hutchison@gmail.com>
* | Merge topic 'doc-find-command-cleanup'Brad King2015-06-091-0/+4
|\ \ | | | | | | | | | | | | | | | | | | | | | 3de3544f Help: Improve documentation formatting of find_* commands 8c64c478 Help: Document CMAKE_FIND_APPBUNDLE and CMAKE_FIND_FRAMEWORK 25b4483e Help: Document CMAKE_SYSTEM_APPBUNDLE_PATH variable e2f34986 Help: Document CMAKE_SYSTEM_FRAMEWORK_PATH variable