| 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 |