--- mitgcm.org/front_content/using_cvs.xml 2003/12/06 20:06:58 1.5 +++ mitgcm.org/front_content/using_cvs.xml 2005/09/29 12:22:54 1.10 @@ -39,7 +39,7 @@ $ export CVSROOT=':pserver:cvsanon@mitgcm.org:/u/gcmpack' $ cvs login ( enter the CVS password: "cvsanon" ) - $ cvs co MITgcm MITgcm_contrib + $ cvs co MITgcm

Using a "C", "csh", or "tcsh" shell the commands are:

@@ -48,9 +48,22 @@ $ setenv CVSROOT ':pserver:cvsanon@mitgcm.org:/u/gcmpack' $ cvs login ( enter the CVS password: "cvsanon" ) - $ cvs co MITgcm MITgcm_contrib + $ cvs co MITgcm +

A large amount of additional (optional!) content can be obtained from the + MITgcm_contrib directory that can be checked out using: + +

+  $ cvs co MITgcm_contrib
+
+ + 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.).

+

Note that you will only need to perform the "cvs login" once. And for convenience, you may want to add the CVSROOT variable to your shell's environment (that is, define it within your "~/.bashrc" or "~/.chsrc" @@ -60,9 +73,9 @@

Getting Parts of the Source "Tree"

The above commands demonstrate how to check out all of the MITgcm code - and the "contributed" (that is, unsupported by often useful) information - within the "MITgcm_contrib" directory. In many cases, this is overkill - and can result in long download times. To reduce the volume of + and the "contributed" (that is, unsupported by occasionally useful) + information within the "MITgcm_contrib" directory. In many cases, this is + overkill and can result in long download times. To reduce the volume of information downloaded and thereby speedup the download times, one can select one of the following pre-defined "aliases" that will provide a sub-set of the entire MITgcm source "tree":

@@ -107,11 +120,19 @@ --> +

It is important to note that the CVS aliases above cannot be used in + conjunction with the CVS -d DIRNAME option. However, the MITgcm + directories they create can be changed to a different name following the + check-out:

+
+  $ cvs co MITgcm_verif_basic
+  $ mv MITgcm MITgcm_verif_basic
+

Getting Specific Releases or "Checkpoints"

As shown within the CVS + href="http://mitgcm.org/cgi-bin/viewcvs.cgi/MITgcm/doc/tag-index"> CVS Code Browser, the MITgcm code is continuously undergoing updates. At points during the development (typically, after work has been done and the source code has passed the verification