CVS basic command set

  This is a very short description of some basic CVS commands, 
  taking the mypack package as an example.

  It assumes that an environment variable called $MYROOT has been set up.

• cvs checkout mypack package:

     get an image of the mypack package under $MYROOT.
     > cd $MYROOT
     > cvs co mypack
     > cd mypack
     > ls
        -- list of all mypack files -- 
     

• cvs checkout a patch of mypack package:

     get an image of the mypack/mypatch package under $MYROOT.
     > cd $MYROOT
     > cvs co mypack/mypatch
     > cd mypack
     > ls
       mypatch
     > cd mypatch
        -- list of all mypatch files --
     

• cvs checkout a file of a patch of mypack package:

     get an image of the mypack/mypatch/myfile.F package under $MYROOT.
     > cd $MYROOT
     > cvs co mypack/mypatch/myfile.F
     > cd mypack
     > ls
       mypatch
     > cd mypatch
     > ls
       myfile.F  
     

• cvs -n update mypack:

     look at what files have changed since last update 
     or checkout.
     > cd $MYROOT
     > cvs -n update mypack
       U prefix means the file has been updated on the repository.
       M prefix means you have modified the file.
       C prefix means the file has been updated on the repository and 
         you have modified it.
     

• cvs update mypack

     update your directory with what is new on the repository.
     > cd $MYROOT
     > cvs update mypack
     

• cvs add newfile [newfile2] [newfile3]

     tell cvs that you have added some files to mypack/mypatch.
     > cd $MYROOT/mypack/mypatch
     > -- add file1 file2 --
     > cvs add file1 file2
     

• cvs remove oldfile [oldfile2]

     tell cvs that you have removed some files from mypack/mypatch.
     > cd $MYROOT/mypack/mypatch
     > -- rm file1 --
     > cvs remove file1
     

• cvs commit

     commit your changes to the repository: make them avalaible to everbody else
     through a cvs update or a cvs checkout.
     > cd $MYROOT/mypack
     > cvs commit -m 'mypack01 new version'
     

• cvs import to install a new package called mypack:

     files which belong to mypack new package are stored in mypack directory,
     mypack can contain patch subdirectories.
     > cd mypack
     > cvs import mypack -m 'import mypack' myname mypack00  
     

• cvs update -j anOldTag:

     Sometimes is may be necessary to put back on the cvs HEAD and old version of a package, tagged with anOldTag.
     The following should work:
     > getpack mypack head
     > cd mypack
     > cvs update -j ThePreviousTag
     > cvs diff -r ThePreviousTag     (this is the crucial check: there should be no diffs, other than in $Id: or similar)
     > cvs commit -m "roll back to to ThePreviousTag"
     > cvs rtag -F ThePreviousTag mypack  (moves the old tag to the head if required)