next up previous
Next: Running latex2html Up: RUNNING LATEX, LATEX2HTML & Previous: RUNNING LATEX, LATEX2HTML &


Running LaTeX

Once one has written the LaTeX 'source-code' into a file (say called yourfile.tex), then LaTeX is run by:

latex yourfile.tex
(the .tex extension can be left off if there is only one period in the filename). LaTeX will dump various pieces of information during the run, along with any error or warning messages.

Errors will cause LaTeX to stop with a ? prompt along with some information regarding the nature of the error. Errors are usually the result of typographical errors in the *.tex file. One has a number of options when faced with the ? prompt (which can be listed by typing ? ? prompt) including getting a limited about of further help (h), skipping to be next error (s), quiting LaTeX (x), or editing your *.tex file (e). Further ionformation on the causes and solutions to errors is beyond the scope of this memo, but can be found in the LaTeX User's Guide & Reference Manual (paperback; ISBN 0-202-15790-X) by Leslie Lamport (Addison-Wesley Publishing Company).

Warnings are usually straighforward and are related to either the fact that LaTeX should be run again, or that something is missing or multiply defined. Again consultation of the LaTeX User's Guide & Reference Manual is advised. if the messages aren't 'obvious'. NOTE: Warning messages concerning undefined references will ALWAYS to produced on the initial LaTeX run of a document making use of the automatic cross-referencing facilities (see Section 5.1).

Assuming successful completion, LaTeX will produce several files in the local directory with the yourfile root. Probably the most inportant is the *.dvi file (ie yourfile.dvi in the above example) which serves as the input to several associated software tasks (see the following sections). The other files produced depend somewhat in which features of LaTeX are used in the *.tex file. For example a *.toc is (only) produced if the LaTeX command \tableofcontents is included in the *.tex file. Most of these files are ASCII and can be inspected. Unless you are an expert, we'd recommend NOT deleting any of the files produced by a successful LaTeX run since many are also required by the associated software such as those listed in the following sections.


next up previous
Next: Running latex2html Up: RUNNING LATEX, LATEX2HTML & Previous: RUNNING LATEX, LATEX2HTML &
Mike Corcoran 2002-02-15