... | ... | @@ -29,10 +29,10 @@ and CTest. |
|
|
Variables](https://cmake.org/cmake/help/latest/manual/cmake-variables.7.html)
|
|
|
- [Structure of a CMake Build
|
|
|
System](https://cmake.org/cmake/help/latest/manual/cmake-buildsystem.7.html)
|
|
|
- [FAQ (Frequently asked questions)](CMake_FAQ "wikilink")
|
|
|
- [FAQ (Frequently asked questions)](FAQ "wikilink")
|
|
|
- [CMake Mailing List](https://cmake.org/mailman/listinfo/cmake) (for
|
|
|
searchable archives see [CMake
|
|
|
FAQ](CMake_FAQ#Where_can_I_find_searchable_CMake_Mailing_Archives "wikilink"))
|
|
|
FAQ](FAQ#Where_can_I_find_searchable_CMake_Mailing_Archives "wikilink"))
|
|
|
- [Release
|
|
|
Notes](https://cmake.org/cmake/help/latest/release/index.html%7CCMake)
|
|
|
|
... | ... | @@ -48,50 +48,50 @@ and CTest. |
|
|
- [A quick introduction to CMake
|
|
|
syntax](https://cmake.org/cmake/help/latest/manual/cmake-language.7.html#syntax)
|
|
|
- [On variables, lists, strings, maps, regexps,
|
|
|
etc.](CMake%3AVariablesListsStrings "wikilink")
|
|
|
- [Language syntax](CMake/Language_Syntax "wikilink")
|
|
|
etc.](doc/cmake/VariablesListsStrings "wikilink")
|
|
|
- [Language syntax](doc/cmake/Language-Syntax "wikilink")
|
|
|
|
|
|
## Guides
|
|
|
|
|
|
#### General
|
|
|
|
|
|
- [Cross compiling](CMake_Cross_Compiling "wikilink")
|
|
|
- [Cross compiling](doc/cmake/CrossCompiling "wikilink")
|
|
|
- [How to write platform checks with
|
|
|
CMake](CMake%3AHow_To_Write_Platform_Checks "wikilink")
|
|
|
- [How to find libraries](CMake%3AHow_To_Find_Libraries "wikilink")
|
|
|
- [How to install things](CMake%3AInstall_Commands "wikilink")
|
|
|
CMake](doc/tutorials/How-To-Write-Platform-Checks "wikilink")
|
|
|
- [How to find libraries](doc/tutorials/How-To-Find-Libraries "wikilink")
|
|
|
- [How to install things](doc/cmake/Install-Commands "wikilink")
|
|
|
|
|
|
#### Specific
|
|
|
|
|
|
- [RPATH handling](CMake_RPATH_handling "wikilink")
|
|
|
- [RPATH handling](doc/cmake/RPATH-handling "wikilink")
|
|
|
- [Editors/IDEs with CMake syntax
|
|
|
support](CMake_Editors_Support "wikilink")
|
|
|
support](doc/Editors "wikilink")
|
|
|
- [How to export symbols from a Windows DLL for the non-Windows
|
|
|
Developer](BuildingWinDLL "wikilink")
|
|
|
Developer](doc/tutorials/BuildingWinDLL "wikilink")
|
|
|
- [Appending the SO version to
|
|
|
DLLs](RecipeAddSoVersionToDLLs "wikilink")
|
|
|
- [Advanced Usage of CMake Build Rules](CMake_Build_Rules "wikilink")
|
|
|
DLLs](doc/cmake/recipe/AddSoVersionToDLLs "wikilink")
|
|
|
- [Advanced Usage of CMake Build Rules](doc/cmake/Build-Rules "wikilink")
|
|
|
- [How to Check the Current
|
|
|
Platform](CMake_Checking_Platform "wikilink")
|
|
|
Platform](doc/cmake/Checking-Platform "wikilink")
|
|
|
|
|
|
## Development Topics
|
|
|
|
|
|
- [Assembler Support](CMake/Assembler "wikilink")
|
|
|
- [Assembler Support](doc/cmake/languages/Assembler "wikilink")
|
|
|
- [Docs for Specific Project
|
|
|
Generators](CMake_Generator_Specific_Information "wikilink")
|
|
|
Generators](doc/cmake/Generator-Specific-Information "wikilink")
|
|
|
(Eclipse, KDevelop3, CodeBlocks, Makefile)
|
|
|
- [Contributed macros](CMake_User_Contributed_Macros "wikilink")
|
|
|
- [Module Maintainers](CMake%3AModule_Maintainers "wikilink")
|
|
|
- [Contributed macros](Contrib "wikilink")
|
|
|
- [Module Maintainers](doc/cmake/dev/Module-Maintainers "wikilink")
|
|
|
- [Platform Dependent
|
|
|
Information](CMake_Platform_Dependent_Issues "wikilink")
|
|
|
Information](doc/cmake/Platform-Dependent-Issues "wikilink")
|
|
|
- [Documentation for previous
|
|
|
releases](CMake_Released_Versions "wikilink")
|
|
|
releases](doc/cmake/version_compatibility_matrix/Released-Versions "wikilink")
|
|
|
- [CMake Life Cycle
|
|
|
Considerations](CMake_Life_Cycle_Considerations "wikilink")
|
|
|
Considerations](doc/cmake/Life-Cycle-Considerations "wikilink")
|
|
|
- [Matrix for checking backwards-compatibility of current
|
|
|
features](CMake_Version_Compatibility_Matrix "wikilink")
|
|
|
features](doc/cmake/Version-Compatibility-Matrix "wikilink")
|
|
|
- [CMake builtin documentation
|
|
|
handling](CMake_builtin_documentation_handling "wikilink")
|
|
|
handling](doc/cmake/builtin-documentation-handling "wikilink")
|
|
|
- [The architecture of Open Source Applications -
|
|
|
CMake](http://www.aosabook.org/en/cmake.html)
|
|
|
|
... | ... | @@ -127,24 +127,24 @@ and CTest. |
|
|
- [Empirical approach to
|
|
|
CMAKE](http://rachid.koucha.free.fr/tech_corner/cmake_manual.html)
|
|
|
by Rachid Koucha
|
|
|
- [Minimal examples](CMake/MinimalExamples "wikilink") (wiki page)
|
|
|
- [Minimal examples](doc/cmake/MinimalExamples "wikilink") (wiki page)
|
|
|
|
|
|
### Finding stuff and platform checking
|
|
|
|
|
|
- [How to package your project for use by
|
|
|
others](CMake/Tutorials#CMake_Packages "wikilink"), create
|
|
|
others](doc/Tutorials#CMake_Packages "wikilink"), create
|
|
|
FooConfig.cmake files, and exporting and importing targets.
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [How to find and use existing frameworks on OS
|
|
|
X](CMake%3AHowToUseExistingOSXFrameworks "wikilink")
|
|
|
X](doc/cmake/platform_dependent_issues/HowToUseExistingOSXFrameworks "wikilink")
|
|
|
A quick example to help OS X users find frameworks automatically.
|
|
|
|
|
|
### How to use CMake with specific Libraries
|
|
|
|
|
|
- [How to build Qt4 software with
|
|
|
CMake](CMake%3AHow_To_Build_Qt4_Software "wikilink")
|
|
|
CMake](doc/tutorials/How-To-Build-Qt4-Software "wikilink")
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
... | ... | @@ -161,12 +161,12 @@ and CTest. |
|
|
<!-- end list -->
|
|
|
|
|
|
- [How to build KDE4 software with
|
|
|
CMake](CMake%3AHow_To_Build_KDE4_Software "wikilink")
|
|
|
CMake](doc/tutorials/How-To-Build-KDE4-Software "wikilink")
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [How to use CMake to create Matlab MEX
|
|
|
files](CMake/MatlabMex "wikilink")
|
|
|
files](doc/tutorials/MatlabMex "wikilink")
|
|
|
Describes how to use CMake when developing Matlab Executable (MEX)
|
|
|
files for use with The Mathworks Matlab scripting language.
|
|
|
|
... | ... | @@ -191,57 +191,57 @@ and CTest. |
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [Using CMake to build an FLTK application](CMakeForFLTK "wikilink")
|
|
|
- [Using CMake to build an FLTK application](doc/tutorials/ForFLTK "wikilink")
|
|
|
|
|
|
### Recipes
|
|
|
|
|
|
- [How to process lots of input files with a processor built by
|
|
|
CMake](CMake%3AHow_To_Process_Lots_Of_Input_Files "wikilink")
|
|
|
CMake](doc/tutorials/How-To-Process-Lots-Of-Input-Files "wikilink")
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [Configuration Specific Settings for Visual Studio Generated Project
|
|
|
Files](VSConfigSpecificSettings "wikilink")
|
|
|
Files](doc/cmake/recipe/VSConfigSpecificSettings "wikilink")
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [How to use the 'BundleUtilities' to deploy your OS X Application.
|
|
|
Example uses Qt 4.](BundleUtilitiesExample "wikilink")
|
|
|
Example uses Qt 4.](doc/cpack/BundleUtilities "wikilink")
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [How to write a simple CMakeLists.txt for Fortran
|
|
|
code](CMakeForFortranExample "wikilink")
|
|
|
code](doc/cmake/languages/fortran/ForFortranExample "wikilink")
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [How to emulate GNU Autotools 'make
|
|
|
check'](CMakeEmulateMakeCheck "wikilink")
|
|
|
check'](doc/tutorials/EmulateMakeCheck "wikilink")
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [A toy model for add_custom_command and
|
|
|
add_custom_target](CustomCommandCustomTargetInstall "wikilink")
|
|
|
add_custom_target](doc/tutorials/CustomCommandCustomTargetInstall "wikilink")
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [Working with OS X Interface Builder
|
|
|
Files](CMake%3AOSX_InterfaceBuilderFiles "wikilink")
|
|
|
Files](doc/tutorials/OSX-InterfaceBuilderFiles "wikilink")
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [Append the Version Number to the Install
|
|
|
path](RecipeAppendVersionNumberToInstallpath "wikilink")
|
|
|
path](doc/cmake/recipe/AppendVersionNumberToInstallpath "wikilink")
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [Install to a local folder in the build dir for
|
|
|
testing](RecipeInstallToALocalFolderForTesting "wikilink")
|
|
|
testing](doc/cmake/recipe/InstallToALocalFolderForTesting "wikilink")
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [Adding an uninstall target to your
|
|
|
project](RecipeAddUninstallTarget "wikilink")
|
|
|
project](doc/cmake/recipe/AddUninstallTarget "wikilink")
|
|
|
|
|
|
## Converters from other buildsystems to CMake
|
|
|
|
... | ... | @@ -266,11 +266,11 @@ developer. |
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [Converting autoconf tests](GccXmlAutoConfHints "wikilink")
|
|
|
- [Converting autoconf tests](doc/cmake/GccXmlAutoConfHints "wikilink")
|
|
|
|
|
|
#### qmake
|
|
|
|
|
|
- [qmake converter (requires Ruby)](CMake%3AConvertFromQmake "wikilink")
|
|
|
- [qmake converter (requires Ruby)](contrib/scripts/ConvertFromQmake "wikilink")
|
|
|
Converts projects that use Qt's qmake.
|
|
|
|
|
|
#### Visual Studio
|
... | ... | @@ -313,73 +313,73 @@ developer. |
|
|
|
|
|
## Success Stories
|
|
|
|
|
|
- What are some [projects using CMake](CMake/Projects "wikilink")?
|
|
|
- [Articles about CMake](CMake%3AArticles "wikilink")
|
|
|
- [Really Cool CMake Features](Really_Cool_CMake_Features "wikilink")
|
|
|
- What are some [projects using CMake](doc/cmake/Projects "wikilink")?
|
|
|
- [Articles about CMake](doc/cmake/Articles "wikilink")
|
|
|
- [Really Cool CMake Features](doc/cmake/Really-Cool-CMake-Features "wikilink")
|
|
|
|
|
|
## More Topics
|
|
|
|
|
|
- [Fortran Issues](CMake_Fortran_Issues "wikilink")
|
|
|
- [Fortran Issues](doc/cmake/languages/fortran/Fortran-Issues "wikilink")
|
|
|
- [Generating dependency graphs with
|
|
|
CMake](CMake%3AFor_CMake_Hackers "wikilink")
|
|
|
- [Experiments With Lua](CMake%3AExperiments_With_Lua "wikilink")
|
|
|
- [Performance Tips](CMake_Performance_Tips "wikilink")
|
|
|
CMake](doc/cmake/Graphviz "wikilink")
|
|
|
- [Experiments With Lua](doc/cmake/dev/Experiments-With-Lua "wikilink")
|
|
|
- [Performance Tips](doc/cmake/Performance-Tips "wikilink")
|
|
|
- [GNU style directory layout with
|
|
|
CMake](CMake%3AGNU_style_example "wikilink")
|
|
|
- [CMake TODO](CMake%3AOpenTasks "wikilink")
|
|
|
- [Creating Qt Assistant Docs](CMake%3ACreateQtAssistantDocs "wikilink")
|
|
|
CMake](doc/tutorials/GNU-style-example "wikilink")
|
|
|
- [CMake TODO](doc/cmake/dev/OpenTasks "wikilink")
|
|
|
- [Creating Qt Assistant Docs](contrib/scripts/CreateQtAssistantDocs "wikilink")
|
|
|
- [Writing FindXXX.cmake modules that work with static
|
|
|
libraries](CMake%3AStatic_libraries "wikilink")
|
|
|
libraries](doc/cmake/Static-libraries "wikilink")
|
|
|
- [Writing FindXXX.cmake modules that work when multiple versions of
|
|
|
packages are
|
|
|
installed](CMake%3AMultiple_versions "wikilink")
|
|
|
- [CMake:Improving_Find\*_Modules](CMake%3AImproving_Find*_Modules "wikilink")
|
|
|
- [CMake/C_Plugins_for_Loadable_Commands](CMake/C_Plugins_for_Loadable_Commands "wikilink")
|
|
|
installed](doc/cmake/Multiple-versions "wikilink")
|
|
|
- [CMake:Improving_Find\*_Modules](doc/cmake/dev/Improving-Find*-Modules "wikilink")
|
|
|
- [CMake/C_Plugins_for_Loadable_Commands](doc/cmake/C-Plugins-for-Loadable-Commands "wikilink")
|
|
|
For anyone who wonders what the `load_command` command is for.
|
|
|
- [PC-Lint](PC-Lint "wikilink") support for CMake
|
|
|
- [PC-Lint](contrib/macros/PC-Lint "wikilink") support for CMake
|
|
|
|
|
|
# CTest
|
|
|
|
|
|
### Tutorials
|
|
|
|
|
|
- [Testing With CTest](CMake/Testing_With_CTest "wikilink")
|
|
|
- [Testing With CTest](doc/ctest/Testing-With-CTest "wikilink")
|
|
|
Introduces to testing with CTest, submitting dashboards, and using
|
|
|
CMake to add tests to the test system.
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [CTest Scripting](CMake_Scripting_Of_CTest "wikilink")
|
|
|
- [CTest Scripting](doc/ctest/Scripting-Of-CTest "wikilink")
|
|
|
Describes the scripting with CTest which can significantly simplify
|
|
|
and automate testing and submitting dashboards.
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [Generating Input Files For
|
|
|
CTest](CMake_Generating_Testing_Files "wikilink")
|
|
|
CTest](doc/ctest/Generating-Testing-Files "wikilink")
|
|
|
Describe more in details the concepts behind testing with CTest and
|
|
|
also explans how to use CTest without using CMake.
|
|
|
|
|
|
<!-- end list -->
|
|
|
|
|
|
- [Buildmanagement With CTest](CTest%3ABuildserver "wikilink")
|
|
|
- [Buildmanagement With CTest](doc/ctest/Buildserver "wikilink")
|
|
|
Describes how to setup a central configuration for all CTest
|
|
|
scripts.
|
|
|
|
|
|
### More Information
|
|
|
|
|
|
- [Configuring CTest Submission
|
|
|
Methods](CTest%3ASubmission_Issues "wikilink")
|
|
|
Methods](doc/ctest/Submission-Issues "wikilink")
|
|
|
- [CTest Nightly, Experimental, Continuous,
|
|
|
...](CTest%3ANightly,_Experimental,_Continuous "wikilink")
|
|
|
- [CTest/Coverage](CTest/Coverage "wikilink")
|
|
|
...](doc/ctest/Nightly,-Experimental,-Continuous "wikilink")
|
|
|
- [CTest/Coverage](doc/ctest/Coverage "wikilink")
|
|
|
- [CTest\_Running\_Modes.pdf](/uploads/b60e91d1b1723f590e6541392fbaf472/CTest_Running_Modes.pdf)
|
|
|
- [CTest Frequently asked questions](CTest%3AFAQ "wikilink")
|
|
|
- [CTest Frequently asked questions](doc/ctest/FAQ "wikilink")
|
|
|
|
|
|
### More Topics
|
|
|
|
|
|
- [CTest TODO](CTest%3AOpenTasks "wikilink")
|
|
|
- [CTest TODO](doc/ctest/OpenTasks "wikilink")
|
|
|
- [Run tests on machines without building
|
|
|
first](CTest%3ATestWithoutBuild "wikilink")
|
|
|
first](doc/ctest/TestWithoutBuild "wikilink")
|
|
|
|
|
|
# CDash
|
|
|
|
... | ... | @@ -390,27 +390,27 @@ developer. |
|
|
|
|
|
### Tutorials
|
|
|
|
|
|
- [Packaging with CPack](CMake%3APackaging_With_CPack "wikilink")
|
|
|
- [Packaging with CPack](doc/cpack/Packaging-With-CPack "wikilink")
|
|
|
Introduction to CPack, installing and packaging of software.
|
|
|
- [CMake tutorial](https://github.com/TheErk/CMake-tutorial) - Slides
|
|
|
from a CMake tutorial (including LaTeX beamer source) including
|
|
|
CPack.
|
|
|
- [CPack Variables](CMake%3ACPackConfiguration "wikilink")
|
|
|
- [Supported package formats](CMake%3ACPackPackageGenerators "wikilink")
|
|
|
- [CPack Variables](doc/cpack/Configuration "wikilink")
|
|
|
- [Supported package formats](doc/cpack/PackageGenerators "wikilink")
|
|
|
- [CPack Win32 Newbie
|
|
|
Checklist](CMake%3ACPackWin32NewbiesChecklist "wikilink")
|
|
|
Checklist](doc/cpack/Win32NewbiesChecklist "wikilink")
|
|
|
- [Component Install With
|
|
|
CPack](CMake%3AComponent_Install_With_CPack "wikilink")
|
|
|
CPack](doc/cpack/Component-Install-With-CPack "wikilink")
|
|
|
|
|
|
### Recipes
|
|
|
|
|
|
- [Add an application shortcut to the Start
|
|
|
Menu](RecipeAddShortcutToStartMenu "wikilink")
|
|
|
Menu](doc/cmake/recipe/AddShortcutToStartMenu "wikilink")
|
|
|
|
|
|
# Old(deprecated) kept for reference only
|
|
|
|
|
|
- [CMake 2.6 Notes](CMake_2.6_Notes "wikilink")
|
|
|
- [Useful CMake Variables](CMake_Useful_Variables "wikilink")
|
|
|
- [CMake 2.6 Notes](doc/cmake/notes/2.6 "wikilink")
|
|
|
- [Useful CMake Variables](doc/cmake/Useful-Variables "wikilink")
|
|
|
|
|
|
----
|
|
|
This page was initially populated by conversion from its [original location](https://public.kitware.com/Wiki/CMake) in another wiki. |