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, 214 insertions, 129 deletions

diff --git a/Modules/CPackNSIS.cmake b/Modules/CPackNSIS.cmake
index d140053..717bf92 100644
--- a/Modules/CPackNSIS.cmake
+++ b/Modules/CPackNSIS.cmake
@@ -1,134 +1,219 @@
-##section Variables specific to CPack NSIS generator
-##end
-##module
-# - CPack NSIS generator specific options
+#.rst:
+# CPackNSIS
+# ---------
+#
+# CPack NSIS generator specific options
+#
+# #section Variables specific to CPack NSIS generator #end #module
 #
 # The following variables are specific to the graphical installers built
-# on Windows using the Nullsoft Installation System.
-##end
-#
-##variable
-#   CPACK_NSIS_INSTALL_ROOT - The default installation directory presented
-#   to the end user by the NSIS installer is under this root dir. The full
-#   directory presented to the end user is:
-#   ${CPACK_NSIS_INSTALL_ROOT}/${CPACK_PACKAGE_INSTALL_DIRECTORY}
-##end
-#
-##variable
-#   CPACK_NSIS_MUI_ICON - An icon filename.
-#   The name of a *.ico file used as the main icon for the generated
-#   install program.
-##end
-#
-##variable
-#   CPACK_NSIS_MUI_UNIICON - An icon filename.
-#   The name of a *.ico file used as the main icon for the generated
-#   uninstall program.
-##end
-#
-##variable
-#   CPACK_NSIS_INSTALLER_MUI_ICON_CODE - undocumented.
-##end
-#
-##variable
-#   CPACK_NSIS_EXTRA_PREINSTALL_COMMANDS - Extra NSIS commands that
-#   will be added to the beginning of the install Section, before your
-#   install tree is available on the target system.
-##end
-#
-##variable
-#   CPACK_NSIS_EXTRA_INSTALL_COMMANDS - Extra NSIS commands that
-#   will be added to the end of the install Section, after your
-#   install tree is available on the target system.
-##end
-#
-##variable
-#   CPACK_NSIS_EXTRA_UNINSTALL_COMMANDS - Extra NSIS commands that will
-#   be added to the uninstall Section, before your install tree is
-#   removed from the target system.
-##end
-#
-##variable
-#   CPACK_NSIS_COMPRESSOR - The arguments that will be passed to the
-#   NSIS SetCompressor command.
-##end
-#
-##variable
-#   CPACK_NSIS_ENABLE_UNINSTALL_BEFORE_INSTALL - Ask about uninstalling
-#   previous versions first.
-#   If this is set to "ON", then an installer will look for previous
-#   installed versions and if one is found, ask the user whether to
-#   uninstall it before proceeding with the install.
-##end
-#
-##variable
-#   CPACK_NSIS_MODIFY_PATH - Modify PATH toggle.
-#   If this is set to "ON", then an extra page
-#   will appear in the installer that will allow the user to choose
-#   whether the program directory should be added to the system PATH
-#   variable.
-##end
-#
-##variable
-#   CPACK_NSIS_DISPLAY_NAME - The display name string that appears in
-#   the Windows Add/Remove Program control panel
-##end
-#
-##variable
-#   CPACK_NSIS_PACKAGE_NAME - The title displayed at the top of the
-#   installer.
-##end
-#
-##variable
-#   CPACK_NSIS_INSTALLED_ICON_NAME - A path to the executable that
-#   contains the installer icon.
-##end
-#
-##variable
-#   CPACK_NSIS_HELP_LINK - URL to a web site providing assistance in
-#   installing your application.
-##end
-#
-##variable
-#   CPACK_NSIS_URL_INFO_ABOUT - URL to a web site providing more
-#   information about your application.
-##end
-#
-##variable
-#   CPACK_NSIS_CONTACT - Contact information for questions and comments
-#   about the installation process.
-##end
-#
-##variable
-#   CPACK_NSIS_CREATE_ICONS_EXTRA - Additional NSIS commands for
-#   creating start menu shortcuts.
-##end
-#
-##variable
-#   CPACK_NSIS_DELETE_ICONS_EXTRA -Additional NSIS commands to
-#   uninstall start menu shortcuts.
-##end
-#
-##variable
-#   CPACK_NSIS_EXECUTABLES_DIRECTORY - Creating NSIS start menu links
-#   assumes that they are in 'bin' unless this variable is set.
-#   For example, you would set this to 'exec' if your executables are
-#   in an exec directory.
-##end
-#
-##variable
-#   CPACK_NSIS_MUI_FINISHPAGE_RUN - Specify an executable to add an option
-#   to run on the finish page of the NSIS installer.
-##end
-##variable
-#   CPACK_NSIS_MENU_LINKS - Specify links in [application] menu.
-#   This should contain a list of pair "link" "link name". The link
-#   may be an URL or a path relative to installation prefix.
-#   Like:
-#     set(CPACK_NSIS_MENU_LINKS
-#         "doc/cmake-@CMake_VERSION_MAJOR@.@CMake_VERSION_MINOR@/cmake.html" "CMake Help"
-#         "http://www.cmake.org" "CMake Web Site")
-##end
+# on Windows using the Nullsoft Installation System.  #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_INSTALL_ROOT - The default installation directory presented
+#    to the end user by the NSIS installer is under this root dir. The full
+#    directory presented to the end user is:
+#    ${CPACK_NSIS_INSTALL_ROOT}/${CPACK_PACKAGE_INSTALL_DIRECTORY}
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_MUI_ICON - An icon filename.
+#    The name of a *.ico file used as the main icon for the generated
+#    install program.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_MUI_UNIICON - An icon filename.
+#    The name of a *.ico file used as the main icon for the generated
+#    uninstall program.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_INSTALLER_MUI_ICON_CODE - undocumented.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_EXTRA_PREINSTALL_COMMANDS - Extra NSIS commands that
+#    will be added to the beginning of the install Section, before your
+#    install tree is available on the target system.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_EXTRA_INSTALL_COMMANDS - Extra NSIS commands that
+#    will be added to the end of the install Section, after your
+#    install tree is available on the target system.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_EXTRA_UNINSTALL_COMMANDS - Extra NSIS commands that will
+#    be added to the uninstall Section, before your install tree is
+#    removed from the target system.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_COMPRESSOR - The arguments that will be passed to the
+#    NSIS SetCompressor command.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_ENABLE_UNINSTALL_BEFORE_INSTALL - Ask about uninstalling
+#    previous versions first.
+#    If this is set to "ON", then an installer will look for previous
+#    installed versions and if one is found, ask the user whether to
+#    uninstall it before proceeding with the install.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_MODIFY_PATH - Modify PATH toggle.
+#    If this is set to "ON", then an extra page
+#    will appear in the installer that will allow the user to choose
+#    whether the program directory should be added to the system PATH
+#    variable.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_DISPLAY_NAME - The display name string that appears in
+#    the Windows Add/Remove Program control panel
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_PACKAGE_NAME - The title displayed at the top of the
+#    installer.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_INSTALLED_ICON_NAME - A path to the executable that
+#    contains the installer icon.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_HELP_LINK - URL to a web site providing assistance in
+#    installing your application.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_URL_INFO_ABOUT - URL to a web site providing more
+#    information about your application.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_CONTACT - Contact information for questions and comments
+#    about the installation process.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_CREATE_ICONS_EXTRA - Additional NSIS commands for
+#    creating start menu shortcuts.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_DELETE_ICONS_EXTRA -Additional NSIS commands to
+#    uninstall start menu shortcuts.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_EXECUTABLES_DIRECTORY - Creating NSIS start menu links
+#    assumes that they are in 'bin' unless this variable is set.
+#    For example, you would set this to 'exec' if your executables are
+#    in an exec directory.
+#
+# #end
+#
+# #variable
+#
+# ::
+#
+#    CPACK_NSIS_MUI_FINISHPAGE_RUN - Specify an executable to add an option
+#    to run on the finish page of the NSIS installer.
+#
+# #end #variable
+#
+# ::
+#
+#    CPACK_NSIS_MENU_LINKS - Specify links in [application] menu.
+#    This should contain a list of pair "link" "link name". The link
+#    may be an URL or a path relative to installation prefix.
+#    Like:
+#      set(CPACK_NSIS_MENU_LINKS
+#          "doc/cmake-@CMake_VERSION_MAJOR@.@CMake_VERSION_MINOR@/cmake.html" "CMake Help"
+#          "http://www.cmake.org" "CMake Web Site")
+#
+# #end
 
 #=============================================================================
 # Copyright 2006-2009 Kitware, Inc.