Book in CVS on Ricardo


As of September 2005 The "Information book" files are available via CVS over ssh, using the ext method.

CVS Client programs

Linux: RPMs and source are available from www.nongnu.org.

win32: Try wincvs from www.wincvs.org (or some prefer tortoisecvs).

SSH setup

There are two prequisites for using CVS via ssh.

First, you have to set the environment variable CVS_RSH to ssh. Nothing will work if this is not done: CVS traffic can get through only if it goes via the ssh port (22).

Second, you have to generate (if you don't already have) a public key/private key pair suitable for use with ssh, and send me the public key so that I can install it on ricardo. You can make keys with, for example

 ssh-keygen -t rsa

with that approach you'd then send me the resulting id_rsa.pub.

Initial local setup of CVS

With command-line CVS the routine for checking out a "module" (set of files) is as follows.

  cvs -d:ext:wpc@ricardo.ecn.wfu.edu:/home/cottrell/cvs checkout info_book

The string following the -d is the value of CVSROOT, in this case representing remote access to ricardo, acting as CVS server using the ext method. Paul, your username is "wpc"; Greg's is "greg"; Ian's is "iwright".

This should result in the creation of an info_book subdirectory of the current working directory, containing the checked out files.

Previously checked-out files

If you originally checked out files from CVS under the old pserver system, it is not absolutely necessary to check them out again. However, if you don't check them out again, it will be necessary to "re-root" the collection of CVS files. By this I mean changing all the files named "Root" in the "CVS" subdirectories of the tree to reflect the new setup. A shell script to do this:

for f in `find . -name "Root"` ; do cat $f | sed s/pserver/ext/ > tmproot && mv tmproot $f ; done

I think that's right -- at any rate, after modification the Root files should look like this:

:ext:user@ricardo.ecn.wfu.edu:/home/cottrell/cvs

where "user" is, of course, replaced appropriately.

Routine for editing sessions

When editing CVS files, it is a good idea first to ensure that your local copies are up to date with those on the server. Just issue the command cvs update in your local info_book directory.

After editing one or more of the files, commit the changes with cvs commit. To add a newly created file, do the following before committing:

  cvs add <filename>

Email notification of commits

When any of us commits material to the repository, we will all get email via the (closed) list cvsusers@ricardo.ecn.wfu.edu. Note that the sender (the person who commits) will appear to have a WFU email address in all cases, but any mail sent to these accounts will be forwarded to your real addresses.

WWW access to repository

You can examine the repository using cvsweb.

Bugzilla

I've installed this, at http://ricardo.ecn.wfu.edu/bugzilla. Here are Ian's notes on using Bugzilla.


Last updated August 17, 2006.