Setting up CVS and Xcode to work with sourceforge

First, note that all of these instructions will assume you are using bash as your shell. The instructions will assume you are using my CVS project, eoglass. Simply replace "eoglass" with the name of your own project if you are using something else. Please note that your account MUST be set up to be able to contribute to a project before you are able to modify code within that project. If you need to be added to the eoglass project, email me Also note that on some versions of mac os X your version of cvs will be called ocvs instead.

Edit the file ~/.bash_profile and add the following lines:
export CVS_RSH=ssh export CVSROOT=username@cvs.sourceforge.net:/cvsroot/eoglass
Set up SSH to allow automatic login to the sourceforge servers
- Use ssh_keygen to generate dsa and rsa keys. We will only actually be using the DSA key, however Xcode has a bug where it will not correctly authenticate unless both keys are present. Open a terminal and run the following commands:
  
  ssh-keygen -t rsa ssh-keygen -t dsa
  When asked what name to save the rsa key under, accept the default. For the dsa key, save it as .ssh/sf_id_dsa in your home directory.
- Upload the SSH key to Sourceforge. First, cat the contents of the sf_id_dsa public key:
  
  cat ~/.ssh/sf_id_dsa.pub
  
  Highlight and copy this key. Go to http://sourceforge.net/account/editsshkeys.php and upload the key, making sure to get the entire key on a single line with no carriage returns. Note that it can take several minutes before this public key propagates to all of SF's servers.
- Edit the file ~/.ssh/config and add the following:
  
  Host *.sourceforge.net # Sourceforge identity file IdentityFile ~/.ssh/sf_id_dsa User username
- Test that your ssh key pair is set up correctly. Connect to the Sourceforge CVS server and see if it asks you for a password. If it does, something is wrong with the setup.
  
  ssh cvs.sourceforge.net
  
  The cvs server at sourceforge does not allow interactive shells, so immediately after login you will get a short MOTD and disconnect. This is normal; as long as you are able to login without using a password, everything is OK.
Add a module into sourceforge. Each module should be some cohesive bit of code and related files. For example, one of the modules I have hosted on the site is called "totalredux" and includes the program as well as its input files and some associated little programs used to analyze the data it produces. This is optional, and only required if you are going to move one of your own projects to sourceforge.
- Make a copy of your code directory and remove all files you don't want added to the CVS repository. This would include any binaries, object files, data files, etcetera.
- Change into the directory where you have put the code you're going to upload, and and type:
  
  cvs import -m "modulename: initial import to sourceforge" modulename vendor start
  
  where modulename is the title for the bit of code you want to add and vendor is a title you choose for the vendor of the code. In my case, I use "emorycompphys". Remember, on some macs, "cvs" is replaced by "ocvs"
- Move your old copies of the code somewhere out of the way, and confirm that you are able to check out the code you just imported. Type the command:
  
  cvs checkout modulename
  
  This should download a copy of the module into the directory modulename
- If the code is an xcode project, open it in xcode as you normally would. This is where things might get difficult. If Xcode asks for a password, it is usually acceptible to simply leave it blank, as your authentication should be handled by the key pair. Now, we must make sure xcode is configured correctly to use CVS.
  - In the Groups & Files window of your project, right click (control-click) on the project name and choose "get info".
  - In the General tab, make sure the "Enable SCM" box is checked, and the SCM system is CVS
  - Click the "Edit" button next to CVS and make sure the path to the CVS program is correct. Also make sure "Use SSH instead of RSH" is checked.
  - Go to the SCM tab, and make sure you can see version information for your code
  At this point, you should be set up and ready to go to use CVS from within Xcode to maintain your code. You can follow similar instructions to set up CVS on other machines, so you can access your code from Sourceforge no matter where you are. If you have any questions, problems, or suggestions for improving this document, please email me