summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* cmake-server: Add documentationTobias Hunger2016-09-192-0/+191
|
* find_package: Optionally sort globbed directories in a meaningful orderPierluigi Taddei2016-09-151-0/+2
| | | | | | | | | | | | Add `CMAKE_FIND_PACKAGE_SORT_{ORDER,DIRECTION}` variables to specify sort order and direction. When multiple package with the same name have been found in the same location sorting option can be used to force a specific version to be loaded (e.g. libA_1.12.0 instead of libA_1.1.0). Currently sorting by NAME and by NATURAL order have been implemented. Natural ordering makes use of the `strverscmp(3)` ordering.
* Help: Clarify documentation of CMAKE_COMPILER_IS_GNU{CC,CXX,G77}Brad King2016-09-141-1/+3
| | | | Closes: #16308
* VS15: Add Visual Studio 15 generatorBrad King2016-09-071-0/+1
| | | | | | | | | | | | | | | | Call the generator "Visual Studio 15" without any year because the preview version of VS 15 does not provide a year in the product name. Copy cmGlobalVisualStudio14Generator to cmGlobalVisualStudio15Generator and update version numbers accordingly. Add the VS15 enumeration value. Note that we do not need to add a MSVC15 variable or v150 toolset because Visual Studio 15 comes with an updated version of the v140 toolset and remains ABI-compatible. Teach tests VSExternalInclude, RunCMake.GeneratorPlatform, and RunCMake.GeneratorToolset to treat VS 15 as they do VS 10-14. Closes: #16143
* Document XCODE variableRuslan Baratov2016-08-311-0/+1
|
* Merge topic 'android-platform-modules'Brad King2016-08-242-5/+208
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 7b637ebd Android: Add `ANDROID` variable to indicate the target c2f561e5 Android: Add test cases covering use of the NDK and standalone toolchains 6b84df8d Help: Document cross compiling for Android d7d40830 Android: Select the STL type for NDK builds b22294bc Android: Populate compiler flags for current ABI b6a3102a Android: Add a CMAKE_BUILD_TYPE default d1e3cec2 Android: Add Clang -target option for current ABI 504db72d Android: Add placeholders for compiler/abi-specific settings fa632578 Android: Avoid interfering with common pre-existing toolchain files 6299693f Android: Search for NDK and standalone toolchain in more places 29b51379 Android: Detect and save a standalone toolchain without the NDK 7d9b49fb Android: Detect settings from the CMAKE_SYSROOT if it is set 4389664a Android: Detect and save a toolchain from the NDK 328191f6 Android: Set CMAKE_SYSROOT automatically 9e032304 Android: Detect and save the architecture, ABI, and processor fde59c4d Android: Detect and save the API level ...
| * Android: Add `ANDROID` variable to indicate the targetBrad King2016-08-231-0/+1
| | | | | | | | | | Allow projects to use `if(ANDROID)` to condition their Android-specific code paths.
| * Help: Document cross compiling for AndroidBrad King2016-08-232-5/+207
| | | | | | | | | | | | CMake now supports cross compiling for Android using the NDK or a standalone toolchain. Document the associated variables and how how to write toolchain files for Android.
* | cmake: Add `cmake -E capabilities` modeTobias Hunger2016-08-161-0/+37
|/ | | | | | | Add `cmake -E capabilities` to report on generators, cmake version and possibly other static capabilities of cmake. Closes: #15462
* Add additional <= and >= comparison operatorsChuck Atkins2016-08-091-2/+6
| | | | | This adds the LESS_EQUAL, GREATER_EQUAL, and associated STR and VERSION equivalents to use the combined <= and >= functionality.
* Honor CMAKE_*_LINKER_FLAGS[_<CONFIG>]_INIT set in toolchain filesBrad King2016-07-141-0/+8
| | | | | | | | | | | | | | Document these variables. Change our convention for setting these variables from: set(CMAKE_EXE_LINKER_FLAGS_INIT "...") to string(APPEND CMAKE_EXE_LINKER_FLAGS_INIT " ...") so that any value previously set by a toolchain file will be used.
* Merge topic 'findicu'Brad King2016-07-131-0/+1
|\ | | | | | | | | | | e3bff7b3 Help: Add notes for topic 'findicu' 4a63be15 FindICU: New module
| * FindICU: New moduleRoger Leigh2016-07-131-0/+1
| |
* | Fix typos.Felix Geyer2016-07-101-1/+1
|/
* Merge topic 'toolchain-flag-init'Brad King2016-07-071-0/+5
|\ | | | | | | | | | | | | | | a66004be Honor CMAKE_<LANG>_FLAGS[_<CONFIG>]_INIT set in toolchain files cdde77e5 OpenWatcom: Partially modernize platform information modules f9dbe22c Intel: Do not use GNU-like flags on Windows 5a3ed0d7 Intel: Do not use MSVC-like flags for Fortran
| * Honor CMAKE_<LANG>_FLAGS[_<CONFIG>]_INIT set in toolchain filesBrad King2016-07-061-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Document these variables. Change our convention for setting these variables from: set(CMAKE_C_FLAGS_INIT "...") to string(APPEND CMAKE_C_FLAGS_INIT " ...") so that any value previously set by a toolchain file will be used. Automate the conversion with: sed -i 's/set *(\(CMAKE_\(C\|CXX\|Fortran\|RC\|ASM\|${[^}]\+}\)_FLAGS\(_[^_]\+\)\?_INIT \+"\)/string(APPEND \1 /' \ Modules/Compiler/*.cmake Modules/Platform/*.cmake and follow up with some manual fixes (e.g. to cases that already meant to append). Also revert the automated changes to contexts that are not protected from running multiple times.
* | Merge topic 'reorganize-cmCTest'Brad King2016-07-061-53/+51
|\ \ | |/ |/| | | | | | | | | | | | | | | | | | | 61fcd08a Help: Fix documentation of ctest --build-and-test 7c67d401 Help: Consistently use quotes and fix punctuation in ctest(1) manual 0076fb10 cmCTest: Update doxygen to be consistent 30c5f94c cmCTest: Rename "ProcessTests()" to "ProcessSteps()" and improve doxygen 7c87ab75 cmCTest: Facilitate code reading adding consistent comments in Run() 6d8b9aa6 cmCTest: Improve readability adding "HandleTest(Action|Model)Argument()" 280d0a69 cmCTest: Improve readability adding "RunCMakeAndTest()" and "ExecuteTests()" 898cb987 cmCTest: Fix typo
| * Help: Fix documentation of ctest --build-and-testJean-Christophe Fillion-Robin2016-07-051-3/+2
| | | | | | | | | | | | Since commit v3.0.0-rc1~260^2~14 (ctest: Make the --build-makeprogram optional for --build-and-test, 2013-11-14), binary dictionary is also required to run CTest given the option `--build-nocmake`.
| * Help: Consistently use quotes and fix punctuation in ctest(1) manualJean-Christophe Fillion-Robin2016-07-051-51/+50
| |
* | Merge topic 'try_compile-config-flags'Brad King2016-06-301-0/+8
|\ \ | | | | | | | | | | | | d582c23a try_compile: Add policy CMP0066 to honor CMAKE_<LANG>_FLAGS_<CONFIG>
| * | try_compile: Add policy CMP0066 to honor CMAKE_<LANG>_FLAGS_<CONFIG>Brad King2016-06-291-0/+8
| |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In the `try_compile` source file signature we propagate the caller's value of `CMAKE_<LANG>_FLAGS` into the test project. Extend this to propagate `CMAKE_<LANG>_FLAGS_<CONFIG>` too instead of always using the default value in the test project. This will be useful, for example, to allow the MSVC runtime library to be changed (e.g. `-MDd` => `-MTd`). However, some projects may currently depend on this not being done, so we need to activate the behavior using a policy. This change was originally made by commit v3.6.0-rc1~160^2 (try_compile: Honor CMAKE_<LANG>_FLAGS_<CONFIG> changes, 2016-04-11) but without the policy and so had to be reverted during the 3.6 release candidate cycle. Fixes #16174.
* | Avoid using KWSys auto_ptr by adopting it ourselvesBrad King2016-06-291-3/+4
|/ | | | | | | | | | | | Replace use of cmsys::auto_ptr with a CM_AUTO_PTR macro that maps to our own implementation adopted from the KWSys auto_ptr implementation. Later we may be able to map CM_AUTO_PTR to std::auto_ptr on compilers that do not warn about it. Automate the client site conversions: git grep -l auto_ptr -- Source/ | grep -v Source/kwsys/ | xargs sed -i \ 's|cmsys::auto_ptr|CM_AUTO_PTR|;s|cmsys/auto_ptr.hxx|cm_auto_ptr.hxx|'
* Merge topic 'vs-tool-override'Brad King2016-06-231-0/+1
|\ | | | | | | | | ed05f11d VS: Add a VS_TOOL_OVERRIDE source file property
| * VS: Add a VS_TOOL_OVERRIDE source file propertyGilles Khouzam2016-06-201-0/+1
| | | | | | | | | | | | | | | | This property allow to specify a specific Visual Studio tool for a source file overriding the default tool behavior. For example, a `.resw` file being processed as a `PriResource` file. This has the advantage of being able to teach CMake to process new file types without code modifications.
* | VS: Add VS_SDK_REFERENCES target property to reference external SDKsGilles Khouzam2016-06-221-0/+1
|/ | | | | Allow one to specify external SDK references such as `Microsoft.AdMediatorWindows81, Version=1.0`.
* cmake: Add an option to control what files needs to be tracedAlex Turbov2016-06-171-0/+5
| | | | | | | | | | Even in relatively small projects using `--trace` (and `--trace-expand`) may produce a lot of output. When developing a custom module usually one is interested in output of only a few particular modules. Add a `--trace-source=<file>` option to enable tracing only a subset of source files. The final output would be only from requested modules, ignoring anything else not matched to given filename(s).
* Merge topic 'xcode-mig-support'Brad King2016-06-171-0/+1
|\ | | | | | | | | | | | | | | | | | | 8be00e44 Help: Add release note about XCODE_FILE_ATTRIBUTES source file property 27eb657d Xcode: Add support for mig files 811f6c82 Xcode: Add XCODE_FILE_ATTRIBUTES source file property ef494edf Xcode: Don't emit empty settings blocks. 82ebbf68 Xcode: Add function to conditionally add Xcode Attributes 025edea0 Xcode: Add const qualifiers
| * Xcode: Add XCODE_FILE_ATTRIBUTES source file propertyJames Touton2016-06-171-0/+1
| | | | | | | | This adds values to the ATTRIBUTES list in PBXBuildFile settings.
* | Merge topic 'link_what_you_use'Brad King2016-06-172-0/+2
|\ \ | | | | | | | | | | | | | | | a0902efa Help: Add notes for topic 'link_what_you_use' 96242f80 Add options to run `ldd -u -r` as a "link-what-you-use" tool
| * | Add options to run `ldd -u -r` as a "link-what-you-use" toolBill Hoffman2016-06-172-0/+2
| |/ | | | | | | | | | | | | Create a LINK_WHAT_YOU_USE target property and corresponding CMAKE_LINK_WHAT_YOU_USE variable to enable this behavior. Extend link commands by running `ldd -u -r` to detect shared libraries that are linked but not needed.
* | Teach find_library and find_package to search lib32 paths (#11260)Daniel Scharrer2016-06-101-0/+1
|/ | | | | | | Add a ``FIND_LIBRARY_USE_LIB32_PATHS`` global property analogous to the ``FIND_LIBRARY_USE_LIB64_PATHS`` property. This helps find commands on multilib systems that use ``lib32`` directories and either do not have ``lib`` symlinks or point ``lib`` to ``lib64``.
* Merge topic 'add-FindVulkan'Brad King2016-06-081-0/+1
|\ | | | | | | | | adf4df28 Add FindVulkan.cmake.
| * Add FindVulkan.cmake.Matthäus G. Chajdas2016-06-081-0/+1
| | | | | | | | This adds FindVulkan with corresponding tests.
* | Merge topic 'doc-ctest_update'Brad King2016-06-081-0/+5
|\ \ | | | | | | | | | | | | | | | 1b18180e Help: Document CTest Git fetch-and-reset behavior 558e4d1e Help: Document ctest_update branch following behavior
| * | Help: Document CTest Git fetch-and-reset behaviorBrad King2016-06-081-0/+5
| |/
* | productbuild: Add new productbuild cpack generator.Clinton Stimpson2016-06-031-0/+1
|/ | | | This cpack generator basically replaces the obsolete PackageMaker generator.
* try_compile: Optionally forward custom platform variables to test projectBrad King2016-05-251-0/+1
| | | | | | | | | Add a `CMAKE_TRY_COMPILE_PLATFORM_VARIABLES` variable to specify a list of custom variables to be forwarded to a `try_compile` test project. This will be useful for platform information modules or toolchain files to forward some platform-specific set of variables from the host project (perhaps set in its cache) to the test project so that it can build the same way.
* Add a variable to specify language-wide system include directoriesBrad King2016-05-251-0/+1
| | | | | | | Create a `CMAKE_<LANG>_STANDARD_INCLUDE_DIRECTORIES` variable to specify system include directories for for `<LANG>` compiler command lines. This plays a role for include directories as the existing `CMAKE_<LANG>_STANDARD_LIBRARIES` variable does for link libraries.
* Help: Document CMAKE_<LANG>_STANDARD_LIBRARIES variableBrad King2016-05-241-1/+1
| | | | | Also drop documentation of non-existent CMAKE_STANDARD_LIBRARIES variable.
* Ninja: Support embedding of CMake as subninja projectNicolas Despres2016-05-171-0/+1
| | | | | | Add a `CMAKE_NINJA_OUTPUT_PATH_PREFIX` variable. When it is set, CMake generates a `build.ninja` file suitable for embedding into another ninja project potentially generated by an alien generator.
* Help: Document `cmake --build` as a separate command mode (#16093)Brad King2016-05-101-18/+34
| | | | | | | The `--build` mode was confusingly documented among other options, falsely implying that it can be used anywhere on the command line. Move the documentation to a dedicated section and clarify its usage as s separate command line mode.
* Help: Document `cmake --find-package` as a separate command modeBrad King2016-05-101-6/+19
|
* Merge topic 'doc-cmake-E-updates'Brad King2016-05-031-2/+5
|\ | | | | | | | | | | 960afaad Help: Improve 'cmake -E md5sum' documentation 25ee2c86 Help: Add missing space in cmake(1) manual
| * Help: Improve 'cmake -E md5sum' documentationBartosz Kosiorek2016-05-021-1/+4
| |
| * Help: Add missing space in cmake(1) manualBartosz Kosiorek2016-05-021-1/+1
| |
* | Help: Add policy summaries to cmake-policies(7)Brad King2016-05-021-66/+66
| | | | | | | | | | | | | | | | In Sphinx output formats that print the toctree the policy numbers in links from the cmake-policies(7) manual are not descriptive. Convert the toctree entries to cross-reference syntax and add the summary of each policy. For now simply duplicate the policy summary line. We already maintain copies in `cmPolicies.h` and `Help/policy/*.rst` docs.
* | Help: Organize cmake-policies(7) manual by version of introductionBrad King2016-05-021-67/+109
|/
* Features: Specify minimum version Intel C++ 12.1Robert Maynard2016-04-281-0/+1
| | | | | | Versions below 12.1 do not provide enough information to properly detect if compiling with c++98 or c++0x enabled so remove them from the supported list.
* Merge topic 'AddDocumentationForEclipseVariables'Brad King2016-04-181-0/+4
|\ | | | | | | | | 7b3a1069 Help: Document Eclipse-generator related variables (#15827)
| * Help: Document Eclipse-generator related variables (#15827)Alex Neundorf2016-04-181-0/+4
| |