--- manual/s_phys_pkgs/text/obcs.tex	2011/02/28 08:28:47	1.7
+++ manual/s_phys_pkgs/text/obcs.tex	2011/03/03 07:46:09	1.9
@@ -12,7 +12,7 @@
 \label{sec:pkg:obcs:intro}}
 
 The OBCS-package is fundamental to regional ocean modelling with the
-MITgcm, but because there are so many details to be considered in
+MITgcm, but there are so many details to be considered in
 regional ocean modelling that this package cannot accomodate all
 imaginable and possible options. Therefore, for a regional simulation
 with very particular details, it is recommended to familiarize oneself
@@ -105,7 +105,7 @@
 \code{data.pkg}, \code{data.obcs}, and \code{data.exf} 
 if ``real-time'' prescription is requested 
 (i.e. package \code{exf} enabled).
-These parameter files are read in S/R
+vThese parameter files are read in S/R
 \code{packages\_readparms.F}, \code{obcs\_readparms.F}, and
 \code{exf\_readparms.F}, respectively.
 Run-time parameters may be broken into 3 categories:
@@ -153,6 +153,8 @@
            ~ \\
         useOBCSbalance & \code{.FALSE.} & 
            ~ \\
+           OBCS\_balanceFacN/S/E/W & 0 & factor(s) determining the details
+           of the balaning code \\
         useOrlanskiNorth/South/EastWest & \code{.FALSE.} & 
            turn on Orlanski boundary conditions for individual boundary\\
         useStevensNorth/South/EastWest & \code{.FALSE.} & 
@@ -242,21 +244,26 @@
 means there is no corresponding OB in that column/row.
 For a Northern/Southern OB, the OB V point is to the South/North.
 For an Eastern/Western OB, the OB U point is to the West/East.
-
-\begin{verbatim}
- For example
-     OB_Jnorth(3)=34  means that:
-          T( 3 ,34) is a an OB point
-          U(3:4,34) is a an OB point
-          V( 4 ,34) is a an OB point
- while
-     OB_Jsouth(3)=1  means that:
-          T( 3 ,1) is a an OB point
-          U(3:4,1) is a an OB point
-          V( 4 ,2) is a an OB point
-\end{verbatim}
-
-For convenience, negative values for Jnorth/Ieast refer to
+For example,
+\begin{tabbing}
+  \code{OB\_Jnorth(3)=34} \=  means that:  \= \\
+  \> \code{T(3,34)} \> is a an OB point  \\
+  \> \code{U(3,34)} \> is a an OB point \\
+  \> \code{V(3,34)} \> is a an OB point \\
+  \code{OB\_Jsouth(3)=1} \> means that: \\
+  \> \code{T(3,1)} \> is a an OB point \\
+  \> \code{U(3,1)} \> is a an OB point \\ 
+  \> \code{V(3,2)} \> is a an OB point \\
+  \code{OB\_Ieast(10)=69} \>  means that:  \>  \\
+  \> \code{T(69,10)} \> is a an OB point \\
+  \> \code{U(69,10)} \> is a an OB point \\
+  \> \code{V(69,10)} \> is a an OB point \\
+  \code{OB\_Iwest(10)=1} \>  means that:  \>  \\
+  \> \code{T(1,10)} \> is a an OB point \\
+  \> \code{U(2,10)} \> is a an OB point \\
+  \> \code{V(1,10)} \> is a an OB point
+\end{tabbing}
+For convenience, negative values for \code{Jnorth}/\code{Ieast} refer to
 points relative to the Northern/Eastern edges of the model
 eg. $\tt OB\_Jnorth(3)=-1$  means that the point $\tt (3,Ny)$ 
 is a northern OB.
@@ -462,8 +469,10 @@
 \item \code{exp4}: box with 4 open boundaries, simulating flow over a
   Gaussian bump based on \citet{adcroft:97}, also tests
   Stevens-boundary conditions;
-\item \code{dome}: based on ``Denmark Strait Overflow Model
-  Experiment'', use Orlanski-BCs;
+\item \code{dome}: based on the project ``Dynamics of Overflow Mixing
+  and Entrainment''
+  (\url{http://www.rsmas.miami.edu/personal/tamay/DOME/dome.html}), uses
+  Orlanski-BCs;
 \item \code{internal\_wave}: uses a heavily modified \code{S/R~OBCS\_CALC}
 \item \code{seaice\_obcs}: simple example who to use the sea-ice
   related code, based on \code{lab\_sea};
