|
|
RiSource.orgthe PIA |
CVS version controlWhat's CVS? CVS is the Concurrent Versions System. Start at Cyclic Software's pages to learn more. Anyone can check out the sources via CVS, while only certain people have the ability to check in. If you don't have check-in ability and want to contribute code send a patch file to pia-dev@RiSource.org or the module owner. (You can also post questions there about becoming a module owner and getting check-in ability.)
Note that one normally starts by checking out a set of source files from a CVS
repository. In our case, we recommend start by downloading and unpacking the tar file from our
site. (You can start with a CVS checkout, but FTP is much faster for getting
the initial set of files and includes pre-made class files and documentation.)
Tar files created after 4/12/1999 contain all of the necessary CVS
information. If you start with a tar file, skip the To use the CVS server, you need to have CVS 1.10 or later. The root repository ($CVSROOT) for our server is: :pserver:anonymous@cvs.risource.org:/home/cvsroot The password (for user anonymous) is anonymous.
You will only need to log into the server once (CVS remembers your password),
after that you can grab all of the latest revisions to the code by doing an
% cd PIA % cvs update -d -P which will produce output like U Agents U Makefile ... After updating the source files, remember to run |
You can find the most recent version of CVS at cyclic.com's Unix pages. You check out as follows. (Syntax is for csh)
% cvs -d :pserver:anonymous@cvs.risource.org:/home/cvsroot login (Logging in to anonymous@cvs.risource.org) CVS password: anonymous (Skip the next line if you already have downloaded the PIA src tree by FTP or HTTP) % cvs -d :pserver:anonymous@cvs.risource.org:/home/cvsroot -z3 checkout PIA cvs server: Updating PIA U PIA/Agents U PIA/LICENSE U PIA/Makefile ...Once you have the PIA directory (through ftp or cvs checkout), the easiest way to get the latest changes is to CD to the PIA directory and run cvs update (CVS files in each directory keep track of the repository location so you don't need to specify it explicitly.)
% cd PIA % cvs update U Agents U Makefile ...Note that if any of the .java files are updated, you will want to run
make in PIA/src/java/ or javac directly to recompile the
corresponding class files.
You only ever need to run
The -z3 parameter is to cause the files (and diffs) to
be compressed while in transit. This is almost always the right thing to
do; so much so that you should probably just put
You must have CVS version 1.10 or newer. Versions 1.9.27 and earlier, including version 1.9, have bugs. In particular, if the cvs process never terminates, you need to upgrade.
You can find a suitably recent version of CVS at cyclic.com's Windows pages.
The checkout procedure is the same as for Unix:
C:\> cvs -d :pserver:anonymous@cvs.risource.org:/home/cvsroot login (Logging in to anonymous@cvs.risource.org) CVS password: anonymous (Skip the next line if you already have downloaded the PIA src tree by FTP or HTTP) C:\> cvs -d :pserver:anonymous@cvs.risource.org:/home/cvsroot -z3 checkout PIA cvs server: Updating PIA U PIA/Agents U PIA/LICENSE U PIA/Makefile ...
Once you have the PIA directory, the easiest way to get the latest changes is to CD to the PIA directory and run cvs update (CVS files in each directory keep track of the repository location so you don't need to specify it explicitly.)
C:\> cd PIA C:\> cvs update U Agents U Makefile ...Note that if any of the .java files are updated, you will want to run
make in PIA/src/java/ or javac directly to recompile the
corresponding class files.
If the -z3 parameter doesn't work, you can try omitting it (or fix your gzip/cvs installation).
You also need to have the HOME environment variable set to a sensible directory, or cvs will complain.
Two CVS options for Macintosh: those are ``MacCVS Pro'' and ``MacCVS.'' Despite the similar names, the two packages are unrelated.
MacCVS Pro is a GUI program, while MacCVS is a command-line program and behaves more like the Unix and Windows CVS clients. See the links above for information on using these packages (or the Mozilla CVS page).