summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
* Restore --help-full option to output all help manualsBrad King2014-04-251-0/+6
| | | | | | This option was removed during conversion to the reStructuredText documentation. Restore it. Process documentation starting at Help/index.rst so that all manuals are included in the output.
* Merge branch 'revise-compiler-id-policies' into releaseBrad King2014-04-021-0/+1
|\
| * Do not warn by default when policy CMP0025 or CMP0047 is not setBrad King2014-04-021-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | These policies are triggered by the use of a particular compiler rather than outdated CMake code in a project. Avoid warning in every project that enables a language by not displaying the policy warning by default. Add variable CMAKE_POLICY_WARNING_CMP<NNNN> to control the warning explicitly; otherwise enable the warning with --debug-output or --trace. This breaks with strict policy convention because it does not provide developers with any warning about the behavior change by default. Existing projects will continue to build without a warning or change in behavior. When a developer changes the minimum required version of CMake in a project to a sufficiently high value (3.0), the project will suddenly get the new compiler id and may break, but at least the breakage comes with a change to the project rather than the version of CMake used to build it. Breaking strict policy convention is worthwhile in this case because very few projects will be affected by the behavior change but every project would have to see the warning if it were enabled by default.
* | Help: Fix typo in cmake-qt manual.Stephen Kelly2014-03-261-1/+1
|/ | | | Do -> To.
* Merge branch 'doc-osx-path-variables' into releaseBrad King2014-03-101-0/+2
|\
| * Help: Document variables CMAKE_APPBUNDLE_PATH and CMAKE_FRAMEWORK_PATHBrad King2014-03-101-0/+2
| |
* | Help: List the whitelist of properties for INTERFACE libraries.Stephen Kelly2014-02-261-0/+10
|/
* Merge topic 'doc-usage-requirements'Brad King2014-02-191-0/+6
|\ | | | | | | | | 0c54b775 Help: Document the purpose of usage requirements clearly.
| * Help: Document the purpose of usage requirements clearly.Stephen Kelly2014-02-181-0/+6
| | | | | | | | | | | | | | | | | | | | People will be tempted to put things there for convenience, thereby causing conflicts similar to http://thread.gmane.org/gmane.comp.compilers.clang.devel/35162/focus=35169 where it is conceivable that the LLVM developers could put a flag on a target for convenience, which would cause conflicts for some downstreams.
* | Merge topic 'doc-package-registry'Brad King2014-02-191-0/+129
|\ \ | | | | | | | | | | | | | | | bf012e0c Help: Format find_package() command documentation bd6887e4 Help: Document the package registry in cmake-packages.7
| * | Help: Document the package registry in cmake-packages.7Brad King2014-02-171-0/+129
| |/ | | | | | | | | | | | | | | Port documentation from the CMake Wiki page at: http://www.cmake.org/Wiki/CMake/Tutorials/Package_Registry as of 2014-02-17 into our main documentation.
* | Help: Fix typoStephen Kelly2014-02-171-2/+2
|/ | | | binary_find -> binary_search.
* add_custom_command: Disallow use of SOURCE signatures.Stephen Kelly2014-02-121-0/+1
| | | | Add CMP0050 to control this behavior.
* Add policy CMP0049 to avoid variable expansion in source listsStephen Kelly2014-02-121-0/+1
|
* Merge topic 'extend-docs'Brad King2014-02-103-4/+17
|\ | | | | | | | | | | | | 0b3e98d9 Help: Don't list debuggable properties in cmake-buildsystem manual. 39d08b92 Help: Add additional hyperlink targets ef17e293 Help: Document SYSTEM treatment of IMPORTED target INTERFACE_INCLUDE_DIRS
| * Help: Don't list debuggable properties in cmake-buildsystem manual.Stephen Kelly2014-02-101-4/+2
| |
| * Help: Add additional hyperlink targetsStephen Kelly2014-02-093-0/+7
| |
| * Help: Document SYSTEM treatment of IMPORTED target INTERFACE_INCLUDE_DIRSStephen Kelly2014-02-091-0/+8
| | | | | | | | Document how the behavior can be controlled.
* | Help: Add hyperlink targets for argument types in cmake-language(7)Brad King2014-02-071-0/+6
|/ | | | | Add reStructuredText hyperlink targets for the bracket, quoted, and unquoted argument sections.
* Help: Note that the compatible interface properties must not intersect.Stephen Kelly2014-02-061-0/+4
|
* Help: Specify how to order and modify transitively set property values.Stephen Kelly2014-02-061-1/+21
|
* Help: Add hyperlink targets to some manual sections.Stephen Kelly2014-02-061-0/+9
| | | | | These can be refered to from the command documentation and other relevant locations.
* Help: Mark up references to NEW and OLD policy settings properly.Stephen Kelly2014-02-061-4/+4
|
* Help: Add a style guide.Stephen Kelly2014-02-061-2/+167
|
* Help: Fix typosStephen Kelly2014-02-062-2/+2
| | | | | | | | Psuedo -> Pseudo behaviour -> behavior CMake uses American spelling.
* Merge topic 'cmake-qt-manual'Brad King2014-02-031-0/+184
|\ | | | | | | | | | | | | 4271a4ed Help: Add information about INTERFACE_AUTOUIC_OPTIONS. 7935f4de Help: Note that AUTOMOC consumes the defines and includes from targets. 2739a6f9 Help: Move Qt tool invocation information to a generic cmake-qt manual.
| * Help: Add information about INTERFACE_AUTOUIC_OPTIONS.Stephen Kelly2014-02-021-0/+40
| |
| * Help: Note that AUTOMOC consumes the defines and includes from targets.Stephen Kelly2014-02-021-0/+4
| |
| * Help: Move Qt tool invocation information to a generic cmake-qt manual.Stephen Kelly2014-02-021-0/+140
| | | | | | | | | | | | | | | | Add an introduction about the use of different package types, and the ability to use Qt 4 and 5 versions together in a single buildsystem. Add a section about automatic linking of the qtmain.lib library and how to disable it.
* | project: Manage VERSION variablesBrad King2014-01-292-0/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Teach the project() command to set variables {PROJECT,<PROJECT-NAME>}_VERSION{,_MAJOR,_MINOR,_PATCH,_TWEAK} holding the project version number and its components. Add project() command option "VERSION" to specify the version explicitly, and default to the empty string when it is not given. Since this clears variables when no VERSION is given, this may change behavior for existing projects that set the version variables themselves prior to calling project(). Add policy CMP0048 for compatibility. Suggested-by: Alex Neundorf <neundorf@kde.org>
* | Help: Format project command and variable documentationBrad King2014-01-291-0/+1
|/ | | | Also add document for CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE variable.
* Help: Note that std::string::clear may not be used.Stephen Kelly2014-01-271-4/+6
| | | | | As found in commit 519c0a5d (Can't use std::string::clear() in cmake., 2012-09-15).
* Help: Document non-use of std::set::insert.Stephen Kelly2014-01-271-0/+23
| | | | | As found in commit 8e7c207e (Use a manual loop to insert into set::set., 2012-09-15).
* Merge topic 'cmake-rerun-depends'Brad King2014-01-221-0/+1
|\ | | | | | | | | | | 82d43175 Allow projects to specify extra inputs to CMake 1ef444d6 Add test case to verify CMake does not re-run on first build
| * Allow projects to specify extra inputs to CMakeBrad King2014-01-211-0/+1
| | | | | | | | | | | | | | Define a new 'CMAKE_CONFIGURE_DEPENDS' directory property that projects can use to specify input files to the CMake configuration process. Extend the RunCMake.Configure test to verify that the build system re-runs CMake when this input changes.
* | Merge topic 'cmake-E-sleep'Brad King2014-01-221-1/+1
|\ \ | |/ | | | | | | 94389f63 cmake: Add '-E sleep' command
| * cmake: Add '-E sleep' commandBrad King2014-01-211-1/+1
| | | | | | | | Add a cmake command-line interface to provide a cross-platform 'sleep'.
* | QNX: Introduce QCC compiler id for that QNX platform compiler.Stephen Kelly2014-01-221-0/+1
|/ | | | | | | | | | | | | | | | | | | | | | | | Introduce policy CMP0047 to control resetting the id for compatibility. De-duplicate content in the QNX platform file by including the GNU one. QNX is a form of GNU platform. Do not clear CMAKE_SHARED_LIBRARY_${lang}_FLAGS variables. They are populated again later by the Compiler/GNU.cmake file anyway. Modify the CMAKE_CXX_COMPILE_OBJECT variable only when the QCC compiler id is in use, and the language is CXX. Use the QNX recommended flag for QCC instead of the gcc compatible -x flag. Populate new module files to handle system includes and depfiles when using the QCC compiler. Remove code which unsets the system include and depfiles related variables. When a GNU driver is used instead of the QCC one, the appropriate flags will be used. These variables were previously cleared for lowest-common-denominator compatibility with both drivers.
* Merge topic 'update-qt4-docs'Brad King2014-01-201-3/+0
|\ | | | | | | | | f81e67c6 Help: Update Qt4 documentation.
| * Help: Update Qt4 documentation.Stephen Kelly2014-01-151-3/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Remove independent doc listing for Qt4ConfigurationSettings, Qt4Macros and UseQt4. These are implementation details. Recommend the use of IMPORTED targets. Remove references to the UseQt4 file, which is obsolete in light of the IMPORTED targets. Add documentation for automatic tool invocation and options. Remove reference to variables which should not be needed in modern implementations.
* | Help: Document CMAKE_OSX_* variablesBrad King2014-01-161-0/+3
|/ | | | | | | | | | Add documentation entries for variables CMAKE_OSX_ARCHITECTURES CMAKE_OSX_DEPLOYMENT_TARGET CMAKE_OSX_SYSROOT Explain what each does and when/how they should be set.
* allow to mark a test as "Not Run" with a specific return code (#8466)Rolf Eike Beer2014-01-141-0/+1
|
* Merge topic 'support-codelite-ide-generator'Brad King2014-01-131-0/+1
|\ | | | | | | | | 0c4e8c70 Add support for codelite IDE project fles
| * Add support for codelite IDE project flesEran Ifrah2014-01-101-0/+1
| |
* | AddDependencies: new policy requires dependencies to existNils Gladitz2014-01-121-0/+1
|/ | | | | Added new policy CMP0046 which requires dependencies added by add_dependencies() to actually exist.
* Merge topic 'extend-docs'Brad King2014-01-092-5/+37
|\ | | | | | | | | | | 2f15a07 Help: Link to CMAKE_POLICY_DEFAULT_CMP<NNNN> in policies manual. bb8bde3 Help: Add notes about relocatability of config-file packages.
| * Help: Link to CMAKE_POLICY_DEFAULT_CMP<NNNN> in policies manual.Stephen Kelly2014-01-091-1/+3
| |
| * Help: Add notes about relocatability of config-file packages.Stephen Kelly2014-01-091-4/+34
| |
* | Merge topic 'minor-cleanups'Brad King2014-01-091-1/+1
|\ \ | | | | | | | | | | | | | | | | | | | | | 531e40b cmTarget: Make GetSourceFiles populate an out-vector parameter. 38de54c cmGeneratorTarget: Add methods to access source file groups. f579fe0 Help: Fix link to MAP_IMPORTED_CONFIG_<CONFIG> 590d238 cmTarget: Handle NO_SYSTEM_FROM_IMPORTED.
| * | Help: Fix link to MAP_IMPORTED_CONFIG_<CONFIG>Stephen Kelly2014-01-081-1/+1
| |/