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, 25 insertions, 0 deletions

diff --git a/Help/policy/CMP0026.rst b/Help/policy/CMP0026.rst
new file mode 100644
index 0000000..585da56
--- /dev/null
+++ b/Help/policy/CMP0026.rst
@@ -0,0 +1,25 @@
+CMP0026
+-------
+
+Disallow use of the LOCATION target property.
+
+CMake 2.8.12 and lower allowed reading the LOCATION target property to
+determine the eventual location of build targets.  This relies on the
+assumption that all necessary information is available at
+configure-time to determine the final location and filename of the
+target.  However, this property is not fully determined until later at
+generate-time.  At generate time, the $<TARGET_FILE> generator
+expression can be used to determine the eventual LOCATION of a target
+output.
+
+Code which reads the LOCATION target property can be ported to use the
+$<TARGET_FILE> generator expression together with the file(GENERATE)
+subcommand to generate a file containing the target location.
+
+The OLD behavior for this policy is to allow reading the LOCATION
+property from build-targets.  The NEW behavior for this policy is to
+not to allow reading the LOCATION property from build-targets.
+
+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.