--- manual/s_software/text/sarch.tex	2001/11/13 20:13:55	1.6
+++ manual/s_software/text/sarch.tex	2002/04/24 09:00:53	1.8
@@ -1,10 +1,20 @@
-% $Header: /home/ubuntu/mnt/e9_copy/manual/s_software/text/sarch.tex,v 1.6 2001/11/13 20:13:55 adcroft Exp $
+% $Header: /home/ubuntu/mnt/e9_copy/manual/s_software/text/sarch.tex,v 1.8 2002/04/24 09:00:53 heimbach Exp $
 
-In this chapter we describe the software architecture and
-implementation strategy for the MITgcm code. The first part of this
-chapter discusses the MITgcm architecture at an abstract level. In the second 
-part of the chapter we described practical details of the MITgcm implementation 
-and of current tools and operating system features that are employed.
+This chapter focuses on describing the {\bf WRAPPER} environment within which
+both the core numerics and the pluggable packages operate. The description
+presented here is intended to be a detailed exposition and contains significant
+background material, as well as advanced details on working with the WRAPPER. 
+The tutorial sections of this manual (see Chapters
+\ref{chap:tutorialI}, \ref{chap:tutorialII} and \ref{chap:tutorialIII}) 
+contain more succinct, step-by-step instructions on running basic numerical
+experiments, of varous types, both sequentially and in parallel. For many 
+projects simply starting from an example code and adapting it to suit a 
+particular situation 
+will be all that is required.
+The first part of this chapter discusses the MITgcm architecture at an 
+abstract level. In the second part of the chapter we described practical 
+details of the MITgcm implementation and of current tools and operating system 
+features that are employed.
 
 \section{Overall architectural goals}
 
@@ -807,6 +817,7 @@
 WRAPPER is shown in figure \ref{fig:wrapper_startup}.
 
 \begin{figure}
+{\footnotesize
 \begin{verbatim}
 
        MAIN  
@@ -835,6 +846,7 @@
 
 
 \end{verbatim}
+}
 \caption{Main stages of the WRAPPER startup procedure.
 This process proceeds transfer of control to application code, which
 occurs through the procedure {\em THE\_MODEL\_MAIN()}.
@@ -1414,6 +1426,7 @@
 
 WRAPPER layer.
 
+{\footnotesize
 \begin{verbatim}
 
        MAIN  
@@ -1441,9 +1454,11 @@
        |--THE_MODEL_MAIN   :: Numerical code top-level driver routine
 
 \end{verbatim}
+}
 
 Core equations plus packages.
 
+{\footnotesize
 \begin{verbatim}
 C
 C
@@ -1782,6 +1797,7 @@
 C                     :: events.
 C 
 \end{verbatim}
+}
 
 \subsection{Measuring and Characterizing Performance}