5.2 Processing LaTeX files

NAME qtex - translate a LaTeX file into PostScript

SYNOPSIS

qtex [-dsxgbvc] file[.tex] | lpr
cat file.tex | qtex [-dsxgbvc] | lpr

DESCRIPTION

qtex is a front-end to LaTeX, BibTeX and a dvi to PostScript driver, which makes them considerably easier, and more Unix-like, to use. Unlike LaTeX, it can also process LaTeX files read from the standard input file, or in a Unix pipe. By default, qtex writes PostScript to the standard output file, but there is a command line switch, described below, for generating the usual TeX dvi file instead. The ".tex" file extension is optional. If LaTeX finds an error in your input file, a message will be printed to the standard error file and execution is terminated, with a non-zero exit status. There will be a ".log" file in the same directory as the input file describing the errors.

OPTIONS

-help

If this is the only option, a short message listing all the options available, and their purpose, is printed to the standard out.

-d

Create a TeX device-independent file, i.e. a dvi file, instead of PostScript. This is piped to the standard output file. To save the dvi file, write, for example:

qtex -d foo > foo.dvi

-s

Save all temporary files, such as foo.tex, foo.dvi, and foo.aux. PostScript is generated and written to standard out as usual.

-x

Use this option if the input file contains cross references. This option causes the LaTeX file to be processed by TeX twice, to resolve the references.

-g

Use this option if the document is written in German. It causes TeX to use another algorithm for hyphenation. Remember to also use the german option in the options list of the document itself.

-b

Use this option if the file includes a list of references or bibliography. The option causes LaTeX, then BibTeX and then LaTeX (twice) again to be run. The bibliography referenced in the document is expected to be a BibTeX bib file in the same directory as the document. If your bibliography is being maintained in the biblio SGML format, use the biblio command to first translate it into bib format. The -b option implies the -x option, for cross-references, described above.

-v

Verbose mode. If your document is particularly long, you may want to use this mode to be kept posted about just what qtex is doing at the moment. The messages are written to standard error, so that they are not mixed with the PostScript being piped to the printer!

-c

To process a single chapter or section not containing the necessary LaTeX header (i.e. the \documentstyle and \begin{document} commands), use this option. They will be added to the file before it is processed by TeX This option is necessary when formatting a LaTeX chapter or section generated from SGML using the format command.

SEE ALSO

tex(1), format(1)