summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* cmake: Teach "-E tar" command a "--format=" optionNils Gladitz2015-04-102-0/+10
| | | | | | | 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-096-5/+84
|\ | | | | | | | | | | | | 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-095-5/+83
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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
| |
* | Merge topic 'emulator-property'Brad King2015-04-086-1/+29
|\ \ | | | | | | | | | | | | | | | | | | | | | 1975d53a Help: Add notes for topic 'emulator-property' 9160d6c2 TestGenerator: Add CROSSCOMPILING_EMULATOR support. e942526b try_run: Use CMAKE_CROSSCOMPILING_EMULATOR. 579c4bec Properties: Add CROSSCOMPILING_EMULATOR target property.
| * | Help: Add notes for topic 'emulator-property'Brad King2015-04-081-0/+7
| | |
| * | TestGenerator: Add CROSSCOMPILING_EMULATOR support.Matt McCormick2015-04-081-1/+3
| | | | | | | | | | | | | | | | | | Prefix test commands with the CROSSCOMPILING_EMULATOR property for target executables. This allows test suites to be run on the host when crosscompiling.
| * | try_run: Use CMAKE_CROSSCOMPILING_EMULATOR.Matt McCormick2015-04-082-3/+11
| | | | | | | | | | | | | | | | | | | | | If the CMAKE_CROSSCOMPILING_EMULATOR variable is defined, and CMAKE_CROSSCOMPILING is TRUE, then use CMAKE_CROSSCOMPILING_EMULATOR to run the try_run executables. This prevents the need to populate TryRunResults.cmake when cross compiling.
| * | Properties: Add CROSSCOMPILING_EMULATOR target property.Matt McCormick2015-04-074-0/+11
| | | | | | | | | | | | | | | | | | | | | Add CROSSCOMPILING_EMULATOR target property for executables. This is used by subsequent patches to run exectuables created for the target system when crosscompiling. The property is initialized by the CMAKE_CROSSCOMPILING_EMULATOR variable when defined.
* | | Help: Document supported compilers in cmake-compile-features.7Robert Maynard2015-04-0721-20/+34
|/ / | | | | | | | | | | | | Extend sentences in other documentation linking to this manual to say that it has a list of supported compilers. Co-Author: Brad King <brad.king@kitware.com>
* | Merge topic 'gcov-module-coverage-exclude'Brad King2015-04-071-0/+6
|\ \ | |/ |/| | | | | d2240390 Help: Add notes for topic 'gcov-module-coverage-exclude'
| * Help: Add notes for topic 'gcov-module-coverage-exclude'Brad King2015-04-061-0/+6
| |
* | Merge topic 'improve-properties-help'Brad King2015-04-066-39/+43
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | 6f82b5e8 Help: Link to properties in set_tests_properties. 66f5af29 Help: Link to properties in set_directory_properties docs. f7dd3f7c Help: Add link in set_source_files_properties command docs. 3b256173 Help: Shorten too-long title marker. 8fc3a2fb Help: Add references to cmake-property sections.
| * | Help: Link to properties in set_tests_properties.Stephen Kelly2015-04-043-29/+22
| | | | | | | | | | | | Remove help for specific properties to their own help pages.
| * | Help: Link to properties in set_directory_properties docs.Stephen Kelly2015-04-041-6/+3
| | | | | | | | | | | | Remove claim that CMake will report an error for unknown properties.
| * | Help: Add link in set_source_files_properties command docs.Stephen Kelly2015-04-041-3/+3
| | | | | | | | | | | | | | | Remove claim about unrecognized properties being ignored. Such properties can be retrieved later by the user.
| * | Help: Shorten too-long title marker.Stephen Kelly2015-04-041-1/+1
| | |
| * | Help: Add references to cmake-property sections.Stephen Kelly2015-04-041-0/+14
| | |
* | | Merge topic 'doc-target_link_libraries'Brad King2015-04-061-84/+124
|\ \ \ | | | | | | | | | | | | | | | | 659896d3 Help: Revise target_link_libraries command documentation
| * | | Help: Revise target_link_libraries command documentationBrad King2015-04-031-84/+124
| | | | | | | | | | | | | | | | | | | | | | | | Organize the documentation into subsections to separate the signatures. Refactor the discussion of allowed link items into bullet points and expand into more detail on each.
* | | | Help: Clarify manual reference for generator namesNils Gladitz2015-04-041-1/+1
| |/ / |/| |
* | | Merge topic 'vs-xaml'Brad King2015-04-033-0/+13
|\ \ \ | | | | | | | | | | | | | | | | 01a9ab0d VS: Add support for XAML source files
| * | | VS: Add support for XAML source filesGilles Khouzam2015-04-033-0/+13
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | XAML files are by default of type Page in the vcxproj and can be overriden by setting the VS_XAML_TYPE property. The .cpp and .h file of the same name are automatically added as depending on the XAML file. New VSXaml test builds a basic XAML WindowsStore 8.1 app with VS2013.
* | | | Merge topic 'doc-relocatable-usage-requirements'Brad King2015-04-0310-117/+153
|\ \ \ \ | |/ / / |/| / / | |/ / | | | | | | | | | | | | | | | 3af13782 Help: Update discussion of relocable packages in cmake-packages(7) 227992c3 Help: Reorganize and refine discussion of relocatable packages 031d894f Help: Place relocatable package notes in their own subsections 6e331ce9 Help: Fix typo in cmake-packages(7) manual ba9b9d79 Help: Fix syntax in non-relocatable usage requirements example
| * | Help: Update discussion of relocable packages in cmake-packages(7)Brad King2015-04-031-20/+46
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Explain at the beginning of the section the requirements for a package to be relocatable to justify the rest of the section content. Generalize example to use fictional package names instead of real ones, especially because FindBoost provides no alternative yet. Reword the discussion to represent the preferred approach as "ideal" but also suggest workarounds when find modules do not provide the imported targets.
| * | Help: Reorganize and refine discussion of relocatable packagesBrad King2015-04-034-114/+106
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Re-organize the content added to the cmake-packages(7) manual by * commit v3.0.0-rc1~184^2 (Help: Document export(EXPORT) in the cmake-packages manual, 2013-12-23), * commit v3.0.0-rc1~154^2~1 (Help: Add notes about relocatability of config-file packages, 2014-01-07), and * commit v3.2.0-rc1~345^2 (Help: Warn that paths should not be used in INTERFACE_ build properties, 2014-11-22). These commits broke the natural flow of the original manual and made wording after the new content make less sense. Move the content into new subsections to restore the flow of the original manual and to make explicitly the purpose of the new content. Shorten the relocatable usage requirement "warnings". Refer to the new cmake-packages(7) manual subsection to reduce duplication. Also clarify the distinction between paths to library dependencies and paths to their header files.
| * | Help: Place relocatable package notes in their own subsectionsBrad King2015-04-036-3/+21
| | | | | | | | | | | | | | | | | | | | | These notes apply only for the use case of creating a package for redistribution on machines other than that where it is built. Clarify this to readers by placing the discussion in dedicated sections titled accordingly.
| * | Help: Fix typo in cmake-packages(7) manualBrad King2015-04-031-1/+1
| | | | | | | | | | | | relevnt => relevant
| * | Help: Fix syntax in non-relocatable usage requirements exampleBrad King2015-04-031-4/+4
| |/ | | | | | | | | The example in cmake-packages(7) is meant to be incorrect for use of absolute paths, not for its syntax.
* | Help: Split cmake-generators(7) into linkable subsectionsBrad King2015-04-031-1/+25
| | | | | | | | | | | | | | Many places in our documentation refer to "Makefile Generators" or "Visual Studio" generators as a group of generators. Give such places a linkable document section to reference since they cannot cross-reference the individual generators in the groups.
* | Merge topic 'FindCUDA.cmake/StaticRuntime'Brad King2015-04-031-0/+7
|\ \ | | | | | | | | | | | | 7fea2b77 FindCUDA: Use the static CUDA runtime library if available (#15482)
| * | FindCUDA: Use the static CUDA runtime library if available (#15482)James Bigler2015-04-031-0/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Beginning in CUDA 5.5 a static version of the cuda runtime library became available. Since nvcc defaults to using this library over the shared version, FindCUDA will also default to using this version. There are many advantages to using the static version (most importantly to avoid conflicts with multiple versions when building a CUDA based library). Offer a CUDA_USE_STATIC_CUDA_RUNTIME option to control this behavior.
* | | Merge topic 'remove-DEFINITIONS-directory-property'Brad King2015-04-024-3/+32
|\ \ \ | | | | | | | | | | | | | | | | 06f61c26 Do not treat DEFINITIONS as a built-in directory property
| * | | Do not treat DEFINITIONS as a built-in directory propertyStephen Kelly2015-04-024-3/+32
| | |/ | |/| | | | | | | | | | | | | | | | | | | Add policy CMP0059 to cover this change. The property has been deprecated since CMake 2.4 anyway. This will help clean up cmMakefile -- the DefineFlagsOrig member should not need to exist.
* | | Help: Document conversion of PATH/FILEPATH cache values to absolute pathsBrad King2015-04-012-1/+18
| | | | | | | | | | | | Suggested-by: Roger Leigh <rleigh@codelibre.net>
* | | Help: Rewrite 'set` command documentationBrad King2015-04-011-95/+59
| | | | | | | | | | | | | | | | | | | | | Much of the information in the old set() command documentation is now covered in the cmake-language(7) manual. Rewrite the documentation with this in mind. Split up the signatures for each kind of variable into different subsections.
* | | Help: Add link target to cmake-language.7 variables sectionBrad King2015-04-011-0/+2
|/ /
* | Merge topic 'makefile-DELETE_ON_ERROR'Brad King2015-04-011-0/+7
|\ \ | |/ |/| | | | | | | 44990732 Help: Add notes for topic 'makefile-DELETE_ON_ERROR' 4adf1dad Makefile: Tell GNU make to delete rule outputs on error (#15474)
| * Help: Add notes for topic 'makefile-DELETE_ON_ERROR'Brad King2015-03-311-0/+7
| |
* | Merge topic 'UseSWIG-no-MAIN_DEPENDENCY'Brad King2015-03-311-0/+9
|\ \ | | | | | | | | | | | | 1570a4df Help: Add notes for topic 'UseSWIG-no-MAIN_DEPENDENCY'
| * | Help: Add notes for topic 'UseSWIG-no-MAIN_DEPENDENCY'Brad King2015-03-311-0/+9
| |/
* | Merge topic 'cpack-rpm-basic-symlink-handling'Brad King2015-03-311-0/+6
|\ \ | | | | | | | | | | | | | | | 68e13e98 Help: Add notes for topic 'cpack-rpm-basic-symlink-handling' 681f3a2f CPackRPM: Add basic symlink support (#15209)
| * | Help: Add notes for topic 'cpack-rpm-basic-symlink-handling'Brad King2015-03-311-0/+6
| |/
* | Help: Refine COMPILE_OPTIONS property documentationBrad King2015-03-312-6/+7
| | | | | | | | | | | | Make wording of the directory and target properties more consitent and complementary. Specify that the value is a ";-list" with a link to the cmake-language(7) manual section on lists.
* | Help: Fix xref typos in target_compile_options docsBrad King2015-03-311-2/+2
| | | | | | | | Fix links to the COMPILE_OPTIONS directory and target properties.
* | Help: Add link target to cmake-language.7 lists sectionBrad King2015-03-311-0/+2
|/
* Merge topic 'add_dependencies-INTERFACE-libraries'Brad King2015-03-302-9/+19
|\ | | | | | | | | | | ac14cbf0 Allow add_dependencies() on INTERFACE libraries (#15414) 817d31db Help: Format add_dependencies documentation
| * Allow add_dependencies() on INTERFACE libraries (#15414)Brad King2015-03-272-2/+9
| | | | | | | | | | | | | | | | | | | | Revert commit v3.0.0-rc1~175^2~20 (add_dependencies: Disallow use with INTERFACE_LIBRARY, 2013-12-25). Teach our dependency analysis to transitively follow INTERFACE target utility dependencies as was done or IMPORTED targets in commit v2.8.6~127^2~1 (Allow add_dependencies() on imported targets, 2010-11-19). Extend the InterfaceLibrary test with a case to cover header generation for a header-only INTERFACE library via a custom target.
| * Help: Format add_dependencies documentationBrad King2015-03-271-9/+12
| | | | | | | | Add reStructuredText markup.
* | ExternalData: Add option to recursively match under directoriesBrad King2015-03-271-0/+7
|/ | | | | | Extend the ``DATA{Dir/,...}`` syntax with a new ``RECURSE:`` option to enable recursive matching of associated files. This will allow an entire directory tree of data to be referenced at once.