summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* 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
| * install: Support generator expressions in FILES and PROGRAMS modeBrad King2014-02-211-0/+6
| | | | | | | | | | | | | | | | Teach the install(FILES) and install(PROGRAMS) commands to evaluate generator expressions in the list of files. Extend the ExportImport test to cover installation cases involving generator expressions.
| * Help: Format install() command documentationBrad King2014-02-211-161/+162
| | | | | | | | Add inline markup and explicit markup blocks as appropriate.
* | Help: Revise and format add_test() command documentationBrad King2014-02-201-48/+38
|/ | | | | Favor the add_test(NAME) signature and document the limitations of the plain signature.
* Help: Format find_package() command documentationBrad King2014-02-171-189/+171
| | | | | Add inline markup and explicit markup block syntax as needed. Add cross-references to other documentation as appropriate.
* Help: Mark up the buildsystem commands documentationStephen Kelly2014-02-069-283/+334
| | | | Cross-link to the cmake-buildsystem manual.
* Help: Use ``inline-literals`` to mark generator expressions.Stephen Kelly2014-02-067-7/+7
|
* project: Manage VERSION variablesBrad King2014-01-291-1/+26
| | | | | | | | | | | | | | | | 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>
* project: Add optional LANGUAGES keywordBrad King2014-01-291-2/+3
| | | | | | | Teach the project() command to recognize an optional "LANGUAGES" keyword after the project name and prior to the list of languages. Do not allow multiple copies of the keyword. If the keyword is specified and no languages are listed, imply NONE.
* Help: Format project command and variable documentationBrad King2014-01-291-19/+23
| | | | Also add document for CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE variable.
* Help: Fix typo in 'if()' command documentationRaphael Kubo da Costa2014-01-151-1/+1
| | | | s/argumemnts/arguments/
* add_library: Disallow invalid signatures for INTERFACE_LIBRARY.Stephen Kelly2014-01-061-4/+13
| | | | | Document the valid signatures. Add a test for the IMPORTED GLOBAL signature.
* export: Implement EXPORT subcommand (#9822)Stephen Kelly2013-12-241-10/+20
| | | | | | Teach the export command to handle export sets defined by invocations of install(TARGETS ... EXPORT foo). This makes maintenance of targets exported to both the build tree and install tree trivial.
* Help: Clarify if(TARGET) behavior (#14646)Brad King2013-12-181-1/+3
| | | | | Define the meaning of a "target" clearly and link to the commands that create them.
* Help: Format 'if' command documentationBrad King2013-12-181-207/+167
| | | | | | | Manually update reStructuredText formatting. Use a definition list for the possible if() tests supported. Add inline literal markup as appropriate. Also make minor wording tweaks to make it flow better with the new markup.
* Help: Format and clarify source_group() documentation (#14631)Brad King2013-12-051-14/+30
| | | | | Refine the .rst formatting. Document the FILES option explicitly and specify how it treats relative paths.
* Help: Document the CMAKE_FIND_ROOT_PATH* variables.Stephen Kelly2013-11-276-10/+10
| | | | | Add a replacement template for the variables, and link to them from the documentation for the find_* commands.
* Introduce CMAKE_STAGING_PREFIX variable.Stephen Kelly2013-11-211-3/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | This variable can be useful in cross-compiling contexts where the sysroot is read-only or where the sysroot should otherwise remain pristine. If the new CMAKE_STAGING_PREFIX variable is set, it is used instead of CMAKE_INSTALL_PREFIX when generating the installation rules in cmake_install.cmake. This way, the CMAKE_INSTALL_PREFIX variable always refers to the installation prefix on the target device, regardless of whether host==target. If any -rpath paths passed to the linker contain the CMAKE_STAGING_PREFIX, the matching path fragments are replaced with the CMAKE_INSTALL_PREFIX. Matching paths in the -rpath-link are not transformed. The cross-prefix usr-move workaround is assumed not to require extension regarding CMAKE_STAGING_PREFIX. The staging area is a single prefix, so there is no scope for cross-prefix symlinks. The CMAKE_INSTALL_PREFIX is still used to determine the workaround path, and that variable remains the relevant one even if CMAKE_STAGING_PREFIX is used. If the generated export files are deployed to the target, the workaround will still be in place, and still be employed if required.
* Merge topic 'macro-args-docs'Brad King2013-11-194-14/+51
|\ | | | | | | | | f0db2e3 Help: Document macro argument caveats in more detail
| * Help: Document macro argument caveats in more detailDaniele E. Domenichelli2013-11-194-14/+51
| | | | | | | | | | | | Add notes about macro arguments in the foreach, if, and list commands. Add a section to the macro command documentation explaining in detail how macro arguments are not variables.
* | Merge topic 'cross-compiling-toolchain-variables'Brad King2013-11-191-2/+9
|\ \ | | | | | | | | | | | | | | | | | | | | | 7cd65c9 Add CMAKE_SYSROOT variable to set --sysroot when cross compiling. 5096967 Allow toolchain files to specify an external toolchain. 76552d5 Add compiler target compile options. f41ecd1 CMakeDetermineCompilerId: Look for internal file only on host
| * | Add CMAKE_SYSROOT variable to set --sysroot when cross compiling.Stephen Kelly2013-11-191-2/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | As CMAKE_ROOT_FIND_PATH can be a list, a new CMAKE_SYSROOT is introduced, which is never a list. The contents of this variable is passed to supporting compilers as --sysroot. It is also accounted for when processing implicit link directories reported by the compiler, and when generating RPATH information.
* | | Merge topic 'cleanup-build-commands'Brad King2013-11-191-19/+26
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 4cce44b Help: Document the CMAKE_MAKE_PROGRAM variable in more detail 558c74d VS: Switch to internal CMAKE_MAKE_PROGRAM lookup by generators 5229f2d Tests: Do not use an explicit make program for VS generators 72dd738 Tests: Fix MFC test heuristic for empty CMAKE_TEST_MAKEPROGRAM fd6076d Tests: Pass CMAKE_MAKE_PROGRAM instead of --build-makeprogram 68031ab Tests: Configure SubProject-Stage2 test more robustly 003d10c Tests: Simplify VSExcludeFromDefaultBuild configuration e47d934 Tests: Simplify VSProjectInSubdir configuration e965cb1 Tests: Simplify CTest.BuildCommand.ProjectInSubdir configuration 72bf255 Tests: Pass --build-options to every test 4d1d772 ctest: Teach --build-options to allow zero options 96966b5 ctest: Make the --build-makeprogram optional for --build-and-test 91a0211 Simplify some calls to cmGlobalGenerator::Build 123a060 Teach GenerateBuildCommand to find its own make program 5f5c92b VS: Add internal APIs to find MSBuild, devenv/VCExpress, and msdev 4ac75fd Prefer CMAKE_MAKE_PROGRAM over CMAKE_BUILD_TOOL (#14548) ...
| * | build_command: Return a "cmake --build" command-lineBrad King2013-11-151-19/+26
| |/ | | | | | | | | | | | | | | | | | | | | | | | | | | Re-implement the build_command() command to use "cmake --build" instead of generating a native build tool invocation directly. This command will internally invoke the proper native build tool. This avoids requiring cmGlobalGenerator::GenerateBuildCommand to produce a string so that it can be later refactored to produce a vector with no quoting or escaping. It will also allow us to later teach CMake to delay the decision about which build tool to invoke until after the project build system is generated to disk. For example, on Visual Studio 10 and above the preferred command-line tool is MSBuild, but we need to fall back to devenv if the .sln has Intel Fortran .vfproj files.
* | CTest: added documentation for the "Upload" submission PARTNils Gladitz2013-11-151-0/+1
|/
* Help: Clarify execute_process COMMAND argument behaviorBrad King2013-11-071-0/+14
| | | | | | | | State in the execute_process how COMMAND arguments are passed to the child. Add a note at the end about how the command differs from add_custom_*(). Suggested-by: Alan W. Irwin
* Help: Format execute_process command documentationBrad King2013-11-071-26/+39
| | | | | Use a code-block for the signature. Format the options as a definition list.
* Merge topic 'policy-CMP0022-fixes-for-master'Brad King2013-11-041-7/+10
|\ | | | | | | | | | | | | | | | | | | | | | | b51696f CMP0022: Update target_link_libraries plain signature documentation 25b7f87 Merge branch 'policy-CMP0022-fixes' into policy-CMP0022-fixes-for-master 0a561a0 CMP0022: Warn about a given target at most once 23d21b7 Do not export INTERFACE_LINK_LIBRARIES from non-linkable targets ef10b87 CMP0022: Plain target_link_libraries must populate link interface 0e06788 CMP0022: Add test for target_link_libraries plain signature c0f4a61 CMP0022: Add unit test for null pointer check and message. 4b0cfa7 Merge branch 'output-CMP0022-entries' into policy-CMP0022-fixes
| * CMP0022: Update target_link_libraries plain signature documentationBrad King2013-11-031-7/+10
| | | | | | | | | | | | Make the documentation change made by commit ef10b87c (CMP0022: Plain target_link_libraries must populate link interface, 2013-11-02) in the new location for the same documentation.
* | Add missing documentation for include dirs related variables. (#12611)Stephen Kelly2013-11-021-1/+1
|/ | | | | Document CMAKE_INCLUDE_DIRECTORIES_BEFORE and CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE.
* Merge topic 'minor-cleanups'Brad King2013-10-241-1/+1
|\ | | | | | | | | | | f3f49ff Docs: Fix typo b0686fd Docs: Fix typo.
| * Docs: Fix typoStephen Kelly2013-10-231-1/+1
| | | | | | | | opitions -> options.
* | Add policy CMP0036 to disallow build_nameBrad King2013-10-221-1/+3
| |
* | Add policy CMP0035 to disallow variable_requiresBrad King2013-10-221-1/+3
| |
* | Add policy CMP0034 to disallow utility_sourceBrad King2013-10-221-0/+2
| |
* | Add policy CMP0033 to disallow export_library_dependenciesBrad King2013-10-221-1/+3
| |
* | Add policy CMP0032 to disallow output_required_filesBrad King2013-10-221-1/+3
| |
* | Add policy CMP0031 to disallow load_commandBrad King2013-10-221-0/+2
| |
* | Add policy CMP0030 to disallow use_mangled_mesaBrad King2013-10-221-0/+2
| |
* | Add policy CMP0029 to disallow subdir_dependsBrad King2013-10-221-1/+3
|/
* 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.
* | target_link_libraries(): Fix code snippet in documentation.Stephen Kelly2013-10-181-1/+2
|/ | | | The porting script seems to have made a mistake here.
* Help: Factor out cmake-generator-expressions manual pageBrad King2013-10-167-473/+18
| | | | | | | | | Generator expressions are supported in many places and are a distinct concept worthy of their own manual page. The old builtin documentation was previously represented by preprocessor macros to generate it into each place that supports them. Factor out the duplicate content into a dedicated cmake-generator-expressions manual page and reference it from each original location.
* Help: Factor out find_* command duplicationBrad King2013-10-169-628/+227
| | | | | | | These documents were represented in the builtin documentation using a common starting point with placeholders substituted by each command. Convert them back to this approach using the reStructuredText include directive and substitutions to avoid duplication.
* Help: Fix reStructuredText syntax in auto-generated documentsBrad King2013-10-157-9/+9
|
* Convert builtin help to reStructuredText source filesKitware Robot2013-10-15113-0/+5553
Run the convert-help.bash script to convert documentation: ./convert-help.bash "/path/to/CMake-build/bin" Then remove it.