ENH: some style fixes for the book

Modules/CMakeBackwardCompatibilityCXX.cmake

@@ -1,4 +1,4 @@
-# - define a bunch of backwards compatibility varibles
+# - define a bunch of backwards compatibility variables
 #  CMAKE_ANSI_CXXFLAGS - flag for ansi c++ 
 #  CMAKE_HAS_ANSI_STRING_STREAM - has <strstream>
 #  INCLUDE(TestForANSIStreamHeaders)

Modules/CMakeExportBuildSettings.cmake

@@ -1,6 +1,6 @@
 # - export build settings from a project.
-# CMAKE_EXPORT_BUILD_SETTINGS(SETTINGS_FILE) - macro defined to export the build 
-# settings for use by another 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 ".+")

Modules/CMakeImportBuildSettings.cmake

@@ -1,7 +1,7 @@
 # - 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_IMPORT_BUILD_SETTINGS(SETTINGS_FILE) 
+# macro defined to import the build settings from another project.  
+# SETTINGS_FILE is 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 ".+")

Modules/CheckIncludeFileCXX.cmake

@@ -1,5 +1,6 @@
 # - Check if the include file exists.
-#  CHECK_INCLUDE_FILE_CXX(INCLUDE VARIABLE) - macro which checks the include file exists.
+#  CHECK_INCLUDE_FILE_CXX(INCLUDE VARIABLE)
+#
 #  INCLUDE  - name of include file
 #  VARIABLE - variable to return result
 #  

Modules/CheckIncludeFiles.cmake

@@ -1,7 +1,7 @@
 # - Check if the files can be included
 #
 # CHECK_INCLUDE_FILES(INCLUDE VARIABLE)
-# - macro which checks the include file exists.
+#
 #  INCLUDE  - list of files to include
 #  VARIABLE - variable to return result
 #   

Modules/CheckLibraryExists.cmake

@@ -1,6 +1,6 @@
 # - 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

Modules/CheckSymbolExists.cmake

@@ -1,6 +1,6 @@
 # - 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

Modules/CheckVariableExists.cmake

@@ -1,6 +1,6 @@
 # - 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

Modules/FindAVIFile.cmake

@@ -1,12 +1,13 @@
 # - Locate AVIFILE library and include paths
-# AVIFILE (http://avifile.sourceforge.net/)is a set of library for i386 machines
+# AVIFILE (http://avifile.sourceforge.net/)is a set of libraries 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_LIBRARIES, the libraries to link against
+#  AVIFILE_DEFINITIONS, definitions to use when compiling
+#  AVIFILE_FOUND, If false, don't try to use AVIFILE
 
 IF (UNIX)
 

Modules/FindCABLE.cmake

@@ -1,9 +1,11 @@
 # - 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
+#
+#  CABLE             the path to the cable executable
+#  CABLE_TCL_LIBRARY the path to the Tcl wrapper library
+#  CABLE_INCLUDE_DIR the path to the 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.

Modules/FindFLTK.cmake

@@ -1,7 +1,7 @@
 # - 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_WRAP_UI, This enables the FLTK_WRAP_UI command
 #  FLTK_INCLUDE_DIR, where to find include files
 #  FLTK_LIBRARIES, list of fltk libraries
 #  FLTK_FOUND, Don't use FLTK if false.

Modules/FindGLUT.cmake

@@ -1,6 +1,6 @@
 # - 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_LIBRARIES, the libraries to link against
 #  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.

Modules/FindGTK.cmake

@@ -1,8 +1,8 @@
 # - 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
+#  GTK_FOUND         - GTK was found
+#  GTK_GL_FOUND      - GTK's GL features were found
 
 # don't even bother under WIN32
 IF(UNIX)

Modules/FindHTMLHelp.cmake

@@ -1,8 +1,8 @@
 # - This module looks for Microsoft HTML Help Compiler
 # It defines:
-#   HTML_HELP_COMPILER - path to the HTML Help Compiler (hhc.exe)
-#   HTML_HELP_INCLUDE_PATH - include path for HTML Help API (htmlhelp.h)
-#   HTML_HELP_LIBRARY - path to the HTML Help library (htmlhelp.lib)
+#   HTML_HELP_COMPILER - path to the Compiler hhc.exe
+#   HTML_HELP_INCLUDE_PATH - include path for htmlhelp.h
+#   HTML_HELP_LIBRARY - path to the library htmlhelp.lib
 #
 
 IF (WIN32)

Modules/FindITK.cmake

@@ -1,24 +1,24 @@
 # - Find an ITK installation or build tree.
+
 # When ITK is found, the ITKConfig.cmake file is sourced to setup the
 # location and configuration of ITK.  Please read this file, or
 # ITKConfig.cmake.in from the ITK source tree for the full list of
-# definitions.  Of particular interest is
+# definitions.  Of particular interest is ITK_USE_FILE, a CMake source file
+# that can be included to set the include directories, library directories,
+# and preprocessor macros.  In addition to the variables read from
+# ITKConfig.cmake, this find module also defines
+#  ITK_DIR  - The directory containing ITKConfig.cmake.  
+#             This is either the root of the build tree, 
+#             or the lib/InsightToolkit directory.  
+#             This is the only cache entry.
 #   
-#  ITK_USE_FILE  - A CMake source file that can be included
-#                  to set the include directories, library
-#                  directories, and preprocessor macros.
-# In addition to the variables read from ITKConfig.cmake, this find
-# module also defines
-#  ITK_DIR  - The directory containing ITKConfig.cmake.  This is 
-#             either the root of the build tree, or the 
-#             lib/InsightToolkit directory.  This is the only 
-#             cache entry.
-#   
-#  ITK_FOUND - Whether ITK was found.  If this is true, ITK_DIR is okay.
+#  ITK_FOUND - Whether ITK was found.  If this is true, 
+#              ITK_DIR is okay.
 #
 #  USE_ITK_FILE - The full path to the UseITK.cmake file.  
