Accessing NAPI source code with CVS

[Freddie Akeroyd]

*******************************
*** CVS Repository for NAPI ***
*******************************
Details about CVS can be found at:

http://www.loria.fr/~molli/cvs-index.html
http://www.cyclic.com/

and the source code is available by anonymous ftp from the directory

ftp://ftp.nd.rl.ac.uk/pub/packages/gnu

You will need to get "cvs-1.9.tar.gz", and probably "diffutils-2.7.tar.gz"
and "rcs-5.7.tar.gz" as well. If you operating system has an up-to-date
version of RCS, and a good diff3 command, the diffutils and rcs 
packages may not need to be installed. If you don't have a "patch" command
(unlikely), you'll need to find some source code for that as well.
We've got CVS compiled and running on SGI/IRIX, Alpha/DEC Unix, PC/Linux
and Alpha/VMS here at ISIS. Let me know if you have any installation problems.

*** Using CVS ***

>>> To get a copy of the files for the first time, use:

cvs -d nexus at sutekh.nd.rl.ac.uk:/usr/local/REPOSITORY co nexus

This command works by using "rsh", so i will need to know the machine
and username that you will be logged on as when you want to issue CVS commands.
The above should create a directory called "nexus" containing all the files.
You are then free to modify the files - they are a local copy, and will
not change the central store until you do a commit. Some useful commands
to type from within the created "nexus" directory are:

cvs update	# update all files with any recent modifications from server
cvs update napi.c # just update nexus.c, or get it back if you deleted it
cvs diff napi.c # show your modifications to napi.c
cvs commit napi.c # put your modified file onto the central server, after
                  # first invoking an editor to ask you for a log message 
                  # The editor used is either "vi" or the one specified by the
                  # CVSEDITOR environment variable. The message you enter
                  # will be mailed to all on the "napi" list and will 
                  # appear in the log file that is visible on the WWW or
                  # via "cvs log" for that file
cvs log napi.c # print all log messages for napi.c
cvs status napi.c # show the current version number of napi.c
cvs add newfile.c # Provisionally add a new file to the distribution - it
                  # will not be truely added until a "cvs commit"

Other commands are detailed in the manual that comes with CVS. Once a
file is commited, it will be available for download via the WWW page
at http://sutekh.nd.rl.ac.uk/NeXus

I'm out next week, but Chris (cmm at isise.rl.ac.uk) knows all about CVS
and will be able to help if there are any problems

Freddie

-- 
Freddie Akeroyd                        Email:  faa at isise.rl.ac.uk
ISIS Facility                          Tel:    +44 1235 445457   
Rutherford Appleton Laboratory         Fax:    +44 1235 445720   
Chilton,   DIDCOT,   OX11 OQX          WWW:    http://www.isis.rl.ac.uk/