summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'doc-policy-OLD-deprecated'Brad King2015-06-0967-5/+139
|\ | | | | | | | | 482a3bf3 Help: Document explicitly that policy OLD behavior is deprecated
| * Help: Document explicitly that policy OLD behavior is deprecatedBrad King2015-06-0967-5/+139
| | | | | | | | | | | | | | | | | | | | | | 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-formatting'Brad King2015-06-0959-345/+352
|\ \ | | | | | | | | | | | | c3f40f4f Help: Improve formatting of command documentation
| * | Help: Improve formatting of command documentationMichael Scott2015-06-0859-345/+352
| | | | | | | | | | | | | | | Use inline reStructuredText markup and add cross-references in more places.
* | | Merge topic 'doc-find-versioned-location'Brad King2015-06-091-0/+5
|\ \ \ | | | | | | | | | | | | | | | | 7ab0806f Help: Document find_* command versioned/unversioned name ordering
| * | | Help: Document find_* command versioned/unversioned name orderingBrad King2015-06-081-0/+5
| | | | | | | | | | | | | | | | | | | | Suggest in the NAMES option that unversioned names go first to prefer local builds over distro-provided files.
* | | | Merge topic 'doc-find-command-cleanup'Brad King2015-06-0913-119/+184
|\ \ \ \ | |/ / / | | | | | | | | | | | | | | | | | | | | | | | | 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: Improve documentation formatting of find_* commandsBrad King2015-06-086-90/+114
| | | | | | | | | | | | | | | | | | | | Use inline reStructuredText markup and add cross-references in more places.
| * | | Help: Document CMAKE_FIND_APPBUNDLE and CMAKE_FIND_FRAMEWORKBrad King2015-06-086-29/+53
| | | | | | | | | | | | | | | | | | | | 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-082-0/+8
| | | |
| * | | Help: Document CMAKE_SYSTEM_FRAMEWORK_PATH variableBrad King2015-06-082-0/+9
| |/ /
* | | Merge topic 'doc-drop-incorrect-cmake-developer-advice'Brad King2015-06-091-1/+0
|\ \ \ | | | | | | | | | | | | | | | | 972853b1 Help: Drop incorrect advice from cmake-developer.7 manual
| * | | 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.
* | | Merge topic 'revert-mingw-no-find_library-dll'Brad King2015-06-091-6/+0
|\ \ \ | |_|/ |/| | | | | | | | f5dbf00d Windows-GNU: Restore find_library treatment of '.dll' as linkable (#15409)
| * | Windows-GNU: Restore find_library treatment of '.dll' as linkable (#15409)Brad King2015-06-081-6/+0
| | | | | | | | | | | | | | | | | | | | | Revert commit v3.3.0-rc1~435^2 (Windows-GNU: Do not tell find_library to treat '.dll' as linkable, 2015-02-18). MinGW tools support linking to '.dll' files directly and many non-CMake build systems still do not provide a separate '.dll.a' file.
* | | Merge topic 'doc-add_custom_command-clarify-TARGET_FILE'Brad King2015-06-081-0/+3
|\ \ \ | | | | | | | | | | | | | | | | 0e708d17 Help: Reference TARGET_FILE genex in add_custom_command docs (#15605)
| * | | Help: Reference TARGET_FILE genex in add_custom_command docs (#15605)Brad King2015-06-081-0/+3
| | |/ | |/| | | | | | | | | | | | | | | | | | | | | | When documenting in the COMMAND option how to reference an executable, we previously only explicitly covered how to do it for argv[0] and left it to the reader to follow the reference to the generator expressions manual. Add explicit mention of the TARGET_FILE genex in this documentation since it will be a commonly used generator expression in this context.
* | | Merge topic 'ExternalProject_init_selected_submodules'Brad King2015-06-081-0/+7
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 77ee6db5 Help: Add notes for topic 'ExternalProject_init_selected_submodules' 124243c0 ExternalProject: Add unit tests for GIT_SUBMODULES argument 14e2c3ad ExternalProject: Initialize only selected git submodules (#15590)
| * | | Help: Add notes for topic 'ExternalProject_init_selected_submodules'Brad King2015-06-081-0/+7
| | | |
* | | | Remove CMAKE_USE_RELATIVE_PATHS variable.Stephen Kelly2015-06-032-7/+7
|/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The test for this variable was removed in commit v2.8.8~330^2~7 (complex: Remove ancient unused ComplexRelativePaths test, 2011-12-23). Commit v3.1.0-rc1~425^2~2 (backtrace: Convert to local paths in IssueMessage, 2014-03-12) appears to have accidentally made some backtraces print relative paths with the variable because conversions which used to be done at configure time, before the variable had an effect are now potentially done at generate time. The documentation of the variable says not to use it, and the docs are wrong in that the variable actually applies in per-directory scope. The read of the variable makes it harder to split conversion methods from cmLocalGenerator where they don't belong. Remove it now.
* | | Begin post-3.3 developmentBrad King2015-06-022-0/+9
| |/ |/|
* | Help: Drop development topic notes to prepare releaseBrad King2015-06-022-9/+0
|/ | | | | Release versions do not have the development topic section of the CMake Release Notes index page.
* Help: Organize and revise 3.3 release notesBrad King2015-06-021-139/+169
| | | | | | Add section headers similar to the 3.2 release notes and move each individual bullet into an appropriate section. Revise and consolidate some bullets covering related areas.
* Help: Consolidate 3.3 release notesBrad King2015-06-0256-363/+264
| | | | | | | | | | | | | | Move all development release notes into a new version-specific document: tail -q -n +3 Help/release/dev/* > Help/release/3.3.rst git rm -- Help/release/dev/* except the sample topic: git checkout HEAD -- Help/release/dev/0-sample-topic.rst Reference the new document from the release notes index document. Add a title and intro sentence to the new document by hand.
* Merge topic 'doc-add_dependencies-no-install'Brad King2015-06-011-1/+2
|\ | | | | | | | | 9504d7a9 Help: Explicitly mention lack of 'install' support in add_dependencies
| * Help: Explicitly mention lack of 'install' support in add_dependenciesBrad King2015-06-011-1/+2
| | | | | | | | | | | | CMake-generated targets are not supported by add_dependencies. State this explicitly and use 'install' as an example since this may be commonly attempted.
* | 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.
* Merge topic 'extend-visibility-properties'Brad King2015-05-267-21/+54
|\ | | | | | | | | | | | | | | 700f1c3b Honor visibility properties for all target types (#15556) 50de5dbb Help: Format visibility property and variable documentation 771f1b00 Tests: Rename Visibility{InlinesHidden =>} ab55b3b5 Tests: Refactor RunCMake.VisibilityPreset test setup
| * Honor visibility properties for all target types (#15556)Brad King2015-05-265-4/+42
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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.
| * Help: Format visibility property and variable documentationBrad King2015-05-224-18/+13
| | | | | | | | Add reStructuredText markup appropriately.
* | Merge topic 'ExternalData-no-symlinks'Brad King2015-05-261-0/+7
|\ \ | |/ |/| | | | | 0de47b05 ExternalData: Add option to disable use of symlinks
| * ExternalData: Add option to disable use of symlinksBrad King2015-05-221-0/+7
| | | | | | | | | | | | | | | | | | Add an ExternalData_NO_SYMLINKS to enable use of copies instead of symlinks to populate the real data files behind a DATA{} reference. This will be useful on UNIX-like systems when the underlying filesystem does not actually support symbolic links. Suggested-by: Matt McCormick <matt.mccormick@kitware.com>
* | Revert "Qbs: Add new 'extra' generator for qbs project files"Brad King2015-05-213-32/+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 'cmake-gui-osx-install-command-line'Brad King2015-05-211-0/+10
|\ | | | | | | | | | | | | | | e462ef74 Help: Add notes for topic 'cmake-gui-osx-install-command-line' 8ea2db26 cmake-gui: Replace command-line install dialog with information box 438ce4a0 cmake-gui: Add --install option to add command-line tools on OS X 41477d5c cmake-gui: Drop undocumented and unused --mac-install option
| * Help: Add notes for topic 'cmake-gui-osx-install-command-line'Brad King2015-05-211-0/+10
| |
* | 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-195-0/+29
|/ | | | | | 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.
* Merge topic 'cpack-ifw-updates'Brad King2015-05-181-0/+5
|\ | | | | | | | | | | 342d15cb Update packaging of CMake for QtIFW 2.0 9a0ba4d2 CPackIFW: Add QtIFW 2.0 support
| * CPackIFW: Add QtIFW 2.0 supportKonstantin Podsvirov2015-05-151-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | Add variables: - CPACK_IFW_FRAMEWORK_VERSION - CPACK_IFW_PACKAGE_ALLOW_NON_ASCII_CHARACTERS - CPACK_IFW_PACKAGE_ALLOW_SPACE_IN_PATH - CPACK_IFW_PACKAGE_CONTROL_SCRIPT - CPACK_IFW_PACKAGE_MAINTENANCE_TOOL_INI_FILE - CPACK_IFW_PACKAGE_MAINTENANCE_TOOL_NAME - CPACK_IFW_PACKAGE_START_MENU_DIRECTORY - CPACK_IFW_VERBOSE
* | Help: Document behavior of cmake_minimum_required in a functionBrad King2015-05-151-0/+4
| | | | | | | | | | Add a note to the cmake_minimum_required documentation about the limits of calling it in a function.
* | install: Disallow installing export() result.Stephen Kelly2015-05-143-0/+33
|/
* Merge topic 'ctest-no-make-i'Brad King2015-05-124-2/+35
|\ | | | | | | | | | | | | 226df303 CTest: Stop telling 'make' to ignore errors with -i 28e7a135 Help: Fix build_command alternative signature docs 231601b6 build_command: Choose configuration consistently across signatures
| * CTest: Stop telling 'make' to ignore errors with -iBrad King2015-05-124-1/+34
| | | | | | | | Add policy CMP0061 to maintain compatibility for existing projects.
| * Help: Fix build_command alternative signature docsBrad King2015-05-121-1/+1
| | | | | | | | | | Do not specify that --config will not be added, because the command does add it.
* | Merge topic 'cpack-deb-component-dependencies'Brad King2015-05-121-0/+6
|\ \ | | | | | | | | | | | | | | | 1237d5fa Help: Add notes for topic 'cpack-deb-component-dependencies' e3f522f6 CPack/DEB per component dependencies
| * | Help: Add notes for topic 'cpack-deb-component-dependencies'Brad King2015-05-121-0/+6
| |/
* | Merge topic 'find_package-no-cmake-gui-paths'Brad King2015-05-122-11/+15
|\ \ | | | | | | | | | | | | | | | 1506f9ca find_package: Drop search in recent cmake-gui locations 8d484463 FindFLTK: Drop search in recent cmake-gui locations