<p><b>dwj07@fsu.edu</b> 2013-03-22 11:06:47 -0600 (Fri, 22 Mar 2013)</p><p><br>
        -- DOCUMENT COMMIT --<br>
<br>
        Updating shared build instructions.<br>
</p><hr noshade><pre><font color="gray">Modified: trunk/documents/users_guide/shared/mpas_build_instructions.tex
===================================================================
--- trunk/documents/users_guide/shared/mpas_build_instructions.tex        2013-03-22 15:44:18 UTC (rev 2658)
+++ trunk/documents/users_guide/shared/mpas_build_instructions.tex        2013-03-22 17:06:47 UTC (rev 2659)
@@ -28,8 +28,6 @@
 
 {\tt &gt; setenv CC gcc} 
 
-{\tt &gt; setenv CPPFLAGS '-DpgiFortran'} 
-
 {\tt &gt; ./configure --prefix=XXXXX --disable-dap --disable-netcdf-4 --disable-cxx \hfill\break --disable-shared --enable-fortran} 
 
 {\tt &gt; make}
@@ -40,6 +38,7 @@
 Here, {\tt XXXXX} should be replaced with the directory that will serve as the root installation directory for netCDF.
 {\em Before proceeding to compile PIO the {\tt NETCDF\_PATH} environment variable should be set to the netCDF root installation directory.}
 
+Certain compilers require addition flags in the CPPFLAGS environment variable. Please refer to the netCDF installation instructions for these flags.
 
 \subsection{parallel-netCDF}
 
@@ -68,7 +67,10 @@
 
 Due to the rapid development pace of PIO, the preferred method of obtaining the PIO library is via subversion checkout. The PIO repository URL
 can be found at \url{http://code.google.com/p/parallelio/}.
-Assuming that all environment variable mentioned in the preceding sections are still set (including {\tt NETCDF\_PATH} and {\tt PNETCDF\_PATH}), the following shell commands are generally sufficient to build the PIO library; there is no separate installation step for PIO.
+Assuming that all environment variables mentioned in the preceding sections are
+still set (including {\tt NETCDF\_PATH} and {\tt PNETCDF\_PATH}), the following
+shell commands are generally sufficient to build the PIO library; there is no
+separate installation step for PIO.
 
 \vspace{12pt}
 {\tt &gt; svn co http://parallelio.googlecode.com/svn/trunk/pio PIO}
@@ -95,7 +97,7 @@
 {\tt &gt; make gfortran}
 \vspace{12pt}
 
-</font>
<font color="blue">oindent to build the code using the GNU Fortran and C compilers. Available targets are listed in the table below, and additional
+</font>
<font color="gray">oindent to build the code using the GNU Fortran and C compilers. Some of the available targets are listed in the table below, and additional
 targets can be added by simply editing the top-level {\tt Makefile}.
 
 \vspace{12pt}
@@ -110,6 +112,13 @@
 \end{longtable}
 \vspace{12pt}
 
+In order to get a more complete and up-to-date list of available tagets, one can use the following command within the top-level of MPAS.
+{\small
+\begin{verbatim}
+&gt; make -qp | awk -F':' '/^[a-zA-Z0-9][^$#\/\t=]*:([^=]|$)/ {split($1,A,/ /);for(i in A)print A[i]}'
+\end{verbatim}
+}
+
 The MPAS framework supports multiple {\em cores} --- currently a shallow water
 model, an ocean model, a hydrostatic atmosphere model, a non-hydrostatic atmosphere model, and a non-hydrostatic atmosphere initialization core --- so the build
 process must be told which core to build. This is done by either setting the environment variable
@@ -134,6 +143,46 @@
 be created in the {\tt src/} subdirectory, and a symbolic link to the model executable 
 should exist in the top-level MPAS directory.
 
+In order to get a list of available cores, one can simply run the top-level {\tt Makefile} without setting the {\tt CORE} environment variable, or passing the core via the command-line. And example of the output from this can be seen below.
+
+{\small
+\begin{verbatim}
+&gt; make
+( make error )
+make[1]: Entering directory `/home/douglasj/Documents/svn-mpas-model.cgd.ucar.edu/trunk/mpas'
+
+Usage: make target CORE=[core] [options]
+
+Example targets:
+ifort
+gfortran
+xlf
+pgi
+
+Availabe Cores:
+atmos_physics
+hyd_atmos
+init_nhyd_atmos
+nhyd_atmos
+ocean
+sw
+
+Available Options:
+DEBUG=true    - builds debug version. Default is optimized version.
+USE_PAPI=true - builds version using PAPI for timers. Default is off.
+TAU=true      - builds version using TAU hooks for profiling. Default is off.
+
+Ensure that NETCDF, PNETCDF, PIO, and PAPI (if USE_PAPI=true) are environment variables
+that point to the absolute paths for the libraries.
+
+************ ERROR ************
+No CORE specified. Quitting.
+************ ERROR ************
+
+make[1]: Leaving directory `/home/douglasj/Documents/svn-mpas-model.cgd.ucar.edu/trunk/mpas'
+\end{verbatim}
+}
+
 \section{Cleaning}
 
 To remove all files  that were created when the model was built, including the model executable itself, {\tt make} may

</font>
</pre>