--- MITgcm/pkg/mom_fluxform/mom_u_adv_uu.F	2001/05/29 14:01:38	1.2
+++ MITgcm/pkg/mom_fluxform/mom_u_adv_uu.F	2001/09/26 19:05:21	1.3
@@ -1,33 +1,49 @@
-C $Header: /home/ubuntu/mnt/e9_copy/MITgcm/pkg/mom_fluxform/mom_u_adv_uu.F,v 1.2 2001/05/29 14:01:38 adcroft Exp $
+C $Header: /home/ubuntu/mnt/e9_copy/MITgcm/pkg/mom_fluxform/mom_u_adv_uu.F,v 1.3 2001/09/26 19:05:21 adcroft Exp $
 C $Name:  $
 
 #include "CPP_OPTIONS.h"
 
+CBOP
+C !ROUTINE: MOM_U_ADV_UU
+
+C !INTERFACE: ==========================================================
       SUBROUTINE MOM_U_ADV_UU(
      I        bi,bj,k,
      I        uTrans, uFld,
      O        AdvectFluxUU,
      I        myThid)
-      IMPLICIT NONE
-C
-C     Calculate zonal advective flux of U using centered second order diff.
-C       - is not vector invariant ...
-C
 
-C     == Global variables ==
+C !DESCRIPTION:
+C Calculates the zonal advective flux of zonal momentum:
+C \begin{equation*}
+C F^x = \overline{U}^i \overline{u}^{i}
+C \end{equation*}
+
+C !USES: ===============================================================
+      IMPLICIT NONE
 #include "SIZE.h"
 #include "EEPARAMS.h"
 #include "PARAMS.h"
 
-C     == Routine arguments ==
+C !INPUT PARAMETERS: ===================================================
+C  bi,bj                :: tile indices
+C  k                    :: vertical level
+C  uTrans               :: zonal transport
+C  uFld                 :: zonal flow
+C  myThid               :: thread number
       INTEGER bi,bj,k
       _RL uTrans(1-OLx:sNx+OLx,1-OLy:sNy+OLy)
       _RL uFld(1-OLx:sNx+OLx,1-OLy:sNy+OLy)
-      _RL AdvectFluxUU(1-OLx:sNx+OLx,1-OLy:sNy+OLy)
       INTEGER myThid
 
-C     == Local variables ==
+C !OUTPUT PARAMETERS: ==================================================
+C  AdvectFluxUU         :: advective flux
+      _RL AdvectFluxUU(1-OLx:sNx+OLx,1-OLy:sNy+OLy)
+
+C !LOCAL VARIABLES: ====================================================
+C  i,j                  :: loop indices
       INTEGER I,J
+CEOP
 
       DO j=1-Oly,sNy+Oly-1
        DO i=1-Olx,sNx+Olx-1