To use the AutoMed CVS repository as a developerof the repository code, you must have a CSG account, and be a member of the automed group. You may then acceess the repository on any CSG linux machine. You may also access the repository remotely. For remote access it is suggested that you use one of the compute servers cpu1.doc.ic.ac.uk, cpu2.doc.ic.ac.uk, or cpu3.doc.ic.ac.uk. You need to set the CVS environment variables appropriately; for example (replacing username with your login):
CVSROOT=":ext:username@shell2.doc.ic.ac.uk:/vol/automed/cvsroot/"
CVS_RSH="ssh"
For each update you wish to make to the repository, you should (assuming the you have you AutoMed code in ~automed):
Move to the root of the AutoMed distribution
cd ~automed
Merge in any updates that have occurred recently, the -R option ensuring that you obtain any new directories
cvs update -d
Move to the reps package, and completely rebuild the code, fixing any errors that you find in the compilation.
cd ~automed/java/src/uk/ac/ic/doc/automed/reps
make clean
make
Check that the code still works. At the very least do the following, and ensuring the three schemas are integrated in the basic example:
cd ~automed/java/examples
make basic
Once all is working correctly, commit your changes to the repository. This may be done by:
cd ~automed
cvs commit
Enter comments on your changes when prompted.
If you have created any new packages or files, you need to add these explicitly. For example if a new package uk.ac.doc.ic.automed.demo and class uk.ac.doc.ic.automed.demo.Demo where to be added, then:
cd ~automed/java/src/uk/ac/ic/doc/automed/
cvs add demo
cvs commit demo
cd demo
cvs add Demo.java
cvs commit Demo.java
You can check which machine is being used for your repository by executing the command from the root directory of the checked out code:
find . -name Root -type f -exec cat '{}' \;
To change the name of the machine, say from shell1
to
cvsuser
, you should execute:
find . -name Root -type f -exec sed -i 's/shell1/cvsuser/g' '{}' \;
Note that users within DoC are recommended to use cvsuser
as the name of the CVS repository machine.
To generate a postscript file for mydoc, use
dvips -ta4 mydoc -o mydoc.ps
To generate a PDF file for mydoc, use
dvips -ta4 -Ppdf mydoc -o mydoc_pdf.ps
ps2pdf mydoc_pdf.ps mydoc.pdf