== svn Tutorial ==

In this tutorial, you will learn how to download the ROMS/TOMS source code. To proceed, you will need to know your '''username''' and '''password''' which you selected when filling the ROMS/TOMS registration form.

== Check to Make Sure You Can See the Repository ==

The easiest way to view a repository is to simply look at it in a web browser.  Enter the URL of the repository (and your username and password), and start looking.  This is also a good way to see individual files in the repository without actually downloading them.

If you are using '''esvn''', right-click on the file menu and choose '''Browse Repository'''.

Enter the '''URL:''' {{{http://www.myroms.org/svn/Models}}} 

{{{



 
}}}

Click '''OK'''.

Now you should be able to look at the '''branches''' (currently, none), '''tags''', and '''trunk'''. You can also navigate the repository with a web browser, but cannot do any of the version control stuff that follows.

== Checkout a Copy of the Trunk ==
This process brings a copy of main code from the repository to your computer and places it under svn control.[[BR]]

URL of repository:[[BR]]
{{{http://www.myroms.org/svn/Models/trunk}}}[[BR]]
Checkout directory:[[BR]]
{{{/home/ocean/src}}}[[BR]]
You should see a bunch of stuff stream by like:
{{{
svn checkout http://www.myroms.org/svn/Models/trunk /home/ocean/src --username ocean --password ****** --non-interactive 
A /home/ocean/src/ROMS
A /home/ocean/src/ROMS/License_ROMS.txt
A /home/ocean/src/ROMS/Tangent
A /home/ocean/src/ROMS/Tangent/tl_rho_eos.F
A /home/ocean/src/ROMS/Tangent/tl_uv3dmix.F
A /home/ocean/src/ROMS/Tangent/tl_def_his.F
...
A /home/ocean/src/Compilers/UNICOS-mk-f90.mk
A /home/ocean/src/Compilers/CYGWIN-g95.mk
A /home/ocean/src/Compilers/OSF1-f90.mk
A /home/ocean/src/Compilers/Darwin-ifort.mk
A /home/ocean/src/Compilers/AIX-xlf.mk
A /home/ocean/src/Compilers/SunOS-f95.mk
A /home/ocean/src/makefile
Checked out revision 11.
successfully (0)
}}}

If you are using svn from the command line, as you would on most unix style machines, check out the respository using the command:
{{{
svn checkout  http://www.myroms.org/svn/Models/trunk  /home
}}}
(See the footnote for correctly installing svn with ssl support on unix style machines below.)

== Work Cycle ==
You can Import this branch to another computer...that is the best way to synchronize, say, a desktop at work with a travelling laptop.[[BR]]
After that, the cycle is:[[BR]]
At the top local directory, right-click, and under TortoiseSVN {{{Check for modifications}}}. Click Check Repository.[[BR]]
Make changes.[[BR]]
{{{Check for modifications}}} or {{{SVN Update}}} (again..can't hurt).[[BR]]
Finally, {{{SVN Commit...}}}[[BR]]

== Footnote on building svn on unix-like machines ==
On Unix style machines, you will need to have subversion installed.  You will typically want to build this from source, as you will want to compile with secure socket layers enabled (the binary versions of svn do not have this feature).  Find the source at {{{http://subversion.tigris.org/}}}.  Configure and make with 
{{{./configure --with-ssl
make
sudo make install}}}