Convert builtin help to reStructuredText source files

Run the convert-help.bash script to convert documentation:

 ./convert-help.bash "/path/to/CMake-build/bin"

Then remove it.

1 files changed, 21 insertions, 0 deletions

diff --git a/Help/policy/CMP0025.rst b/Help/policy/CMP0025.rst
new file mode 100644
index 0000000..25957e9
--- /dev/null
+++ b/Help/policy/CMP0025.rst
@@ -0,0 +1,21 @@
+CMP0025
+-------
+
+Compiler id for Apple Clang is now AppleClang.
+
+CMake >= 2.8.13 recognize that Apple Clang is a different compiler
+than upstream Clang and that they have different version numbers.
+CMake now prefers to present this to projects by setting
+CMAKE_<LANG>_COMPILER_ID to "AppleClang" instead of "Clang".  However,
+existing projects may assume the compiler id for Apple Clang is just
+"Clang" as it was in CMake < 2.8.13.  Therefore this policy determines
+for Apple Clang which compiler id to report in
+CMAKE_<LANG>_COMPILER_ID after <LANG> is enabled by the project() or
+enable_language() command.
+
+The OLD behavior for this policy is to use compiler id "Clang".  The
+NEW behavior for this policy is to use compiler id "AppleClang".
+
+This policy was introduced in CMake version 2.8.13.  CMake version
+|release| warns when the policy is not set and uses OLD behavior.  Use
+the cmake_policy command to set it to OLD or NEW explicitly.