Modules: Format documentation to avoid over-long preformatted lines

Convert several preformatted code block literals that enumerate lists of
options or variables to use reST definition lists instead.  Manually
wrap other long lines in code blocks.

1 files changed, 13 insertions, 10 deletions

diff --git a/Modules/FindPNG.cmake b/Modules/FindPNG.cmake
index fa04bf0b4a..7cf3f22931 100644
--- a/Modules/FindPNG.cmake
+++ b/Modules/FindPNG.cmake
@@ -10,19 +10,22 @@
 #
 # It defines the following variables
 #
-# ::
-#
-#   PNG_INCLUDE_DIRS, where to find png.h, etc.
-#   PNG_LIBRARIES, the libraries to link against to use PNG.
-#   PNG_DEFINITIONS - You should add_definitons(${PNG_DEFINITIONS}) before compiling code that includes png library files.
-#   PNG_FOUND, If false, do not try to use PNG.
-#   PNG_VERSION_STRING - the version of the PNG library found (since CMake 2.8.8)
+# ``PNG_INCLUDE_DIRS``
+#   where to find png.h, etc.
+# ``PNG_LIBRARIES``
+#   the libraries to link against to use PNG.
+# ``PNG_DEFINITIONS``
+#   You should add_definitons(${PNG_DEFINITIONS}) before compiling code
+#   that includes png library files.
+# ``PNG_FOUND``
+#   If false, do not try to use PNG.
+# ``PNG_VERSION_STRING``
+#   the version of the PNG library found (since CMake 2.8.8)
 #
 # Also defined, but not for general use are
 #
-# ::
-#
-#   PNG_LIBRARY, where to find the PNG library.
+# ``PNG_LIBRARY``
+#   where to find the PNG library.
 #
 # For backward compatiblity the variable PNG_INCLUDE_DIR is also set.
 # It has the same value as PNG_INCLUDE_DIRS.