Using CVS for writing burst upper limit papers
The trigger paper has now been added to the CVS repository -- CVS stands for
Concurrent Version-control System which is tool to allow multiple developers
to manipulate the same files, merging differences and identifying
conflicts between changes if they arise. Obtain the Burst Upper Limit
Group (bulgroup) papers from the CVS repository as follows.
Identify the local directory where you wish to store the papers and change
into that directory. Here, I use /home/patrick/papers as
- Getting the files
Log in by typing the following line where anonymous
is replaced by your username:
Your username is as appears in your e-mail
address on the burst group mailing list -- with the exception
that periods have been removed if they were in the names orginally.
This is the same password
as the burst group logbook. Now download the papers:
cvs -d :pserver:firstname.lastname@example.org:/usr/local/cvs/lscdocs co bulgroup
At present, only the trigger paper is in the archive. To see
the tex source and to get dvi and pdf versions:
You will see two files (Makefile and trigger.tex) and a directory
(CVS). You need not worry about the CVS directory. Simply type:
to latex the file and produce both dvi and pdf output. The Makefile
currently uses pdflatex to produce the pdf file.
- Making changes and committing them to the CVS archive.
At the present time, only vicky, lsf5, and saulson have write
priveleges to the archive. Once we get into full swing, I can add as
many users as necessary. Edit the tex source, e.g.
Once you've made your changes and checked that everything latex's ok, you
want to commit the modified file to the CVS repository. To do this, type:
cvs commit trigger.tex
You will be asked to provide a comment for the change log. This does
not need to be detailed, but should give some indication of the work
you were doing.
- Updating your copy with changes made by another person.
To update your entire simply type:
from the .../bulgroup directory. This will download and
merge changes into the files from the repository. If you have been
working on a local copy and your changes conflict with those made by
the other person, you will receive a warning and will need to
manually edit the file to remove the conflicts. It is usually good
practice to update your local copy of the archive before working on the
files; this avoids conflicts. It is also good practice to commit
changes reasonably often.
- Adding postscript or pdf figures To add a postscript of
pdf figure to the archive, first place it in the directory containing
the tex file that needs it. For convenience, let the filename be
cvs add -kb figure.ps
cvs commit figure.ps
The -kb flags are very important. The prevent certain
substitutions from being done by CVS. If you commit postscript or PDF
without these options, let Patrick Brady know and we'll get it fixed.
- Adding tex or text files To add a text file to the archive,
first place it in the appropriate directory. For convenience, let the
filename be myfile.tex. Type:
cvs add myfile.tex
cvs commit myfile.tex