RHexLib Project

--- RHex Control Software Libraries ---

quick start
ESP article

Project home
CVS Access
CVS Tutorial

RHex home
Hosted by:
SourceForge Logo

How to get RHexLib through CVS

This documents explains the steps necessary to get your hands on the active development versions of RHexLib packages and contribute back to the source tree.

First of all, you must have become a RHexLib developer. This is necessary to access the CVS repository. Also, you must have Secure Shell(SSH) facilities available on your system. Please contact your system administrator if they are not, because SourceForge requires using secure shell connections for their CVS stuff. Next, you have to complete the following steps:

  • Login to the SourceForge rhex CVS server for the first time. This will create your home directory on the server, which is necessary before you can check out versions of the packages:
# ssh cvs.rhex.sourceforge.net
The server will not let you stay logged in and will kick you out after spitting out some messages. Don't worry about this. Your home directory will be created, which is what is important.
  • Define the necessary environment variables. If you are using csh or tcsh, place the following lines in the .cshrc file in your home directory (replacing username with your SourceForge user name), then logout and log back in.
setenv CVS_RSH ssh
setenv CVSROOT :ext:username@cvs.rhex.sourceforge.net:/cvsroot/rhex
Similarly, if you are using bash, you will need to place the following lines in the .bashrc file in your home directory.
export CVS_RSH=ssh
export CVSROOT=:ext:username@cvs.rhex.sourceforge.net:/cvsroot/rhex

You are now in a position to start using CVS. Please take some time now, and skim through the CVS documentation, because, although CVS is an extremely useful tool, you could do *considerable damage* to the project if you are unfamiliar with its usage. The following links are also useful CVS resources.

SourceForge CVS HOWTO
SourceForge CVS/SSH FAQ
The CVS Book
CVS Docs at www.loria.fr

Once you get up and running with CVS, I would highly recommend it to use it for your own RHexLib development directories as well. You will never need to worry about backing your files or digging up old versions from some forgotten directory.

Now, you can check out local versions of the library packages using the following commands:

# cd ~/RHex
# cvs checkout RHexLib
# cvs checkout MichLib
# cvs checkout McGillLib

Note that each of these command will prompt you for your SourceForge password, login remotely to the CVS repository and retrieve the source files. You will need to first compile RHexLib in order to be able to compile MichLib and McGillLib.

There are ways of configuring ssh such that it does not prompt you with a password each time you execute these commands. The ways in which this can be done are explained in CVS/SSH FAQ and SSH Keys and CVS/Shell Accounts.



This page was created by Uluc Saranli, 2001