Using CVS for writing burst upper limit papers

• Identify the local directory where you wish to store the papers and change into that directory. Here, I use /home/patrick/papers as that directory:
  
        cd /home/patrick/papers
  
  
• Getting the files Log in by typing the following line where anonymous is replaced by your username:
  
        cvs -d :pserver:anonymous@gravity.phys.uwm.edu:/usr/local/cvs/lscdocs login
  
  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:anonymous@gravity.phys.uwm.edu:/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:
  
        cd bulgroup/2002trigger01/
  
  You will see two files (Makefile and trigger.tex) and a directory (CVS). You need not worry about the CVS directory. Simply type:
  
        make
  
  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.
  
        vi trigger.tex
  
  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:
  
        cvs update
  
  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 figure.ps. Type:
  
        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