This is the most updated version of ROMS2.2 for ChesROMS.  ChesROMS hydrodynamic source code 
  is distributed as a patch file in this directory, and here are the instructions on how to generate the
  actual code by downloading roms2.2 from myroms.org and then apply the patch. 

     You should always use the code in this directory to run ChesROMS.

1) register and obtain username and password from myroms.org

2) check out the 2.2 version of the ROMS from myroms.org and store the results in this directory
   by:

   a) go to the current directory (the directory you read this readme file)

      cd $ChesROMS_ROOT/sorc/ROMS	

   b) type :

   svn checkout --username your_user_name_of_myroms https://www.myroms.org/svn/src/tags/roms-2.2 ROMS2.2 

   Now you should have a directory ROMS2.2 
 
   c)go into ROMS2.2, delete the .svn directory, because this .svn is created in 
     accordance with the myroms.org ROMS repository instead for the Source Forage repository of ChesROMS.

     cd ROMS2.2 
 
     find . -name .svn |xargs rm -r -f  

   d)go back to  $ChesROMS_ROOT/sorc/ROMS 
 
      cd  $ChesROMS_ROOT/sorc/ROMS

   3)apply the patch here created by ChesROMS team:

     patch -p0 < ChesROMS_1.0_to_ROMS2.2_patchfile 

   f)Now you can go in to ROMS2.2 directory and find a readme file on how to compile the ChesROMS code 

   To compile on your machine, please modify the makefile accordingly and the corresponding Makefile in 
./ROMS2.2/Compile/




##########################################################
#  The following are for ChesROMS model developers       #
#                                                        #
##########################################################

     How ChesROMS_1.0_to_ROMS2.2_patchfile is created:

     1) The developers should have a most uptodate ROMS2.2 directory in $ChesROMS_ROOT/sorc/ROMS 
 
     2) Once a developer thinks he or she is ready to re-generate a patch file to be applied to ROMS2.2 of myroms.org 
 
        she or she will do the following:

        a)cd $ChesROMS_ROOT/sorc/ROMS

        b)rename the latest ROMS2.2 code to ChesROMS2.2
          mv ROMS2.2 ChesROMS2.2

        c)checkout the myroms.org copy of ROMS2.2 from myroms.org:

          svn checkout --username developer_user_name_of_myroms https://www.myroms.org/svn/src/tags/roms-2.2 ROMS2.2           
          cd ROMS2.2
  
          find . -name .svn |xargs rm -r -f    
  
          cd  $ChesROMS_ROOT/sorc/ROMS

        d)generate a patch file 

          diff -urN ROMS2.2/ ChesROMS2.2/ > ChesROMS_1.0_to_ROMS2.2_patchfile 

        e)delete the ChesROMS2.2 directory 

          rm -r -f ChesROMS2.2
      
        f)apply the patch file to the downloaded ROMS2.2 from myroms.org

          patch -p0 < ChesROMS_1.0_to_ROMS2.2_patchfile 

        g)Now the new patch file is generated, he or she should be ready to commit the change to SourceForge ChesROMS repository
    
          cd $ChesROMS_ROOT/sorc/ROMS
          svn commit



Creation:          Wen Long, May 2nd, 2007
Last Modification: Wen Long, Jan 9th, 2008