| 34 | mechanism for "committing" or "checking in" changes (please see below). | mechanism for "committing" or "checking in" changes (please see below). | 
| 35 | Using CVS pserver from the command line requires just a three commands. | Using CVS pserver from the command line requires just a three commands. | 
| 36 | Using a Bourne, "bash", or "sh-compatible" shell they are:</p> | Using a Bourne, "bash", or "sh-compatible" shell they are:</p> | 
| 37 |  |  | 
| 38 | <pre> | <pre> | 
| 39 | $ export CVSROOT=':pserver:cvsanon@mitgcm.org:/u/gcmpack' | $ export CVSROOT=':pserver:cvsanon@mitgcm.org:/u/gcmpack' | 
| 40 | $ cvs login | $ cvs login | 
| 41 | ( enter the CVS password: "cvsanon" ) | ( enter the CVS password: "cvsanon" ) | 
| 42 | $ cvs co MITgcm | $ cvs co -P MITgcm | 
| 43 | </pre> | </pre> | 
| 44 |  |  | 
| 45 | <p>Using a "C", "csh", or "tcsh" shell the commands are:</p> | <p>Using a "C", "csh", or "tcsh" shell the commands are:</p> | 
| 48 | $ setenv CVSROOT ':pserver:cvsanon@mitgcm.org:/u/gcmpack' | $ setenv CVSROOT ':pserver:cvsanon@mitgcm.org:/u/gcmpack' | 
| 49 | $ cvs login | $ cvs login | 
| 50 | ( enter the CVS password: "cvsanon" ) | ( enter the CVS password: "cvsanon" ) | 
| 51 | $ cvs co MITgcm | $ cvs co -P MITgcm | 
| 52 | </pre> | </pre> | 
| 53 |  |  | 
| 54 | <p>A large amount of additional (optional!) content can be obtained from the | <p>using the "-P" option to check-out ("<i>cvs co -P</i>") prevents | 
| 55 | MITgcm_contrib directory that can be checked out using: | to download unnecessary empty directories.</p> | 
| 56 |  |  | 
| 57 |  | <p>A large amount of additional (optional!) content is available | 
| 58 |  | from the <i>MITgcm_contrib</i> directory; much of it is specific to certain | 
| 59 |  | setups (eg. high-res setups, in-development material that is not yet part | 
| 60 |  | of the "main" code, etc ...). | 
| 61 |  | But rather than checking out the full content of MITgcm_contrib | 
| 62 |  | ("<i>cvs co -P MITgcm_contrib</i>"), which takes a long time to download | 
| 63 |  | (particularly from remote locations), we recommend to download only the | 
| 64 |  | specific part of interest, e.g.: "<i>submesoscale</i>" directory, | 
| 65 |  | which can be checked out using:</p> | 
| 66 |  |  | 
| 67 | <pre> | <pre> | 
| 68 | $ cvs co MITgcm_contrib | $ cvs co -P MITgcm_contrib/submesoscale | 
| 69 | </pre> | </pre> | 
| 70 |  |  | 
|  | In general, we do not recommend checking out all of MITgcm_contrib since |  | 
|  | it takes a long time to download (particularly from remote locations) and |  | 
|  | much of it is specific to certain setups (eg. high-res setups, |  | 
|  | in-development material that is not yet part of the "main" code, |  | 
|  | etc.).</p> |  | 
|  |  |  | 
| 71 | <p>Note that you will only need to perform the "cvs login" once.  And for | <p>Note that you will only need to perform the "cvs login" once.  And for | 
| 72 | convenience, you may want to add the CVSROOT variable to your shell's | convenience, you may want to add the CVSROOT variable to your shell's | 
| 73 | environment (that is, define it within your "~/.bashrc" or "~/.chsrc" | environment (that is, define it within your "~/.bashrc" or "~/.chsrc" | 
| 77 | <h4>Getting Parts of the Source "Tree"</h4> | <h4>Getting Parts of the Source "Tree"</h4> | 
| 78 |  |  | 
| 79 | <p>The above commands demonstrate how to check out all of the MITgcm code | <p>The above commands demonstrate how to check out all of the MITgcm code | 
| 80 | and the "contributed" (that is, unsupported by occasionally useful) | and the "contributed" (that is, unsupported but occasionally useful) | 
| 81 | information within the "MITgcm_contrib" directory.  In many cases, this is | information within the "<i>MITgcm_contrib</i>" directory. In many cases, | 
| 82 | overkill and can result in long download times.  To reduce the volume of | this is overkill and can result in long download times. | 
| 83 | information downloaded and thereby speedup the download times, one can | To reduce the volume of information downloaded and thereby speedup the | 
| 84 | select one of the following pre-defined "aliases" that will provide a | download times, one can select one of the following pre-defined "aliases" | 
| 85 | sub-set of the entire MITgcm source "tree":</p> | that will provide a sub-set of the entire MITgcm source "tree":</p> | 
| 86 |  |  | 
| 87 | <table align="center" border="0" cellpadding="10" width="90%" summary="CVS | <table align="center" border="0" cellpadding="10" width="90%" summary="CVS | 
| 88 | aliases"> | aliases"> | 
| 134 | directories they create can be changed to a different name following the | directories they create can be changed to a different name following the | 
| 135 | check-out:</p> | check-out:</p> | 
| 136 | <pre> | <pre> | 
| 137 | $ cvs co MITgcm_verif_basic | $ cvs co -P MITgcm_verif_basic | 
| 138 | $ mv MITgcm MITgcm_verif_basic | $ mv MITgcm MITgcm_verif_basic | 
| 139 | </pre> | </pre> | 
| 140 |  |  | 
| 152 | option such as: </p> | option such as: </p> | 
| 153 |  |  | 
| 154 | <pre> | <pre> | 
| 155 | $ cvs co -r release1_p5 MITgcm | $ cvs co -P -r release1_p5 MITgcm | 
| 156 | $ cvs co -r checkpoint52a_post MITgcm | $ cvs co -P -r checkpoint52a_post MITgcm | 
| 157 | </pre> | </pre> | 
| 158 |  |  | 
| 159 | <p>By default (that is, when no tag is specified), CVS will retrieve the | <p>By default (that is, when no tag is specified), CVS will retrieve the |