Quick And Dirty CVS instructions

After you have become a member and want to submit or contribute to code, you must use CVS.  CVS client software needs to be installed on your computer.  If you are a UNIX user, you already have CVS installed. You can follow the documentation on the SourceForge web site for getting started. If you are exclusively a windows user and new to software development, start here but consult the SourceForge documentation for more details. 

  1. Go to www.cygwin.com and download the latest version of Cynus for Windows.  Install this package on your computer.
  2. Bring up a "cygwin" using the Start->Programs->Cygnus Solutions->CynWin Bash Shell.
  3. Determine where you want to put your code.  For example, under Course15. 
  4. Create a directory on your computer with a name that indicates what it is you are submitting.
  5. Make sure you set the following environment variables in your shell. 
    export CVS_RSH=ssh 
    export CVSROOT=loginname@cvs.yourproject.sourceforge.net:/cvsroot/yourproject

    loginname is the name you use to log into SourceForge

     

  6. Now put your code in the mitopensource repository

    cvs import directoryname vendor start 

     directoryname is the name under which the repository will be accessed. If all goes well it will ask for your SourceForge user password, and then go on its merry way importing your whole source tree.  
  7. Note that it will ask you to insert some comments.  This is in the "vi" editor.  To type a comment, type "i" for insert, then type your comment and then type the "esc" key followed by  ":" followed by a "wq" for write-quit.
  8. Note also that when you login, you will be asked about a security code from RSA.  Respond "yes" and then when asked for your password, give your SourceForge password.

    Next, backup your old code base somewhere, because you don't want to work with it anymore, and checkout a fresh CVS version using: 

    cvs -z3 checkout directoryname 

    This will get you a "working copy" of the code, in CVS form, ready for you to hack on. You should remember, however, that any changes such as adding/removing files and directories must be explicitly stated to CVS - see the above mentioned book for details.

Example

In my case, first, I set up my environment.  Using the CygWin Bash Shell as described above, I typed:

export CVS_RSH=ssh

export CVSROOT=cmiyachi@cvs.mitopensource.sourceforge.net:/cvsroot/mitopensource

Then I went to a directory where the code was.  In my case it was under c:/backup/thesis/Course15/SDM/ObjectProcessMethodology.  I went to c:/backup/thesis.  Then I typed in

cvs import mitopensource

Now on the CVS repository there is a mitopensource/Course15/SDM/ObjectProcessMethodology.

Guidelines

Always include documentation in your directory about the code you are submitting.
A PDF file of your thesis would also be useful.
For code snippets from theses, you can add a directory under your code with a useful name.
For larger projects, you may want to put them at the top level.
For more control, you also may want to create your own SourceForge project and have us put a link on our home page to your area.

The MIT Open Source CVS Repository should look like this:

mitopensource

|

mitopensource

|

|                                            |                        |            ...

Course15                Course6                Course2

|        |        |

SDM  MBA