Add usage comment, remove debugging note

CMakeLists.txt

@@ -19,21 +19,21 @@ endif()
 #     #> export bdir=`pwd`
 #     #> mkdir <new_build_dir>
 #     #> cd <new_build_dir>
-#     #> cmake $bdir
+#     #> cmake -DCMAKE_INSTALL_DIR:PATH=<dir> $bdir
 #     #> make
 #     [ optionally #> make install ]
 #
 # The install target will place all C++/Fortran header and mod files in an include folder,
-# and the CCSE libraries in a lib folder.
+# the CCSE libraries in a lib folder, plus some stuff in perl and cmake folders.
 #
-# Note: If you intend to use install, almost surely you will want to set the absolute path
-#       of the folder where the files will be installed:
+# An example cmake input file to build an app that links to the libs built from here:
+#
+#              BoxLib/Tutorials/MultiGrid_C/CMakeLists.txt
 #
-#           CMAKE_INSTALL_PREFIX
-# 
 # Below, we have set some of the switches for reasonable default behavior, these can be 
 # overridden at the cmake command line, ie  "cmake -DVAR=VALUE", or by editing the values
-# directly below.
+# directly below.  NOTE: If the C++ classes are to be used, the BL_SPACEDIM value must
+# agree between the lib and the app (at the moment this is not checked)
 #
 
 # Define the project name

Tools/CMake/InstallManager.cmake

@@ -170,9 +170,6 @@ endfunction(makefile_include_dirs)
 function(makefile_library_dirs)
 
     cmake_parse_arguments(PARSE_ARGS "" "MAKE_LIB_LIST" "CMAKE_LIB_LIST" ${ARGN})
-    #print_variable(PARSE_ARGS_CMAKE_LIB_LIST)
-    message(STATUS "PARSE_ARGS_CMAKE_LIB_LIST: ${PARSE_ARGS_CMAKE_LIB_LIST}")
-
     set(tmp_lib_list)
     set(loop_list ${PARSE_ARGS_CMAKE_LIB_LIST})
     list(REVERSE loop_list)

Tutorials/MultiGrid_C/CMakeLists.txt

@@ -1,4 +1,23 @@
 # -*- mode: cmake -*-------------------------------------------
+
+#
+# Usage:
+#
+# Typically cmake is used to support an "out-of-source-tree" build.  To this with default
+# settings (see below):
+#
+#     #> export bdir=`pwd`
+#     #> mkdir <new_build_dir>
+#     #> cd <new_build_dir>
+#     #> cmake $bdir
+#     #> make
+#
+# Below, we have set some of the switches for reasonable default behavior, these can be 
+# overridden at the cmake command line, ie  "cmake -DVAR=VALUE", or by editing the values
+# directly below.  NOTE: If the C++ classes are to be used, the BL_SPACEDIM value must
+# agree between the lib and the app (at the moment this is not checked)
+#
+
 cmake_minimum_required(VERSION 2.8.8)
 enable_language(CXX)
 enable_language(C)