ENH: add documentation support for modules

Modules/CMake.cmake

+
 # This file is used by cmake.cxx to compute the CMAKE_ROOT location.
 # Do not remove this file from cvs without updating cmake.cxx to look
 # for a different file.

Modules/CMakeBackwardCompatibilityC.cmake

+
 # Nothing here yet
 IF(CMAKE_GENERATOR MATCHES "Visual Studio 7")
   INCLUDE(CMakeVS7BackwardCompatibility)

Modules/CMakeBackwardCompatibilityCXX.cmake

-#
+# - define a bunch of backwards compatibility varibles
+#  CMAKE_ANSI_CXXFLAGS - flag for ansi c++ 
+#  CMAKE_HAS_ANSI_STRING_STREAM - has <strstream>
+#  INCLUDE(TestForANSIStreamHeaders)
+#  INCLUDE(CheckIncludeFileCXX)
+#  INCLUDE(TestForSTDNamespace)
+#  INCLUDE(TestForANSIForScope)
 IF(NOT CMAKE_SKIP_COMPATIBILITY_TESTS)
   # check for some ANSI flags in the CXX compiler if it is not gnu
   IF(NOT CMAKE_COMPILER_IS_GNUCXX)

Modules/CMakeCInformation.cmake

+
 # This file sets the basic flags for the C language in CMake.
 # It also loads the available platform file for the system-compiler
 # if it exists.

Modules/CMakeCXXInformation.cmake

+
 # This file sets the basic flags for the C++ language in CMake.
 # It also loads the available platform file for the system-compiler
 # if it exists.

Modules/CMakeCommonLanguageInclude.cmake

+
 # this file has flags that are shared across languages and sets
 # cache values that can be initialized in the platform-compiler.cmake file
 # it may be included by more than one language.

Modules/CMakeDetermineCCompiler.cmake

+
 # determine the compiler to use for C programs
 # NOTE, a generator may set CMAKE_C_COMPILER before
 # loading this file to force a compiler.

Modules/CMakeDetermineCXXCompiler.cmake

+
 # determine the compiler to use for C++ programs
 # NOTE, a generator may set CMAKE_CXX_COMPILER before
 # loading this file to force a compiler.

Modules/CMakeDetermineFortranCompiler.cmake

+
 # determine the compiler to use for C programs
 # NOTE, a generator may set CMAKE_C_COMPILER before
 # loading this file to force a compiler.

Modules/CMakeDetermineJavaCompiler.cmake

+
 # determine the compiler to use for Java programs
 # NOTE, a generator may set CMAKE_Java_COMPILER before
 # loading this file to force a compiler.

Modules/CMakeDetermineRCCompiler.cmake

+
 # determine the compiler to use for C programs
 # NOTE, a generator may set CMAKE_C_COMPILER before
 # loading this file to force a compiler.

Modules/CMakeDetermineSystem.cmake

+
 # This module is used by the Makefile generator to determin the following variables:
 # CMAKE_SYSTEM_NAME - on unix this is uname -s, for windows it is Windows
 # CMAKE_SYSTEM_VERSION - on unix this is uname -r, for windows it is empty

Modules/CMakeExportBuildSettings.cmake

