diff options
| author | David Cole <david.cole@kitware.com> | 2012-10-31 20:35:31 (GMT) |
|---|---|---|
| committer | CMake Topic Stage <kwrobot@kitware.com> | 2012-10-31 20:35:31 (GMT) |
| commit | 99c95d5e1a29c33c3e138e6299554b6b7fef6b44 (patch) | |
| tree | f0248b8225db6b0e393e0adeef32848b76bf8c17 | |
| parent | 4129397b8e6778426d1ffe4193cbf1c5fe4f499b (diff) | |
| parent | 854369fd45c2fe397637ff5daf687562d45d3896 (diff) | |
| download | CMake-99c95d5e1a29c33c3e138e6299554b6b7fef6b44.zip CMake-99c95d5e1a29c33c3e138e6299554b6b7fef6b44.tar.gz CMake-99c95d5e1a29c33c3e138e6299554b6b7fef6b44.tar.bz2 | |
Merge topic 'doc-external-language-policy'
854369f Document external language support policy
| -rw-r--r-- | Modules/CMakeAddNewLanguage.txt | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/Modules/CMakeAddNewLanguage.txt b/Modules/CMakeAddNewLanguage.txt index 6a30dd8..612e1a3 100644 --- a/Modules/CMakeAddNewLanguage.txt +++ b/Modules/CMakeAddNewLanguage.txt @@ -1,3 +1,19 @@ +This file provides a few notes to CMake developers about how to add +support for a new language to CMake. It is also possible to place +these files in CMAKE_MODULE_PATH within an outside project to add +languages not supported by upstream CMake. However, this is not +a fully supported use case. + +The implementation behind the scenes of project/enable_language, +including the compiler/platform modules, is an *internal* API that +does not make any compatibility guarantees. It is not covered in the +official reference documentation that is versioned with the source code. +Maintainers of external language support are responsible for porting +it to each version of CMake as upstream changes are made. Since +the API is internal we will not necessarily include notice of any +changes in release notes. + + CMakeDetermine(LANG)Compiler.cmake -> this should find the compiler for LANG and configure CMake(LANG)Compiler.cmake.in CMake(LANG)Compiler.cmake.in -> used by CMakeDetermine(LANG)Compiler.cmake |