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

diff --git a/Help/command/add_custom_target.rst b/Help/command/add_custom_target.rst
new file mode 100644
index 0000000..1bf70bf
--- /dev/null
+++ b/Help/command/add_custom_target.rst
@@ -0,0 +1,45 @@
+add_custom_target
+-----------------
+
+Add a target with no output so it will always be built.
+
+::
+
+  add_custom_target(Name [ALL] [command1 [args1...]]
+                    [COMMAND command2 [args2...] ...]
+                    [DEPENDS depend depend depend ... ]
+                    [WORKING_DIRECTORY dir]
+                    [COMMENT comment] [VERBATIM]
+                    [SOURCES src1 [src2...]])
+
+Adds a target with the given name that executes the given commands.
+The target has no output file and is ALWAYS CONSIDERED OUT OF DATE
+even if the commands try to create a file with the name of the target.
+Use ADD_CUSTOM_COMMAND to generate a file with dependencies.  By
+default nothing depends on the custom target.  Use ADD_DEPENDENCIES to
+add dependencies to or from other targets.  If the ALL option is
+specified it indicates that this target should be added to the default
+build target so that it will be run every time (the command cannot be
+called ALL).  The command and arguments are optional and if not
+specified an empty target will be created.  If WORKING_DIRECTORY is
+set, then the command will be run in that directory.  If it is a
+relative path it will be interpreted relative to the build tree
+directory corresponding to the current source directory.  If COMMENT
+is set, the value will be displayed as a message before the commands
+are executed at build time.  Dependencies listed with the DEPENDS
+argument may reference files and outputs of custom commands created
+with add_custom_command() in the same directory (CMakeLists.txt file).
+
+If VERBATIM is given then all arguments to the commands will be
+escaped properly for the build tool so that the invoked command
+receives each argument unchanged.  Note that one level of escapes is
+still used by the CMake language processor before add_custom_target
+even sees the arguments.  Use of VERBATIM is recommended as it enables
+correct behavior.  When VERBATIM is not given the behavior is platform
+specific because there is no protection of tool-specific special
+characters.
+
+The SOURCES option specifies additional source files to be included in
+the custom target.  Specified source files will be added to IDE
+project files for convenience in editing even if they have not build
+rules.