-# Macro to export the build settings for use by another project.
-# Provide as an argument the file into which the settings are to be
-# stored.
+# - export build settings from a project.
+# CMAKE_EXPORT_BUILD_SETTINGS(SETTINGS_FILE) - macro defined to export the build 
+# settings for use by another project.
+#  SETTINGS_FILE - the file into which the settings are to be stored.
 MACRO(CMAKE_EXPORT_BUILD_SETTINGS SETTINGS_FILE)
   IF(${SETTINGS_FILE} MATCHES ".+")
     CONFIGURE_FILE(${CMAKE_ROOT}/Modules/CMakeBuildSettings.cmake.in

Modules/CMakeFindFrameworks.cmake

+# - helper module to find OSX frameworks
+
 IF(NOT CMAKE_FIND_FRAMEWORKS_INCLUDED)
   SET(CMAKE_FIND_FRAMEWORKS_INCLUDED 1)
   MACRO(CMAKE_FIND_FRAMEWORKS fwk)

Modules/CMakeFortranInformation.cmake

+
 # This file sets the basic flags for the Fortran language in CMake.
 # It also loads the available platform file for the system-compiler
 # if it exists.

Modules/CMakeImportBuildSettings.cmake

-# Macro to import the build settings from another project.  Provide as
-# an argument the file created by the other project's
-# CMAKE_EXPORT_BUILD_SETTINGS command.
+# - import build settings from another project
+# CMAKE_IMPORT_BUILD_SETTINGS(SETTINGS_FILE) - macro defined to import the 
+# build settings from another project.  
+#  SETTINGS_FILE - a file created by the other project's call to the
+#  CMAKE_EXPORT_BUILD_SETTINGS macro, see CMakeExportBuildSettings.
 MACRO(CMAKE_IMPORT_BUILD_SETTINGS SETTINGS_FILE)
   IF(${SETTINGS_FILE} MATCHES ".+")
     # Load the settings.

Modules/CMakeJavaInformation.cmake

+
 # this is a place holder if java needed flags for javac they would go here.
 IF(NOT CMAKE_Java_CREATE_STATIC_LIBRARY)
   SET(CMAKE_Java_CREATE_STATIC_LIBRARY

Modules/CMakePrintSystemInformation.cmake

-# this file can be used for diagnostic purposes
-# just include it in a project to see various internal cmake
-# variables
+# - print system information
+# This file can be used for diagnostic purposes
+# just include it in a project to see various internal CMake
+# variables.
 
 MESSAGE("CMAKE_SYSTEM is ${CMAKE_SYSTEM} ${CMAKE_SYSTEM_NAME} ${CMAKE_SYSTEM_VERSION}")
 MESSAGE("CMAKE_SYSTEM file is ${CMAKE_SYSTEM_INFO_FILE}")

Modules/CMakeRCInformation.cmake

+
 # This file sets the basic flags for the Fortran language in CMake.
 # It also loads the available platform file for the system-compiler
 # if it exists.

Modules/CMakeSystemSpecificInformation.cmake

+
 # This file is included by cmGlobalGenerator::EnableLanguage.
 # It is included after the compiler has been determined, so
 # we know things like the compiler name and if the compiler is gnu.

Modules/CMakeTestCCompiler.cmake

+
 # This file is used by EnableLanguage in cmGlobalGenerator to
 # determine that that selected C compiler can actually compile
 # and link the most basic of programs.   If not, a fatal error

Modules/CMakeTestCXXCompiler.cmake

+
 # This file is used by EnableLanguage in cmGlobalGenerator to
 # determine that that selected C++ compiler can actually compile
 # and link the most basic of programs.   If not, a fatal error

Modules/CMakeTestFortranCompiler.cmake

+
 # This file is used by EnableLanguage in cmGlobalGenerator to
 # determine that that selected Fortran compiler can actually compile
 # and link the most basic of programs.   If not, a fatal error

Modules/CMakeTestJavaCompiler.cmake

+
 # This file is used by EnableLanguage in cmGlobalGenerator to
 # determine that that selected Fortran compiler can actually compile
 # and link the most basic of programs.   If not, a fatal error

Modules/CMakeTestRCCompiler.cmake

+
 # This file is used by EnableLanguage in cmGlobalGenerator to
 # determine that that selected RC compiler can actually compile
 # and link the most basic of programs.   If not, a fatal error

Modules/CMakeVS6BackwardCompatibility.cmake

+
 # hard code these for fast backwards compatibility tests
 SET (CMAKE_SIZEOF_INT       4   CACHE INTERNAL "Size of int data type")
 SET (CMAKE_SIZEOF_LONG      4   CACHE INTERNAL "Size of long data type")

Modules/CMakeVS7BackwardCompatibility.cmake

+
 # hard code these for fast backwards compatibility tests
 SET (CMAKE_SIZEOF_INT       4   CACHE INTERNAL "Size of int data type")
 SET (CMAKE_SIZEOF_LONG      4   CACHE INTERNAL "Size of long data type")

Modules/CTest.cmake

-# CTest.cmake
-#
+# - setup CTest
 # This file configures a project to use the CTest/Dart testing/dashboard process.
 #
 OPTION(BUILD_TESTING "Build the testing tree." ON)

Modules/CheckCSourceCompiles.cmake

-#
-# Check if the source code provided in the SOURCE argument compiles.
-#
-# CHECK_C_SOURCE_COMPILES - macro which checks if the source code compiles\
-# SOURCE   - source code to try to compile
-# VARIABLE - variable to store size if the type exists.
-#
+# - Check if the source code provided in the SOURCE argument compiles.
+# CHECK_C_SOURCE_COMPILES(SOURCE VAR)
+# - macro which checks if the source code compiles
+#  SOURCE   - source code to try to compile
+#  VAR - variable to store size if the type exists.
 # Checks the following optional VARIABLES (not arguments)
-# CMAKE_REQUIRED_LIBRARIES - Link to extra libraries
-# CMAKE_REQUIRED_FLAGS - Extra flags to C compiler
+#  CMAKE_REQUIRED_LIBRARIES - Link to extra libraries
+#  CMAKE_REQUIRED_FLAGS - Extra flags to C compiler
 #
 
 MACRO(CHECK_C_SOURCE_COMPILES SOURCE VAR)

Modules/CheckCXXSourceCompiles.cmake

-#
-# Check if the source code provided in the SOURCE argument compiles.
-#
-# CHECK_CXX_SOURCE_COMPILES - macro which checks if the source code compiles\
-# SOURCE   - source code to try to compile
-# VARIABLE - variable to store size if the type exists.
-#
+# - Check if the source code provided in the SOURCE argument compiles.
+# CHECK_CXX_SOURCE_COMPILES(SOURCE VAR)
+# - macro which checks if the source code compiles\
+#  SOURCE   - source code to try to compile
+#  VAR - variable to store size if the type exists.
 # Checks the following optional VARIABLES (not arguments)
-# CMAKE_REQUIRED_LIBRARIES - Link to extra libraries
-# CMAKE_REQUIRED_FLAGS - Extra flags to C compiler
+#  CMAKE_REQUIRED_LIBRARIES - Link to extra libraries
+#  CMAKE_REQUIRED_FLAGS - Extra flags to C compiler
 #
 
 MACRO(CHECK_CXX_SOURCE_COMPILES SOURCE VAR)

Modules/CheckFunctionExists.cmake

-#
-# Check if the function exists.
-#
-# CHECK_FUNCTION_EXISTS - macro which checks if the function exists
-# FUNCTION - the name of the function
-# VARIABLE - variable to store the result
-# 
+# - Check if the function exists.
+# CHECK_FUNCTION_EXISTS(FUNCTION VARIABLE)
+# - macro which checks if the function exists
+#  FUNCTION - the name of the function
+#  VARIABLE - variable to store the result
 # If CMAKE_REQUIRED_FLAGS is set then those flags will be passed into the
 # compile of the program likewise if CMAKE_REQUIRED_LIBRARIES is set then
 # those libraries will be linked against the test program

Modules/CheckIncludeFile.cmake

-#
-# Check if the include file exists.
-#
-# CHECK_INCLUDE_FILE - macro which checks the include file exists.
-# INCLUDE - name of include file
-# VARIABLE - variable to return result
-#
+# - Check if the include file exists.
+# CHECK_INCLUDE_FILE(INCLUDE VARIABLE)
+# - macro which checks the include file exists.
+#  INCLUDE - name of include file
+#  VARIABLE - variable to return result
+#   
 # an optional third argument is the CFlags to add to the compile line 
 # or you can use CMAKE_REQUIRED_FLAGS
 #

Modules/CheckIncludeFileCXX.cmake

-#
-# Check if the include file exists.
-#
-# CHECK_INCLUDE_FILE - macro which checks the include file exists.
-# INCLUDE - name of include file
-# VARIABLE - variable to return result
-#
-# an optional third argument is the CFlags to add to the compile line 
-# or you can use CMAKE_REQUIRED_FLAGS
+# - Check if the include file exists.
+#  CHECK_INCLUDE_FILE_CXX(INCLUDE VARIABLE) - macro which checks the include file exists.
+#  INCLUDE - name of include file
+#  VARIABLE - variable to return result
+#  
+# An optional third argument is the CFlags to add to the compile line 
+# or you can use CMAKE_REQUIRED_FLAGS.
 #
 MACRO(CHECK_INCLUDE_FILE_CXX INCLUDE VARIABLE)
   IF("${VARIABLE}" MATCHES "^${VARIABLE}$")

Modules/CheckIncludeFiles.cmake

+# - Check if the files can be included
 #
-# Check if the files can be included
-#
-# CHECK_INCLUDE_FILES - macro which checks the include file exists.
-# INCLUDE - list of files to include
-# VARIABLE - variable to return result
-#
+# CHECK_INCLUDE_FILES(INCLUDE VARIABLE)
+# - macro which checks the include file exists.
+#  INCLUDE - list of files to include
+#  VARIABLE - variable to return result
+#   
 # If CMAKE_REQUIRED_FLAGS is set then those flags will be passed into the
 # compile of the program
 

Modules/CheckLibraryExists.cmake

-#
-# Check if the function exists.
-#
-# CHECK_LIBRARY_EXISTS - macro which checks if the function exists
-# LIBRARY - the name of the library you are looking for
-# FUNCTION - the name of the function
-# LOCATION - location where the library should be found
-# VARIABLE - variable to store the result
-#
+# - Check if the function exists.
+# CHECK_LIBRARY_EXISTS (LIBRARY FUNCTION LOCATION VARIABLE)
+# - macro which checks if the function exists
+#  LIBRARY - the name of the library you are looking for
+#  FUNCTION - the name of the function
+#  LOCATION - location where the library should be found
+#  VARIABLE - variable to store the result
+#  
 # If CMAKE_REQUIRED_FLAGS is set then those flags will be passed into the
 # compile of the program likewise if CMAKE_REQUIRED_LIBRARIES is set then
 # those libraries will be linked against the test program

Modules/CheckSymbolExists.cmake

-#
-# Check if the symbol exists in include files
-#
-# CHECK_SYMBOL_EXISTS - macro which checks the symbol exists in include files.
-# SYMBOL - symbol
-# FILES  - include files to check
-# VARIABLE - variable to return result
-#
+# - Check if the symbol exists in include files
+# CHECK_SYMBOL_EXISTS(SYMBOL FILES VARIABLE)
+# - macro which checks the symbol exists in include files.
+#  SYMBOL - symbol
+#  FILES  - include files to check
+#  VARIABLE - variable to return result
+#  
 # If CMAKE_REQUIRED_FLAGS is set then those flags will be passed into the
 # compile of the program likewise if CMAKE_REQUIRED_LIBRARIES is set then
 # those libraries will be linked against the test program

Modules/CheckTypeSize.cmake

-#
+# - Check sizeof a type
+# CHECK_TYPE_SIZE(TYPE VARIABLE)
 # Check if the type exists and determine size of type.  if the type
 # exists, the size will be stored to the variable.
 #
-# CHECK_TYPE_SIZE - macro which checks the size of type
-# VARIABLE - variable to store size if the type exists.
-# HAVE_${VARIABLE} - does the variable exists or not
-#
+#  VARIABLE - variable to store size if the type exists.
+#  HAVE_${VARIABLE} - does the variable exists or not
 
 MACRO(CHECK_TYPE_SIZE TYPE VARIABLE)
   SET(CMAKE_ALLOW_UNKNOWN_VARIABLE_READ_ACCESS 1)

Modules/CheckVariableExists.cmake

-#
-# Check if the variable exists.
-# # CHECK_VARIABLE_EXISTS - macro which checks if the variable exists
-# VAR - the name of the variable
-# VARIABLE - variable to store the result
-#
+# - Check if the variable exists.
+# CHECK_VARIABLE_EXISTS(VAR VARIABLE)
+# - macro which checks if the variable exists
+#  VAR - the name of the variable
+#  VARIABLE - variable to store the result
 # If CMAKE_REQUIRED_FLAGS is set then those flags will be passed into the
 # compile of the program likewise if CMAKE_REQUIRED_LIBRARIES is set then
-# those libraries will be linked against the test program
-#
-# only for C variables
+# those libraries will be linked against the test program.
+# This macro is only for C variables.
 #
 MACRO(CHECK_VARIABLE_EXISTS VAR VARIABLE)
   IF("${VARIABLE}" MATCHES "^${VARIABLE}$")

Modules/Dart.cmake

-# Dart.cmake
-#
+# - setup for using Dart.
 # This file configures a project to use the Dart testing/dashboard process.
 # It is broken into 3 sections.
+
 # 
-# Section #1: Locate programs on the client and determine site and build name
-# Section #2: Configure or copy Tcl scripts from the source tree to build tree
-# Section #3: Custom targets for performing dashboard builds.
+#  Section #1: Locate programs on the client and determine site and build name
+#  Section #2: Configure or copy Tcl scripts from the source tree to build tree
+#  Section #3: Custom targets for performing dashboard builds.
 #
 #
 OPTION(BUILD_TESTING "Build the testing tree." ON)

Modules/Documentation.cmake

-# DocumentationVTK.cmake
-#
+# - DocumentationVTK.cmake
 # This file provides support for the VTK documentation framework.
 # It relies on several tools (Doxygen, Perl, etc).
 

Modules/FindAVIFile.cmake

-# Locate AVIFILE library and include paths
-
-# AVIFILE (http://avifile.sourceforge.net/ )is a set of library for i386 machines
+# - Locate AVIFILE library and include paths
+# AVIFILE (http://avifile.sourceforge.net/)is a set of library for i386 machines
 # to use various AVI codecs. Support is limited beyond Linux. Windows
 # provides native AVI support, and so doesn't need this library.
-
 # This module defines
-# AVIFILE_INCLUDE_DIR, where to find avifile.h , etc.
-# AVIFILE_LIBRARIES, the libraries to link against to use AVIFILE
-# AVIFILE_DEFINITIONS, definitions to use when compiling code that uses AVIFILE.
-# AVIFILE_FOUND, If false, don't try to use AVIFILE.
+#  AVIFILE_INCLUDE_DIR, where to find avifile.h , etc.
+#  AVIFILE_LIBRARIES, the libraries to link against to use AVIFILE
+#  AVIFILE_DEFINITIONS, definitions to use when compiling code that uses AVIFILE.
+#  AVIFILE_FOUND, If false, don't try to use AVIFILE.
 
 IF (UNIX)
 

Modules/FindCABLE.cmake

-#
+# - Find CABLE
 # This module finds if CABLE is installed and determines where the
 # include files and libraries are.  This code sets the following variables:
-#
 #  CABLE              = the full path to the cable executable
 #  CABLE_TCL_LIBRARY  = the full path to the Tcl wrapper facility library
 #  CABLE_INCLUDE_DIR  = the full path to the cable include directory
-#
-#  To build Tcl wrappers, you should add shared library and link it to
-#  ${CABLE_TCL_LIBRARY}.  You should also add ${CABLE_INCLUDE_DIR} as
-#  an include directory.
-#
+# To build Tcl wrappers, you should add shared library and link it to
+# ${CABLE_TCL_LIBRARY}.  You should also add ${CABLE_INCLUDE_DIR} as
+# an include directory.
 
 IF(NOT CABLE)
   FIND_PATH(CABLE_BUILD_DIR cableVersion.h)

Modules/FindCurses.cmake

-#
-# Find the curses include file and library
+# - Find the curses include file and library
 #
 
 FIND_PATH(CURSES_INCLUDE_PATH 

Modules/FindCygwin.cmake

-# 
-# this module looks for Cygwin
+# - this module looks for Cygwin
 #
 
 IF (WIN32)

Modules/FindDCMTK.cmake

-#
-# try to find DCMTK libraries
+# - find DCMTK libraries
 #
 
-# DCMTK_INCLUDE_DIR   - Directories to include to use DCMTK
-# DCMTK_LIBRARIES     - Files to link against to use DCMTK
-# DCMTK_FOUND         - If false, don't try to use DCMTK
-# DCMTK_DIR           - (optional) Source directory for DCMTK
+#  DCMTK_INCLUDE_DIR   - Directories to include to use DCMTK
+#  DCMTK_LIBRARIES     - Files to link against to use DCMTK
+#  DCMTK_FOUND         - If false, don't try to use DCMTK
+#  DCMTK_DIR           - (optional) Source directory for DCMTK
 #
 # DCMTK_DIR can be used to make it simpler to find the various include
 # directories and compiled libraries if you've just compiled it in the

Modules/FindDart.cmake

-# 
-# this module looks for the dart testing software and sets DART_ROOT
-# to point to where it found it
+# - Find DART
+# This module looks for the dart testing software and sets DART_ROOT
+# to point to where it found it.
 #
 
 FIND_PATH(DART_ROOT README.INSTALL 

Modules/FindDoxygen.cmake

-# 
-# this module looks for Doxygen and the path to Graphiz's dot
-#
-
+# - this module looks for Doxygen and the path to Graphiz's dot
 # With the OS X GUI version, it likes to be installed to /Applications and
 # it contains the doxygen executable in the bundle. In the versions I've 
 # seen, it is located in Resources, but in general, more often binaries are 

Modules/FindFLTK.cmake

-#
-# Find the native FLTK includes and library
-#
+# - Find the native FLTK includes and library
 # The following settings are defined
-# FLTK_FLUID_EXECUTABLE, where to find the Fluid tool
-# FLTK_WRAP_UI, This allows the FLTK_WRAP_UI command to work.
-# FLTK_INCLUDE_DIR, where to find include files
-# FLTK_LIBRARIES, list of fltk libraries
-# FLTK_FOUND, Don't use FLTK if false.
-
+#  FLTK_FLUID_EXECUTABLE, where to find the Fluid tool
+#  FLTK_WRAP_UI, This allows the FLTK_WRAP_UI command to work.
+#  FLTK_INCLUDE_DIR, where to find include files
+#  FLTK_LIBRARIES, list of fltk libraries
+#  FLTK_FOUND, Don't use FLTK if false.
 # The following settings should not be used in general.
-# FLTK_BASE_LIBRARY    = the full path to fltk.lib
-# FLTK_GL_LIBRARY      = the full path to fltk_gl.lib
-# FLTK_FORMS_LIBRARY   = the full path to fltk_forms.lib
-# FLTK_IMAGES_LIBRARY  = the full path to fltk_images.lib
+#  FLTK_BASE_LIBRARY    = the full path to fltk.lib
+#  FLTK_GL_LIBRARY      = the full path to fltk_gl.lib
+#  FLTK_FORMS_LIBRARY   = the full path to fltk_forms.lib
+#  FLTK_IMAGES_LIBRARY  = the full path to fltk_images.lib
 
-# Platform dependent libraries required by FLTK
+#  Platform dependent libraries required by FLTK
 IF(WIN32)
   IF(NOT CYGWIN)
     IF(BORLAND)

Modules/FindGCCXML.cmake

-# Find the GCC-XML front-end executable.
+# - Find the GCC-XML front-end executable.
 FIND_PROGRAM(GCCXML
   NAMES gccxml
         ../GCC_XML/gccxml

Modules/FindGLU.cmake

-#
+
+
 # Use of this file is deprecated, and is here for backwards compatibility with CMake 1.4
 # GLU library is now found by FindOpenGL.cmake
 #

Modules/FindGLUT.cmake

-#
-# try to find glut library and include files
-#
-# GLUT_INCLUDE_DIR, where to find GL/glut.h, etc.
-# GLUT_LIBRARIES, the libraries to link against to use GLUT.
-# GLUT_FOUND, If false, do not try to use GLUT.
-
-# also defined, but not for general use are
-# GLUT_glut_LIBRARY = the full path to the glut library.
-# GLUT_Xmu_LIBRARY  = the full path to the Xmu library if available.
-# GLUT_Xi_LIBRARY   = the full path to the Xi Library if available.
+# - try to find glut library and include files
+#  GLUT_INCLUDE_DIR, where to find GL/glut.h, etc.
+#  GLUT_LIBRARIES, the libraries to link against to use GLUT.
+#  GLUT_FOUND, If false, do not try to use GLUT.
+# Also defined, but not for general use are:
+#  GLUT_glut_LIBRARY = the full path to the glut library.
+#  GLUT_Xmu_LIBRARY  = the full path to the Xmu library.
+#  GLUT_Xi_LIBRARY   = the full path to the Xi Library.
 
 IF (WIN32)
 

Modules/FindGTK.cmake

-#
-# try to find GTK (and glib) and GTKGLArea
-#
-
-# GTK_INCLUDE_DIR   - Directories to include to use GTK
-# GTK_LIBRARIES     - Files to link against to use GTK
-# GTK_FOUND         - If false, don't try to use GTK
-# GTK_GL_FOUND      - If false, don't try to use GTK's GL features
+# - try to find GTK (and glib) and GTKGLArea
+#  GTK_INCLUDE_DIR   - Directories to include to use GTK
+#  GTK_LIBRARIES     - Files to link against to use GTK
+#  GTK_FOUND         - If false, don't try to use GTK
+#  GTK_GL_FOUND      - If false, don't try to use GTK's GL features
 
 # don't even bother under WIN32
 IF(UNIX)

Modules/FindGnuplot.cmake

-# 
-# this module looks for gnuplot
+# - this module looks for gnuplot
 #
 
 INCLUDE(FindCygwin)

Modules/FindHTMLHelp.cmake

-#