--- mitgcm.org/front_content/using_cvs.xml 2003/12/04 16:20:41 1.2 +++ mitgcm.org/front_content/using_cvs.xml 2003/12/04 17:02:02 1.3 @@ -33,26 +33,24 @@ to use the CVS "pserver" mechanism. This method only allows you to "check out" (or obtain a local copy) of the source. It does not provide a mechanism for "committing" or "checking in" changes (please see below). - Using CVS pserver from the command line requires just a three - commands:

+ Using CVS pserver from the command line requires just a three commands. + Using a Bourne, "bash", or "sh-compatible" shell they are:

-
-Using a Bourne, "bash", or "sh-compatible" shell:
-$  export CVSROOT=':pserver:cvsanon@mitgcm.org:/u/gcmpack'
-$  cvs login 
-   ( enter the CVS password: "cvsanon" )
-$  cvs co MITgcm MITgcm_contrib
-

- -Using a "C", "csh", or "tcsh" shell: -
-$  setenv CVSROOT ':pserver:cvsanon@mitgcm.org:/u/gcmpack'
-$  cvs login
-   ( enter the CVS password: "cvsanon" )
-$  cvs co MITgcm MITgcm_contrib
+  $ export CVSROOT=':pserver:cvsanon@mitgcm.org:/u/gcmpack'
+  $ cvs login 
+    ( enter the CVS password: "cvsanon" )
+  $ cvs co MITgcm MITgcm_contrib
+
+ +

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

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

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 @@ -123,12 +121,10 @@ development. One can check out these versions using the "-r TAG_NAME" CVS option such as:

-
-$  cvs co -r release1_p5 MITgcm
-$  cvs co -r checkpoint52a_post MITgcm
+  $ cvs co -r release1_p5 MITgcm
+  $ cvs co -r checkpoint52a_post MITgcm
 
-

By default (that is, when no tag is specified), CVS will retrieve the latest version of all files.

@@ -140,27 +136,29 @@ that you yourself have made since obtaining the code. From within your working directory:

-
-
cvs diff
-
+
+  cvs diff
+
+

will show the differences between your version and the version that you checked out. It acts recursively on all directories below your current directory. You can limit the operation to just one file or directory by specifying those as arguments:

-
-
cvs diff file
-
+
+  cvs diff file
+
+

Show changes to the repository that you don't have

The source code evolves continuously and you should try to stay up to date. To see what needs to be updated:

-
-
cvs -n update
-
+
+  cvs -n update
+

behaves just as "cvs update" but doesn't actually change anything. This is a useful way of summarizing the state of your code. The meaning of the @@ -171,31 +169,31 @@

You can download and merge updates from the repository to bring you working code up to date:

-
-
cvs update -d -P
-
+
+  cvs update -d -P
+

will work recursively on all files in the current directory and below. To update just a specific file or directory:

-
-
cvs update file
-
+
+  cvs update file
+

You can also update to a specific version, just as you could check out a specific version.

-
-
cvs update -d -P -r release1_p5
-
+
+  cvs update -d -P -r release1_p5
+

If you checked out a specific version and want to update to the very latest use the -A option will remove associated with a specific version as follows:

-
-
cvs update -d -P -A
-
+
+  cvs update -d -P -A
+

"cvs update" produces output to the terminal with the following meanings: