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.