--- manual/s_phys_pkgs/text/exf.tex	2008/01/15 21:37:14	1.10
+++ manual/s_phys_pkgs/text/exf.tex	2011/06/21 19:07:20	1.14
@@ -22,13 +22,13 @@
 CPP options enable or disable different aspects of the package
 (Section \ref{sec:pkg:exf:config}).
 Runtime options, flags, filenames and field-related dates/times are
-set in \texttt{data.exf} and \texttt{data.exf\_clim}
+set in \texttt{data.exf}
 (Section \ref{sec:pkg:exf:runtime}).
 A description of key subroutines is given in Section
 \ref{sec:pkg:exf:subroutines}.
 Input fields, units and sign conventions are summarized in
 Section \ref{sec:pkg:exf:fields_units}, and available diagnostics
-output is listed in Section \ref{sec:pkg:exf:fields_diagnostics}.
+output is listed in Section \ref{sec:pkg:exf:diagnostics}.
 
 %----------------------------------------------------------------------
 
@@ -55,7 +55,7 @@
 no additional CPP options are required.
 %
 \end{itemize}
-(see Section \ref{sect:buildingCode}).
+(see Section \ref{sec:buildingCode}).
 
 Parts of the EXF code can be enabled or disabled at compile time
 via CPP preprocessor flags. These options are set in either
@@ -63,8 +63,7 @@
 Table \ref{tab:pkg:exf:cpp} summarizes these options.
 
 \begin{table}[b!]
-\centering
-  \label{tab:pkg:exf:cpp}
+  \centering
   {\footnotesize
     \begin{tabular}{|l|l|}
       \hline 
@@ -99,6 +98,7 @@
     \end{tabular}
   }
   \caption{~}
+  \label{tab:pkg:exf:cpp}
 \end{table}
 
 
@@ -119,16 +119,14 @@
 \paragraph{Enabling the package}
 ~ \\
 %
-A package is usually switched on/off at runtime by setting
+A package is switched on/off at runtime by setting
 (e.g. for EXF) \texttt{useEXF = .TRUE.} in \texttt{data.pkg}.
-For EXF this flag is omitted, i.e. EXF is always ON if it is compiled.
 
 \paragraph{General flags and parameters}
 ~ \\
 %
-\begin{table}[h!]
-\centering
-  \label{tab:pkg:exf:runtime_flags}
+\begin{table}[!ht]
+  \centering
   {\footnotesize
     \begin{tabular}{|l|c|l|}
       \hline 
@@ -224,6 +222,7 @@
     \end{tabular}
   }
   \caption{~}
+  \label{tab:pkg:exf:runtime_flags}
 \end{table}
 
 
@@ -246,9 +245,8 @@
 \end{eqnarray*}
 %
 
-\begin{table}[h!]
-\centering
-  \label{tab:pkg:exf:runtime_attributes}
+\begin{table}[!ht]
+  \centering
   {\footnotesize
     \begin{tabular}{|l|c|l|}
       \hline 
@@ -274,11 +272,11 @@
          \multicolumn{3}{|c|}{\textit{used in conjunction with} 
                               \texttt{EXF\_USE\_INTERPOLATION}} \\
          \hline
-         \textit{field}\texttt{\_lon0} & $thetaMin+delX/2$  & 
+         \textit{field}\texttt{\_lon0} & $xgOrigin+delX/2$  & 
            starting longitude of input \\
          \textit{field}\texttt{\_lon\_inc} & $delX$ &
            increment in longitude of input \\
-         \textit{field}\texttt{\_lat0} &  $phiMin+delY/2$ &
+         \textit{field}\texttt{\_lat0} &  $ygOrigin+delY/2$ &
            starting latitude of input \\
          \textit{field}\texttt{\_lat\_inc} & $delY$ &
            increment in latitude of input \\
@@ -289,9 +287,10 @@
       \hline
     \end{tabular}
    }
-   \caption{\newline
-            Note one exception for the default of 
-            \texttt{atempconst} = celsius2K = 273.16}
+  \caption{\newline
+           Note one exception for the default of 
+           \texttt{atempconst} = celsius2K = 273.16}
+  \label{tab:pkg:exf:runtime_attributes}
 \end{table}
 
 \paragraph{Example configuration} ~ \\
@@ -314,8 +313,16 @@
 \end{verbatim}
 
 EXF will read a file of name 'ncep\_qnet.bin'.
-Its first record represents January 1st, 1991 at 00:00 UTC.
+Its first record represents January 1st, 1992 at 00:00 UTC.
 Next record is 2592000 seconds (or 30 days) later.
+Note that the first record read and used by the EXF package corresponds to the
+value 'startDate1' set in data.cal.  Therefore if you want to start the EXF
+forcing from later in the 'ncep_qnet.bin' file, it suffices to specify
+startDate1 in data.cal as a date later than 19920101 (for example, startDate1
+= 19940101, for starting January 1st, 1994).  For this to work,
+'ncep_qnet.bin' must have at least 2 years of data because in this
+configuration EXF will read 2 years into the file to find the 1994 starting
+value.
 Interpolation on-the-fly is used (in the present case trivially
 on the same grid, but included nevertheless for illustration), 
 and input field grid starting coordinates and increments are 
@@ -569,14 +576,13 @@
 Available output fields are summarized in 
 Table \ref{tab:pkg:exf:diagnostics}.
 
-\begin{table}[h!]
+\begin{table}[!ht]
 \centering
-\label{tab:pkg:exf:diagnostics}
 {\footnotesize
 \begin{verbatim}
-------------------------------------------------------
+---------+----+----+----------------+-----------------
  <-Name->|Levs|grid|<--  Units   -->|<- Tile (max=80c)
-------------------------------------------------------
+---------+----+----+----------------+-----------------
  EXFhs   |  1 | SM | W/m^2          | Sensible heat flux into ocean, >0 increases theta
  EXFhl   |  1 | SM | W/m^2          | Latent heat flux into ocean, >0 increases theta
  EXFlwnet|  1 | SM | W/m^2          | Net upward longwave radiation, >0 decreases theta
@@ -599,6 +605,7 @@
 \end{verbatim}
 }
 \caption{~}
+\label{tab:pkg:exf:diagnostics}
 \end{table}
 
 %----------------------------------------------------------------------