-#                 This is provided for backward compatability.  
-#                 Use ITK_USE_FILE instead.
+#                 This is provided for backward 
+#                 compatability.  Use ITK_USE_FILE
+#                 instead.
 
 
 SET(ITK_DIR_STRING "directory containing ITKConfig.cmake.  This is either the root of the build tree, or PREFIX/lib/InsightToolkit for an installation.")

Modules/FindImageMagick.cmake

@@ -2,11 +2,16 @@
 # This module finds if ImageMagick tools are installed and determines 
 # where the executables are. This code sets the following variables:
 #
-#  IMAGEMAGICK_CONVERT_EXECUTABLE   = the full path to the 'convert' utility 
-#  IMAGEMAGICK_MOGRIFY_EXECUTABLE   = the full path to the 'mogrify' utility 
-#  IMAGEMAGICK_IMPORT_EXECUTABLE    = the full path to the 'import'  utility 
-#  IMAGEMAGICK_MONTAGE_EXECUTABLE   = the full path to the 'montage' utility 
-#  IMAGEMAGICK_COMPOSITE_EXECUTABLE = the full path to the 'composite' utility 
+#  IMAGEMAGICK_CONVERT_EXECUTABLE   = 
+#     the full path to the 'convert' utility 
+#  IMAGEMAGICK_MOGRIFY_EXECUTABLE   = 
+#     the full path to the 'mogrify' utility 
+#  IMAGEMAGICK_IMPORT_EXECUTABLE    = 
+#     the full path to the 'import'  utility 
+#  IMAGEMAGICK_MONTAGE_EXECUTABLE   = 
+#     the full path to the 'montage' utility 
+#  IMAGEMAGICK_COMPOSITE_EXECUTABLE = 
+#     the full path to the 'composite' utility 
 #
 
 IF (WIN32)

Modules/FindJNI.cmake

@@ -3,9 +3,9 @@
 # include files and libraries are. It also determines what the name of
 # the library is. This code sets the following variables:
 #   
-#  JAVA_AWT_LIB_PATH     = the path to where the jawt library is
-#  JAVA_INCLUDE_PATH     = the path to where jni.h can be found
-#  JAVA_AWT_INCLUDE_PATH = the path to where jawt.h can be found
+#  JAVA_AWT_LIB_PATH     = the path to the jawt library
+#  JAVA_INCLUDE_PATH     = the include path to jni.h
+#  JAVA_AWT_INCLUDE_PATH = the include path to jawt.h
 # 
 
 SET(JAVA_AWT_LIBRARY_DIRECTORIES

Modules/FindJPEG.cmake

@@ -2,7 +2,7 @@
 # Find the native JPEG includes and library
 # This module defines
 #  JPEG_INCLUDE_DIR, where to find jpeglib.h, etc.
-#  JPEG_LIBRARIES, the libraries to link against to use JPEG.
+#  JPEG_LIBRARIES, the libraries needed to use JPEG.
 #  JPEG_FOUND, If false, do not try to use JPEG.
 # also defined, but not for general use are
 #  JPEG_LIBRARY, where to find the JPEG library.

Modules/FindLATEX.cmake

@@ -2,13 +2,13 @@
 # This module finds if Latex is installed and determines where the
 # executables are. This code sets the following variables:
 #  
-#  LATEX_COMPILER        = the full path to the LaTeX compiler
-#  PDFLATEX_COMPILER     = the full path to the PdfLaTeX compiler
-#  BIBTEX_COMPILER       = the full path to the BibTeX compiler
-#  MAKEINDEX_COMPILER    = the full path to the MakeIndex compiler
-#  DVIPS_CONVERTER       = the full path to the DVIPS converter
-#  PS2PDF_CONVERTER      = the full path to the PS2PDF converter
-#  LATEX2HTML_CONVERTER  = the full path to the LaTeX2Html converter 
+#  LATEX_COMPILER:       path to the LaTeX compiler
+#  PDFLATEX_COMPILER:    path to the PdfLaTeX compiler
+#  BIBTEX_COMPILER:      path to the BibTeX compiler
+#  MAKEINDEX_COMPILER:   path to the MakeIndex compiler
+#  DVIPS_CONVERTER:      path to the DVIPS converter
+#  PS2PDF_CONVERTER:     path to the PS2PDF converter
+#  LATEX2HTML_CONVERTER: path to the LaTeX2Html converter 
 #
 
 IF (WIN32)

Modules/FindMatlab.cmake

@@ -1,10 +1,10 @@
 # - this module looks for Matlab
 # Defines:
-#  MATLAB_INCLUDE_DIR points to the include path for mex.h, engine.h
-#  MATLAB_LIBRARIES   list of libraries need: libmex.lib, libmx.lib and libeng.lib
-#  MATLAB_MEX_LIBRARY point to libmex.lib
-#  MATLAB_MX_LIBRARY  point to libmx.lib
-#  MATLAB_ENG_LIBRARY point to libeng.lib
+#  MATLAB_INCLUDE_DIR: include path for mex.h, engine.h
+#  MATLAB_LIBRARIES:   required libraries: libmex, etc
+#  MATLAB_MEX_LIBRARY: path to libmex.lib
+#  MATLAB_MX_LIBRARY:  path to libmx.lib
+#  MATLAB_ENG_LIBRARY: path to libeng.lib
 
 
 SET(MATLAB_FOUND 0)