summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'doc-add_custom_command-multiple-commands'Brad King2014-09-041-1/+2
|\ | | | | | | | | 412926d0 Help: Clarify add_custom_command multiple command behavior (#15112)
| * Help: Clarify add_custom_command multiple command behavior (#15112)Brad King2014-09-021-1/+2
| | | | | | | | | | Explicitly say that the commands are not composed into a stateful script.
* | Help: Clarify --debug-trycompile usage with try_compileAlan W. Irwin2014-09-031-3/+4
|/ | | | | | Explain that try_compile calls need to be protected with conditions to avoid running more than once so that it is easy to isolate a single try_compile to perform with --debug-trycompile.
* StringUuid: Implement new string(UUID) sub-command.Nils Gladitz2014-08-281-0/+12
|
* Merge topic 'doc-add_custom_command'Brad King2014-08-061-121/+124
|\ | | | | | | | | | | | | 5bf1c5cc Help: Document add_custom_command PRE_BUILD/PRE_LINK for exe/lib only (#15059) 2a58c872 Help: Revise and format 'add_custom_command' docs cb88742d Help: Remove stray content from 'add_custom_command' docs
| * Help: Document add_custom_command PRE_BUILD/PRE_LINK for exe/lib only (#15059)Brad King2014-08-051-0/+2
| | | | | | | | | | | | | | State explicitly that the PRE_LINK mode is not for targets created by the add_custom_target command. The existing wording for PRE_BUILD being treated as PRE_LINK by non-VS generators will now imply this restriction for PRE_BUILD too.
| * Help: Revise and format 'add_custom_command' docsBrad King2014-08-051-97/+122
| | | | | | | | | | | | Format the reStructuredText markup manually. Organize the command options into a definition list. Use inline markup to cross-reference related documents.
| * Help: Remove stray content from 'add_custom_command' docsBrad King2014-08-051-24/+0
| | | | | | | | | | Remove leftover generator expression documentation that is now in the cmake-generator-expressions(7) manual.
* | file: Add ENCODING option to file(STRINGS) command (#10519)Clinton Stimpson2014-08-061-0/+3
|/ | | | Support extraction of UTF-8 strings.
* Help: Clarify target_link_libraries treatment of flags (#15034)Brad King2014-07-281-1/+4
| | | | Explain that link flags should not be used in transitive contexts.
* add_library: Allow arbitrary non-linked sources in OBJECT librariesBrad King2014-07-091-1/+2
| | | | | | | | | | | Loosen this restriction on OBJECT libraries to allow source files of any name to be generated by custom commands or listed for reference in IDE projects so long as they would not affect linking of a normal library. Update the rejection message to be more specific about the looser restriction. Extend the ObjectLibrary test to cover a ".cmake" file generated by a custom command in an OBJECT library.
* install(DIRECTORY): Add MESSAGE_NEVER option to avoid output (#13761)Brad King2014-06-241-1/+3
| | | | | | | | | | | | Installing large directories, e.g., the output of a doxygen run, prints one line per file resulting in too much noise in the build output. Add an option to the install(DIRECTORY) command to not print anything upon make install. Extend the RunCMake.install test with cases covering MESSAGE_NEVER behavior of the install(DIRECTORY) command. Suggested-by: Stefan Eilemann <Stefan.Eilemann@epfl.ch>
* install: Add CMAKE_INSTALL_MESSAGE variable (#13761)Brad King2014-06-242-1/+6
| | | | | | | | | Create a variable to allow users to control which installation messages are printed. In particular, provide a "LAZY" setting that prints "Installing" messages but not "Up-to-date" messages. This is desirable for incremental re-installations. Suggested-by: J Decker <d3ck0r@gmail.com>
* Help: Add install() command document section headersBrad King2014-06-241-5/+17
| | | | | Use section headers instead of horizontal dividers so that one may link to the sections.
* Help: Link to Object Library docs from add_libraryBrad King2014-06-121-2/+2
|
* Help: Organize add_library command documentationBrad King2014-06-121-4/+15
| | | | | Add a section for each library type signature. Add a table of contents at the top for the html builder.
* Help: Mention INTERFACE_SOURCES as settable for INTERFACE libsBrad King2014-06-121-2/+3
| | | | | | | The add_library(INTERFACE) and Interface Libraries documentation list all the INTERFACE_* properties and target_* commands that can be used to define the interface. Add INTERFACE_SOURCES and target_sources() to these lists for completeness.
* Help: Add comma to assist parsing of ctest_build command docs.Stephen Kelly2014-06-051-1/+1
|
* Help: Document that file(GENERATE) re-writes only when needed.Stephen Kelly2014-06-051-0/+2
|
* Help: Convert CTest Script variable references to cross-referencesBrad King2014-06-031-3/+5
| | | | | | In the ctest(1) manual and ctest_start() command documentation, convert mentions of CTest Script variables to cross-references so they will be rendered as links.
* Merge topic 'doc-include-dir-props'Brad King2014-06-031-0/+14
|\ | | | | | | | | 907e422b Help: Explain build/install-tree include dirs in more places (#14946)
| * Help: Explain build/install-tree include dirs in more places (#14946)Brad King2014-06-021-0/+14
| | | | | | | | | | | | | | | | | | | | | | Explain how to use $<BUILD_INTERFACE> and $<INSTALL_INTERFACE> directly in the documentation of the target_include_directories command and INTERFACE_INCLUDE_DIRECTORIES target property. Otherwise readers need to notice the link to the cmake-buildsystem(7) manual and find the example in that to understand the need for these expressions. Also fix the explanation in cmake-buildsystem(7) to not claim that relative paths may be used inside a BUILD_INTERFACE expression.
| * Merge branch 'doc-find_package-build-paths' into releaseBrad King2014-03-031-0/+1
| |\
| * \ Merge branch 'add_definitions-no-genex' into releaseBrad King2014-03-031-4/+2
| |\ \
| * \ \ Merge branch 'install-FILES-genex' into releaseBrad King2014-02-241-161/+168
| |\ \ \
* | | | | Help: Use "^^^^" for subsubsection headersBrad King2014-06-021-4/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is the convention suggested in the Sphinx documentation and is already used in several other places in the CMake documentation. Update a few places where we were using other characters.
* | | | | Merge topic 'feature-extensions-by-default'Brad King2014-06-021-1/+1
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 60a981ea Features: Enable compiler extensions by default.
| * | | | | Features: Enable compiler extensions by default.Stephen Kelly2014-05-311-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Compilers enable their extensions by default, and disabling them implicitly can lead to results which are surprising or non-obvious to debug. http://public.kitware.com/pipermail/cmake-developers/2014-May/010575.html http://thread.gmane.org/gmane.comp.programming.tools.cmake.devel/10214 https://www.mail-archive.com/cmake-developers@cmake.org/msg10116.html (Compiler feature extensions by default, 29 May 2014)
* | | | | | Merge topic 'doc-ctest-settings'Brad King2014-06-021-0/+6
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2d57a390 Help: Document ctest dashboard client usage 28f73dff Help: Document ctest_start initial checkout command variables
| * | | | | | Help: Document ctest_start initial checkout command variablesBrad King2014-05-301-0/+6
| |/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | Describe the behavior of the ctest_start() command when the CTEST_CHECKOUT_COMMAND or CTEST_CVS_CHECKOUT variable is set.
* | | | | | Help: Reference cmake_minimum_required from cmake_policy docsBrad King2014-05-301-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Note in a few places of the cmake_policy() command documentation that the cmake_minimum_required() command can set policies too. Inspired-by: Peter Kümmel <syntheticpp@gmx.net>
* | | | | | Help: Format cmake_policy command documentationBrad King2014-05-301-35/+45
|/ / / / / | | | | | | | | | | | | | | | | | | | | Add reStructuredText markup manually to improve formatting of the documentation. Organize the documentation into subsections.
* | | | | Merge topic 'doc-file-command'Brad King2014-05-271-178/+266
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | d74ed543 Help: Format and revise file() command documentation
| * | | | | Help: Format and revise file() command documentationBrad King2014-05-231-178/+266
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Organize the documentation by sub-command to keep the signatures and their descriptions nearby. Use inline and explicit reST markup. Revise wording as necessary for the updated layout. Clarify behavior of the file(GENERATE) command w.r.t. conflicting file names.
* | | | | | Merge topic 'doc-CTEST_BUILD_FLAGS'Brad King2014-05-271-0/+5
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | b8d6ab60 Help: describe CTEST_BUILD_FLAGS
| * | | | | | Help: describe CTEST_BUILD_FLAGSRolf Eike Beer2014-05-231-0/+5
| |/ / / / /
* | | | | | Help: Add a manual for compiler feature control.Stephen Kelly2014-05-271-1/+2
|/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Link to it from the documentation of related properties, variables and commands. Extend the cmake-developer(7) documentation with notes on extending feature support for compilers.
* | | | | Help: Fix whitespace in doc link.Stephen Kelly2014-05-201-1/+1
| | | | |
* | | | | Features: Extend concept to C language.Stephen Kelly2014-05-141-1/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add properties and variables corresponding to CXX equivalents. Add features for c_function_prototypes (C90), c_restrict (C99), c_variadic_macros (C99) and c_static_assert (C11). This feature set can be extended later. Add a <PREFIX>_RESTRICT symbol define to WriteCompilerDetectionHeader to conditionally represent the c_restrict feature.
* | | | | Allow the Package Registry to be disabled (#14849)Daniele E. Domenichelli2014-05-122-3/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When a project is packaged for redistribution the local package registries should not be updated or consulted. They are for developers. Add variables to disable use of package registries globally: * CMAKE_EXPORT_NO_PACKAGE_REGISTRY that disables the export(PACKAGE) command * CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY that disables the User Package Registry in all the find_package calls. * CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY that disables the System Package Registry in all the find_package calls. Update documentation and unit tests.
* | | | | Add target_compile_features command.Stephen Kelly2014-04-071-0/+30
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This can be used to set the compiler features required by particular targets. An error is issued at CMake time if the compiler does not support the required feature. If a language dialect flag is required by the features used, that will be added automatically. Base the target_compile_features command on cmTargetPropCommandBase. This gives us 'free' handling of IMPORTED, ALIAS, INTERFACE, non-compilable and missing targets.
* | | | | target_sources: New command to add sources to target.Stephen Kelly2014-04-021-0/+28
| | | | |
* | | | | cmTarget: Allow any generator expression in SOURCES property.Stephen Kelly2014-04-022-4/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Remove use of UseObjectLibraries from Makefile and Ninja generators. It is not needed now because those generators use GetExternalObjects which already contains the objects from object libraries. The VS10 generator calls both the UseObjectLibraries and the GetExternalObjects methods. Ensure that duplicates are not created by skipping objects from object libraries in handling of GetExternalObjects. Similarly, fix VS6, VS7 and Xcode object handling by skipping external objects from OBJECT_LIBRARY usage as appropriate. The error message in the BadSourceExpression1 test is now reported by the generator expression evaluator, so it has different text.
* | | | | cmStringCommand: Add GENEX_STRIP subcommand.Stephen Kelly2014-03-311-0/+5
| | | | | | | | | | | | | | | | | | | | Strip out any generator expressions in the input string.
* | | | | add_custom_command: Evaluate generator expressions in DEPENDSStephen Kelly2014-03-201-0/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Rely on evaluation in cmCustomCommandGenerator for the generators. When tracing target dependencies, depend on the union of dependencies for all configurations.
* | | | | Merge topic 'doc-find_package-build-paths'Brad King2014-03-051-0/+1
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | 69d73d27 Help: Mention in find_package that cmake-gui step is Windows-only (#14781)
| * | | | Help: Mention in find_package that cmake-gui step is Windows-only (#14781)Brad King2014-03-031-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Recently used cmake-gui locations are searched only on Windows because the Windows registry is used to record the values. This behavior is historical and may be removed by a policy in the future so rather than implementing it on other platforms simply document the current behavior.
* | | | | Merge topic 'add_definitions-no-genex'Brad King2014-03-031-4/+2
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | 1a9316a8 add_definitions: Don't document genex support.
| * | | | add_definitions: Don't document genex support.Stephen Kelly2014-03-031-4/+2
| |/ / / | | | | | | | | | | | | | | | | | | | | This command does not support generator expressions. The documentation was mistakenly extended to claim it in commit v3.0.0-rc1~60^2~3 (Help: Mark up the buildsystem commands documentation, 2014-02-03).
* | | | Merge topic 'install-FILES-genex'Brad King2014-02-241-161/+168
|\ \ \ \ | |_|/ / |/| | / | | |/ | |/| | | | | | | 6e89c8a5 install: Support generator expressions in FILES and PROGRAMS mode f11f7b34 cmInstallFilesGenerator: Add reference to calling cmMakefile e190236c Help: Format install() command documentation