This directory contains a makefile for building documents with LaTeX

INSTALLATION
""""""""""""

1. Put latex_make.mak in some place on your system (say, 
   ~/share/latex_make.mak)
   
2. Optionally, put set_makefile in a directory in your PATH.

SETTING UP A "PROJECT"
""""""""""""""""""""""
1. Create a new LaTeX document, sat doc.tex and place it in some 
   directory

2. Create doc.mak in the same directory using sample.mak and
   latex_make.mak for reference.
   
   Alternatively, use:
   
     make -f path/to/latex_make.mak vars >doc.mak

   you should edit the value of DOCUMENT, and maybe uncomment some other
   variables.

3. run 'set_makefile doc'

USAGE
"""""
'make help' for usage instructions. The basics are:
 
- make: updates the default target (by default - dvi)
- make view: view the dvi file (create it, if necessary)
- make ps: create a postscript copy
- make tgz: pack sources to a tarball
- make copy: copy some selected targets to a (possibly) remote
             directory

You can have multiple projects in the same directory. Only one of them 
can be 'active' (be the one symlinked by Makefile). You can change 
active project using 'set_makefile' or explicitly use 'make -f doc.mak'
instead of 'make' .

Troubleshooting
"""""""""""""""
1. grab a rifle
2. aim
3. shoot

That asiade, the makefile will only work with GNU make (gmake) and not with
BSD make. If your default 'make' is not GNU make, you will get a strange error
message (probably because of the 'ifdefs'). 
use 'gmake'

Another problem is that if you run 'make' nad 'latex fails in the middle, but
still outputs an incomplete DVI file, the next time you run 'make', you will
get "nothing to do for 'all'".
In that case use either 'make clean' to delete the created DVI file (although 
it is a bit dangerous) or 'make latex' a couple of times.

Also be warned that VARS_DESCRIPTION is quite sensitive to changes. After
modifying it, always make sure that it still works. For instance, you can
forget to quote ('\') a '#' character and get a wierd error message.

