
How to create a LaTeX document (quick start)
===============================

Author: GZ (Gabriel.Zachmann@gmx.net)

For absolute newbies who want to 'latex' the example.tex file.
I assume a Unix environment and some basic knowledge about it.

1)   cd example [important to make the following 'source' work!]
     source tex-so

     You have to do this first step (1) only once!
	 For regular use, you will need to edit some paths in
	 tex-so and texmf.cnf!

2)   Do a first typesetting with the comand
     latex example

     There will be warnings about unresolved references and missing pictures.

3)   Create the eps/eepic files of the drawing and snapshots with
	 gmake -f Makefile-Fig
	 gmake -f Makefile-Img

	 These are two makefiles that come with this latex "example" directory.
	 You need the programs 'xfig', 'convert', and 'jpeg2ps'.
	 They are explained more in example.tex.
	 If you don't have them, the .eps/.jpg files are included in
	 example.{zip,tar.gz}.

4)   Preview the document with
     xdvi example

	 You can keep the previewer 'xdvi' open if you intend to run 'latex'
	 several times. Type 'R' in the xdvi window to reload the preview.

5)   Create the bibliography with
     bibtex example
	 latex example
	 latex example

     Usually, you have to do this only once near the finish of the document.
	 You need to do it every time you added more \cite commands;
	 in that case: 'latex' the doc once, then run bibtex, then latex twice.

6)   For creating the final document, run 'latex example'
	 until there is no warning like
		 "Label(s) may have changed"
     at the end of LaTeX's output.

7)   Create the postscript document with
     dvips example

8)   Preview the .ps file with
     gv example.ps (or ghostview)

8)   lpr ...


An example LaTeX source is in  example.tex
It also explains about creating drawings and converting
drawings and snapshots to eps (something LaTeX can include).

Of course, you will usually keep you .sty files in a separate subdirectory.
And, likewise, you'll put the snapshots, fig files, and eps files
in separate subdirectories under each document's directory, respectively.

