summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* 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
| * | Help: Document CMAKE_FIND_APPBUNDLE and CMAKE_FIND_FRAMEWORKBrad King2015-06-081-0/+2
| | | | | | | | | | | | | | | Add dedicated documents for these and link to them instead of duplicating their documentation in every find command.
| * | Help: Document CMAKE_SYSTEM_APPBUNDLE_PATH variableBrad King2015-06-081-0/+1
| | |
| * | Help: Document CMAKE_SYSTEM_FRAMEWORK_PATH variableBrad King2015-06-081-0/+1
| |/
* | Help: Drop incorrect advice from cmake-developer.7 manualBrad King2015-06-081-1/+0
|/ | | | | Drop the comment on the purpose of PATH_SUFFIXES in our Find Module example. It was incorrect.
* Help: Fix typo in cmake-compile-features(7) manual (#15594)Erik Sjölund2015-05-291-1/+1
| | | | | | | target_link_libraries() is being used in the example code but target_include_directories() was probably meant to be used. The sentence that starts with "Consuming code then" indicates that the example is about using the appropriate include directory.
* Honor visibility properties for all target types (#15556)Brad King2015-05-261-0/+1
| | | | | | | | | | | | | | | | The <LANG>_VISIBILITY_PRESET and VISIBILITY_INLINES_HIDDEN were first merged in commit v2.8.12~322 (Merge topic 'VISIBILITY_PRESET-property', 2013-06-05) but worked only for shared libraries and executables with exports. Prior to commit v3.0.0-rc1~581^2 (GenerateExportHeader: Deprecate add_compiler_export_flags function., 2013-09-02) the add_compiler_export_flags function was used to add visibility flags to all targets. The visibility flags are useful for sources in all target types because they may be later linked into shared libraries or executables with exports. Introduce policy CMP0063 to enable them for all target types while preserving compatibility with existing projects that do not expect this.
* Revert "Qbs: Add new 'extra' generator for qbs project files"Brad King2015-05-211-1/+0
| | | | | | | | | | | | | | | | | | | This reverts commit f85db2f32358e6de921aba7d1cb8ecb81da934c0. Discussion by the QtCreator community at https://bugreports.qt.io/browse/QTCREATORBUG-13695 raises concerns about this particular approach to working with CMake projects using QtCreator. Also, the functionality and design of the QBS extra generator was never discussed on the CMake mailing list or with QtCreator developers. There may be better ways to make the two tools work together. In order to avoid committing to long-term support of this generator prior to such discussion taking place, revert it from CMake for now. We may restore this or use an alternative design based on results of such discussion.
* Merge topic 'doc-cache-option-space'Brad King2015-05-212-1/+4
|\ | | | | | | | | b0ea3673 Help: Spell '-D' option consistently across documentation (#15575)
| * Help: Spell '-D' option consistently across documentation (#15575)Brad King2015-05-202-1/+4
| | | | | | | | | | | | Always show the option with its argument separate in summary text. State in the main documentation that the option and its argument can be given together too.
* | Merge topic 'doc-cmake-buildsystem-typo'Brad King2015-05-211-2/+2
|\ \ | | | | | | | | | | | | 7412d100 Help: Fix typo in cmake-buildsystem(7) manual
| * | Help: Fix typo in cmake-buildsystem(7) manualBrad King2015-05-191-2/+2
| |/
* | Add options to run include-what-you-use with the compilerBrad King2015-05-192-0/+2
|/ | | | | | Create a <LANG>_INCLUDE_WHAT_YOU_USE target property (initialized by a CMAKE_<LANG>_INCLUDE_WHAT_YOU_USE variable) to specify an IWYU command line to be run along with the compiler.
* install: Disallow installing export() result.Stephen Kelly2015-05-141-0/+1
|
* CTest: Stop telling 'make' to ignore errors with -iBrad King2015-05-121-0/+1
| | | | Add policy CMP0061 to maintain compatibility for existing projects.
* Help: Update cmake-generators(7) organization for GHSBrad King2015-05-071-3/+3
|
* VS: Add option to put INSTALL target in .sln default buildRobert Goulet2015-05-061-0/+1
| | | | | Add a CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD variable to control this behavior.
* Help: Revise buildsystem artifact file type documentation (#15539)Brad King2015-04-292-2/+72
| | | | | | Add sections to the cmake-buildsystem(7) manual and cross-reference them with relevant variables and target properties. This avoids duplicating the information and allows it to be more detailed.
* ctest: Consolidate documentation of CTEST_USE_LAUNCHERS (#15533)Brad King2015-04-281-2/+5
| | | | | | | | | The documentation of this variable in the CTest module is outdated and has been superseded by the ctest(1) manual. In particular, the latter mentions that it works with the Ninja generator as well as makefile generators. Remove the documentation from the CTest module and replace it with a link to the main variable documentation (which already references the ctest(1) manual).
* Help: Fix formatting of env var refs in ctest.1 manualBrad King2015-04-221-2/+4
|
* Merge topic 'add-GreenHills-MULTI-generator'Brad King2015-04-202-0/+6
|\ | | | | | | | | | | | | 66b641f4 Help: Add notes for topic 'add-GreenHills-MULTI-generator' 48004d9d Add a 'Green Hills MULTI' generator on Windows 051d8be1 cmLocalGenerator: Constify some cmTarget and cmGeneratorTarget arguments
| * Add a 'Green Hills MULTI' generator on WindowsGeoff Viola2015-04-202-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | Green Hills MULTI is an IDE for embedded real-time systems. The IDE's product page can be found here: http://www.ghs.com/products/MULTI_IDE.html It supports cross compiling on ARM, Intel x86, and other architectures with various operating systems. The IDE exists on Linux and Windows host systems, but CMake will currently only generate the project files on Windows host systems.
* | Help: Fix {GIT,P4}UpdateCustom documentation (#15512)Brad King2015-04-131-2/+2
| | | | | | | | | | | | | | | | The GITUpdateCustom and P4UpdateCustom options take only one command line with all arguments as a ;-list, not a ;-list of multiple command lines. Fix the incorrect documentation originally added by commit v3.1.0-rc1~463^2 (Help: Document ctest dashboard client usage, 2014-05-30).
* | cmake: Teach "-E tar" command a "--format=" optionNils Gladitz2015-04-101-0/+4
| | | | | | | | | | | | | | Allows specifying a libarchive defined archive format currently restricted to 7zip, gnutar, pax, paxr and zip. The default is "paxr" (pax restricted).
* | Merge topic 'link-implicit-libs-full-path'Brad King2015-04-092-0/+2
|\ \ | |/ |/| | | | | | | | | 882f48e5 Link libraries by full path even in implicit directories 318cd370 Help: Add link target for Find Modules section of cmake-developer.7 1535dcd8 Tests: Teach RunCMake to optionally merge command output to stdout
| * Link libraries by full path even in implicit directoriesBrad King2015-04-091-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When CMP0003 was first introduced we wanted to link all libraries by full path. However, some projects had problems on platforms where find_library would find /usr/lib/libfoo.so when the project really wanted to link to /usr/lib/<arch>/libfoo.so and had been working by accident because pre-CMP0003 behavior used -lfoo to link. We first tried to address that in commit v2.6.0~440 (Teach find_library to avoid returning library paths in system directories, 2008-01-23) by returning just "foo" for libraries in implicit link directories. This caused problems for projects expecting find_library to always return a full path. We ended up using the solution in commit v2.6.0~366 (... switch library paths found in implicit link directories to use -l, 2008-01-31). However, the special case for libraries in implicit link directories has also proven problematic and confusing. Introduce policy CMP0060 to switch to linking all libraries by full path even if they are in implicit link directories. Explain in the policy documentation the factors that led to the original approach and now to this approach.
| * Help: Add link target for Find Modules section of cmake-developer.7Brad King2015-04-071-0/+1
| |