summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'doc-rst-note-and-productionlist'Brad King2013-11-021-0/+10
|\ | | | | | | | | 450b515 cmRST: Add support for the note and productionlist directives
| * cmRST: Add support for the note and productionlist directivesBrad King2013-10-301-0/+10
| | | | | | | | | | | | Simply print out the lines as normal paragraph text. Teach the CMakeLib.testRST test to cover this syntax. Update the cmake-developer.7 manual to document support for the directives.
* | Help: Limit reference manual toctree depth to 1Brad King2013-11-016-0/+36
| | | | | | | | | | | | Add a :maxdepth: option to all toctree directives to limit their depth to 1. We do not want subheadings from individual documents to pollute the already large lists of CMake Domain objects.
* | Merge topic 'add-CMAKE_FIND_NO_INSTALL_PREFIX'Brad King2013-11-012-0/+14
|\ \ | | | | | | | | | | | | fe057ab Allow disabling adding the install prefix to the prefix search path.
| * | Allow disabling adding the install prefix to the prefix search path.Stephen Kelly2013-10-312-0/+14
| | | | | | | | | | | | | | | | | | | | | In certain scenarios, it is preferable to keep a 'dirty' install prefix than to clear it, and to expect that content will not be found there. Add a CMAKE_FIND_NO_INSTALL_PREFIX variable that can be set to disable searching the install prefix.
* | | Merge topic 'vs-generator-names'Brad King2013-10-317-30/+39
|\ \ \ | |_|/ |/| | | | | | | | 29071fe VS: Add version year to generator names
| * | VS: Add version year to generator namesBrad King2013-10-287-30/+39
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Rename the Visual Studio >= 10 generators to indicate the version year: Visual Studio 10 => Visual Studio 10 2010 Visual Studio 11 => Visual Studio 11 2012 Visual Studio 12 => Visual Stduio 12 2013 Report the names with the year to the list of available generators so that the cmake-gui drop-down shows the years. When selecting a generator from the "-G" option or from an existing CMAKE_GENERATOR cache entry, recognize names without the years for compatibility and map them to the names with years. Update the generator names in the cmake-generators.7 manual.
* | | Help: Glob manual/*.rst in Sphinx configurationBrad King2013-10-3013-0/+26
| | | | | | | | | | | | | | | | | | | | | Add the man page description line as explicit markup at the top of each Help/manual/*.rst file and scan it from conf.py to automatically generate the man_pages Sphinx configuration value. This reduces the number of places that need to be changed when a new manual is added.
* | | Merge topic 'doc-organize-index'Brad King2013-10-291-0/+2
|\ \ \ | | | | | | | | | | | | | | | | c9d5ccf Help: Add index document title
| * | | Help: Add index document titleBrad King2013-10-291-0/+2
| | | | | | | | | | | | | | | | | | | | Add an explicit title directive to set the HTML index page title instead of taking the first section header.
* | | | Merge topic 'doc-organize-index'Brad King2013-10-291-10/+28
|\ \ \ \ | |/ / / | | | / | |_|/ |/| | 2c7cd95 Help: Organize top-level index
| * | Help: Organize top-level indexBrad King2013-10-281-10/+28
| |/ | | | | | | | | Divide the list of manuals into separate sections each with its own title.
* | Merge topic 'Qt-auto-generators'Brad King2013-10-2814-0/+154
|\ \ | |/ |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 9c87d9c Add automatic rcc invocation for Qt. 84218e1 Add automatic uic invocation for Qt. 94a0ca6 Record which files are skipped by automoc. 18fb758 Run the main executable created in the autogen tests. e485ba1 Rename the QtAutomoc tests to QtAutogen. 7ce65c3 Add extra checks for the AUTOMOC target property. 32771fc Update output messages for generic use. f371ab5 Rename RunAutomoc to RunAutogen. 85b3d6e Extract an SetupAutoMocTarget method. ca124a1 Rename the AutomocInfo.cmake file to be more generic. a342c9f Move some makefile definitions up away from moc-specific code. 98632ef Add the AUTOGEN_TARGETS_FOLDER and obsolete AUTOMOC_TARGETS_FOLDER. 63378ba Rename some variables to reflect broader scope. 97f1aa3 Rename method to reflect generic use. 4abb111 Rename local variable to reflect generic use. 03878c9 Move variable set to where it is used. ...
| * Add automatic rcc invocation for Qt.Stephen Kelly2013-10-247-0/+71
| | | | | | | | | | This replaces the need to invoke qt4_add_resources by allowing adding the source .qrc file directly to the target sources.
| * Add automatic uic invocation for Qt.Stephen Kelly2013-10-247-0/+72
| | | | | | | | | | | | | | | | | | | | | | | | The source files are already processed by cmQtAutomoc to look for moc includes, so extend that to also look for ui_ includes and find corresponding .ui files to process. This replaces the need to invoke qt4_wrap_ui(). As the ui files are not likely to be part of the SOURCES of the target, store the options associated with them separately in the cmMakefile for querying during the autogen run.
| * Add the AUTOGEN_TARGETS_FOLDER and obsolete AUTOMOC_TARGETS_FOLDER.Stephen Kelly2013-10-243-0/+11
| |
* | Merge topic 'compatible-interface-numbers'Brad King2013-10-265-3/+42
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | ff6c401 cmTarget: Add interface for compatible numeric properties e4e20c1 cmTarget: Add enumeration for consistency to expect from properties. 9877769 cmTarget: Assign consistent content back to the property being evaluated. 816b4a8 cmTarget: Make consistentProperty return consistent content. 030800a cmTarget: Add a template to create correct implied content.
| * | cmTarget: Add interface for compatible numeric propertiesStephen Kelly2013-10-245-3/+42
| |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When using the boost MPL library, one can set a define to increase the limit of how many variadic elements should be supported. The default for BOOST_MPL_LIMIT_VECTOR_SIZE is 20: http://www.boost.org/doc/libs/1_36_0/libs/mpl/doc/refmanual/limit-vector-size.html If the foo library requires that to be set to 30, and the independent bar library requires it to be set to 40, consumers of both need to set it to 40. add_library(foo INTERFACE) set_property(TARGET foo PROPERTY INTERFACE_boost_mpl_vector_size 30) set_property(TARGET foo PROPERTY COMPATIBLE_INTERFACE_NUMBER_MAX boost_mpl_vector_size) target_compile_definitions(foo INTERFACE BOOST_MPL_LIMIT_VECTOR_SIZE=$<TARGET_PROPERTY:boost_mpl_vector_size>) add_library(bar INTERFACE) set_property(TARGET bar PROPERTY INTERFACE_boost_mpl_vector_size 40) # Technically the next two lines are redundant, but as foo and bar are # independent, they both set these interfaces. set_property(TARGET bar PROPERTY COMPATIBLE_INTERFACE_NUMBER_MAX boost_mpl_vector_size) target_compile_definitions(bar INTERFACE BOOST_MPL_LIMIT_VECTOR_SIZE=$<TARGET_PROPERTY:boost_mpl_vector_size>) add_executable(user) target_link_libraries(user foo bar) Because the TARGET_PROPERTY reads the boost_mpl_vector_size property from the HEAD of the dependency graph (the user target), and because that property appears in the COMPATIBLE_INTERFACE_NUMBER_MAX of the dependencies of the user target, the maximum value for it is chosen for the compile definition, ie, 40. There are also use-cases for choosing the minimum value of a number. In Qt, deprecated API can be disabled by version. Setting the definition QT_DISABLE_DEPRECATED_BEFORE=0 disables no deprecated API. Setting it to 0x501000 disables API which was deprecated before Qt 5.1 etc. If two dependencies require the use of API which was deprecated in different Qt versions, then COMPATIBLE_INTERFACE_NUMBER_MIN can be used to ensure that both can compile.
* | Merge topic 'remove-pre-2.4-compatibility'Brad King2013-10-261-8/+1
|\ \ | | | | | | | | | | | | | | | 7d47c69 Drop compatibility with CMake < 2.4 c7c44fc CTestTest*: Update minimum required CMake to 2.4
| * | Drop compatibility with CMake < 2.4Brad King2013-10-231-8/+1
| |/ | | | | | | | | | | | | | | | | | | | | | | Drop all behavior activated by setting CMAKE_BACKWARDS_COMPATIBILITY to a value lower than 2.4, and generate an error when projects or the user attempt to do so. In the error suggest using a CMake 2.8.x release. Teach cmake_minimum_required to warn about projects that do not require at least CMake 2.4. They are not supported by CMake >= 3.0. Replace the documentation of CMAKE_BACKWARDS_COMPATIBILITY with a reference to policy CMP0001.
* | Merge topic 'minor-cleanups'Brad King2013-10-243-3/+3
|\ \ | | | | | | | | | | | | | | | f3f49ff Docs: Fix typo b0686fd Docs: Fix typo.
| * | Docs: Fix typoStephen Kelly2013-10-231-1/+1
| | | | | | | | | | | | opitions -> options.
| * | Docs: Fix typo.Stephen Kelly2013-10-232-2/+2
| | | | | | | | | | | | dependee -> depender.
* | | cmRST: Teach cmake-module directive to scan bracket commentsBrad King2013-10-231-6/+22
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When scanning CMake module files for .rst comments, recognize bracket comments starting in ".rst:" too. For example: #[[.rst: Include the bracket comment content terminated by the closing bracket. Exclude the line containing the bracket if it starts in "#". Teach the CMakeLib.testRST test to cover multiple bracket lengths and ending brackets on lines with and without "#". Update the cmake-developer.7 manual to document the bracket-comment syntax for .rst documentation.
* | | cmake-developer.7: Improve flow of module documentation instructionsBrad King2013-10-231-17/+18
| |/ |/| | | | | | | Use prose instead of enumerated steps and re-order the steps so that the cmake-module directive is covered contiguously.
* | Merge topic 'doc-cmake-developer'Brad King2013-10-232-0/+498
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | e0ce6f0 cmRST: Cross-reference cmake-developer.7 manual and cmRST Doxygen c1c239b Help: Add documentation format to cmake-developer.7 manual a06a90f Help: Organize cmake-developer.7 manual Modules section 28f08ba Help: Fix module documentation markup in cmake-developer.7 manual baaab06 Help: Move Modules/readme.txt content into cmake-developer.7 manual 80a311e Help: Add cmake-developer.7 manual
| * | cmRST: Cross-reference cmake-developer.7 manual and cmRST DoxygenBrad King2013-10-221-0/+3
| | | | | | | | | | | | | | | | | | The cmRST implementation and the list of capabilities documented in the cmake-developer.7 manual must be kept in sync. Add a note to each file to reference the other.
| * | Help: Add documentation format to cmake-developer.7 manualBrad King2013-10-221-0/+205
| | | | | | | | | | | | | | | | | | Document how CMake uses reStructuredText to provide the help manuals. Cover supported inline markup and directives, the CMake Domain in Sphinx, and cross-reference syntax.
| * | Help: Organize cmake-developer.7 manual Modules sectionBrad King2013-10-221-50/+74
| | | | | | | | | | | | | | | | | | Add "Module Documentation" and "Find Modules" subsections. Add to Modules/readme.txt a textual reference to the cmake-developer.7 manual and, while at it, fix the wiki URL domain.
| * | Help: Fix module documentation markup in cmake-developer.7 manualKitware Robot2013-10-221-102/+161
| | | | | | | | | | | | | | | | | | | | | Convert the content moved from Modules/readme.txt to valid reStructuredText markup. Mainly, convert the lists of variables to definition lists, wrap long lines in paragraph text, and add literal block markup and indentation.
| * | Help: Move Modules/readme.txt content into cmake-developer.7 manualKitware Robot2013-10-221-0/+188
| | | | | | | | | | | | | | | | | | | | | Move all content from Modules/readme.txt except for the link to the module maintainers wiki page into "Help/manual/cmake-developer.7.rst". This produces some invalid reStructuredText markup to be fixed in a future commit.
| * | Help: Add cmake-developer.7 manualBrad King2013-10-222-0/+19
| | | | | | | | | | | | | | | Add the manual with just an introduction section. Leave section headers for Help and Modules to be filled in later.
* | | Add policy CMP0036 to disallow build_nameBrad King2013-10-223-1/+16
| | |
* | | Add policy CMP0035 to disallow variable_requiresBrad King2013-10-223-1/+14
| | |
* | | Add policy CMP0034 to disallow utility_sourceBrad King2013-10-223-0/+14
| | |
* | | Add policy CMP0033 to disallow export_library_dependenciesBrad King2013-10-223-1/+18
| | |
* | | Add policy CMP0032 to disallow output_required_filesBrad King2013-10-223-1/+17
| | |
* | | Add policy CMP0031 to disallow load_commandBrad King2013-10-223-0/+16
| | |
* | | Add policy CMP0030 to disallow use_mangled_mesaBrad King2013-10-223-0/+14
| | |
* | | Add policy CMP0029 to disallow subdir_dependsBrad King2013-10-223-1/+14
| | |
* | | Add infrastructure for policies that disallow commandsBrad King2013-10-221-0/+9
| |/ |/| | | | | | | | | | | | | Add cmCommand::Disallowed helper to check the setting of a policy that disallows the command. Add a RunCMake.DisallowedCommands test placeholder. Add a Help/policy/DISALLOWED_COMMAND.txt file for inclusion by each policy document to avoid duplication of the common text.
* | Merge topic 'string-CONCAT-command'Brad King2013-10-221-0/+4
|\ \ | | | | | | | | | | | | 4e184a2 string: Add CONCAT sub-command
| * | string: Add CONCAT sub-commandBrad King2013-10-211-0/+4
| | | | | | | | | | | | | | | | | | Add a string(CONCAT) command to simply concatenate input arguments together. This will be useful for combining strings from different quoting syntaxes. Add a RunCMake.string test covering these cases.
* | | Merge topic 'doc-vs-keyword-properties'Brad King2013-10-222-2/+8
|\ \ \ | | | | | | | | | | | | | | | | b9fe4b6 VS: Document VS_GLOBAL_KEYWORD and VS_KEYWORD relationship (#14493)
| * | | VS: Document VS_GLOBAL_KEYWORD and VS_KEYWORD relationship (#14493)Brad King2013-10-212-2/+8
| |/ / | | | | | | | | | | | | | | | | | | These two target properties serve the same purpose for different versions of Visual Studio. Document the versions covered by each property. Reported-by: mar.na@t-online.de
* | | Merge topic 'double-colon-is-imported'Brad King2013-10-222-0/+24
|\ \ \ | | | | | | | | | | | | | | | | f063c45 Consider targets with double colons to be IMPORTED or ALIAS targets.
| * | | Consider targets with double colons to be IMPORTED or ALIAS targets.Stephen Kelly2013-10-212-0/+24
| |/ / | | | | | | | | | | | | | | | | | | | | | Introduce a policy to control the behavior. The AliasTargets unit test already tests that using a double-semicolon in the name is not an error. Change the ExportImport test to use a namespace with a double-semicolon too.
* | | Merge topic 'cmake--build-pipes'Brad King2013-10-221-4/+1
|\ \ \ | | | | | | | | | | | | | | | | bcd5de7 cmake: Always pass through stdout/stderr in --build mode
| * | | cmake: Always pass through stdout/stderr in --build modeBrad King2013-10-181-4/+1
| |/ / | | | | | | | | | | | | | | | Enable the --use-stderr behavior by default and ignore the old option. Passing through the pipes allows color terminal output and other things to work as if one ran the native build command directly.
* | | Merge topic 'remove-cmake-i-wizard'Brad King2013-10-221-6/+0
|\ \ \ | |_|/ |/| | | | | | | | a8226e9 cmake: Drop support for "-i" wizard mode