CPack: Replace #<type> markup with reStructuredText equivalent

Drop #end and #module.  Convert #section to a subsection header.
Convert #variable to the cmake domain "variable" directive.
Convert #macro to the cmake domain "command" directive.
Perform minor formatting fixes in text near these changes.

1 files changed, 35 insertions, 66 deletions

diff --git a/Modules/CPackDMG.cmake b/Modules/CPackDMG.cmake
index 2f5eea4ebc..b7a6ba5399 100644
--- a/Modules/CPackDMG.cmake
+++ b/Modules/CPackDMG.cmake
@@ -4,87 +4,56 @@
 #
 # DragNDrop CPack generator (Mac OS X).
 #
-# #section Variables specific to CPack DragNDrop generator #end #module
-# The following variables are specific to the DragNDrop installers built
-# on Mac OS X: #end
-#
-# #variable
-#
-# ::
-#
-#   CPACK_DMG_VOLUME_NAME - The volume name of the generated disk
-#   image. Defaults to CPACK_PACKAGE_FILE_NAME.
-#
-# #end
-#
-# #variable
-#
-# ::
-#
-#   CPACK_DMG_FORMAT - The disk image format. Common values are UDRO
-#   (UDIF read-only), UDZO (UDIF zlib-compressed) or UDBZ (UDIF
-#   bzip2-compressed). Refer to hdiutil(1) for more information on
-#   other available formats.
+# Variables specific to CPack DragNDrop generator
+# ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 #
-# #end
-#
-# #variable
-#
-# ::
-#
-#   CPACK_DMG_DS_STORE - Path to a custom DS_Store file. This .DS_Store
-#   file e.g. can be used to specify the Finder window
-#   position/geometry and layout (such as hidden toolbars, placement of the
-#   icons etc.). This file has to be generated by the Finder (either manually or
-#   through OSA-script) using a normal folder from which the .DS_Store
-#   file can then be extracted.
-#
-# #end
-#
-# #variable
-#
-# ::
+# The following variables are specific to the DragNDrop installers built
+# on Mac OS X:
 #
-#   CPACK_DMG_BACKGROUND_IMAGE - Path to a background image file. This
-#   file will be used as the background for the Finder Window when the disk
-#   image is opened.  By default no background image is set. The background
-#   image is applied after applying the custom .DS_Store file.
+# .. variable:: CPACK_DMG_VOLUME_NAME
 #
-# #end
+#  The volume name of the generated disk image. Defaults to
+#  CPACK_PACKAGE_FILE_NAME.
 #
-# #variable
+# .. variable:: CPACK_DMG_FORMAT
 #
-# ::
+#  The disk image format. Common values are UDRO (UDIF read-only), UDZO (UDIF
+#  zlib-compressed) or UDBZ (UDIF bzip2-compressed). Refer to hdiutil(1) for
+#  more information on other available formats.
 #
-#   CPACK_COMMAND_HDIUTIL - Path to the hdiutil(1) command used to
-#   operate on disk image files on Mac OS X. This variable can be used
-#   to override the automatically detected command (or specify its
-#   location if the auto-detection fails to find it.)
+# .. variable:: CPACK_DMG_DS_STORE
 #
-# #end
+#  Path to a custom DS_Store file. This .DS_Store file e.g. can be used to
+#  specify the Finder window position/geometry and layout (such as hidden
+#  toolbars, placement of the icons etc.). This file has to be generated by
+#  the Finder (either manually or through OSA-script) using a normal folder
+#  from which the .DS_Store file can then be extracted.
 #
-# #variable
+# .. variable:: CPACK_DMG_BACKGROUND_IMAGE
 #
-# ::
+#  Path to a background image file. This file will be used as the background
+#  for the Finder Window when the disk image is opened.  By default no
+#  background image is set. The background image is applied after applying the
+#  custom .DS_Store file.
 #
-#   CPACK_COMMAND_SETFILE - Path to the SetFile(1) command used to set
-#   extended attributes on files and directories on Mac OS X. This
-#   variable can be used to override the automatically detected
-#   command (or specify its location if the auto-detection fails to
-#   find it.)
+# .. variable:: CPACK_COMMAND_HDIUTIL
 #
-# #end
+#  Path to the hdiutil(1) command used to operate on disk image files on Mac
+#  OS X. This variable can be used to override the automatically detected
+#  command (or specify its location if the auto-detection fails to find it.)
 #
-# #variable
+# .. variable:: CPACK_COMMAND_SETFILE
 #
-# ::
+#  Path to the SetFile(1) command used to set extended attributes on files and
+#  directories on Mac OS X. This variable can be used to override the
+#  automatically detected command (or specify its location if the
+#  auto-detection fails to find it.)
 #
-#   CPACK_COMMAND_REZ - Path to the Rez(1) command used to compile
-#   resources on Mac OS X. This variable can be used to override the
-#   automatically detected command (or specify its location if the
-#   auto-detection fails to find it.)
+# .. variable:: CPACK_COMMAND_REZ
 #
-# #end
+#  Path to the Rez(1) command used to compile resources on Mac OS X. This
+#  variable can be used to override the automatically detected command (or
+#  specify its location if the auto-detection fails to find it.)
 
 #=============================================================================
 # Copyright 2006-2012 Kitware, Inc.