DataMuseum.dk

top - metrics - download

    Length: 4102 (0x1006)
    Types: TextFile
    Names: »pstex.1«

└─⟦52210d11f⟧ Bits:30007239 EUUGD2: TeX 3 1992-12
    └─⟦af5ba6c8e⟧ »unix3.0/DVIWARE.tar.Z« 
        └─⟦ca79c7339⟧ 
            └─⟦this⟧ »DVIware/laser-setters/mctex/postscript/pstex.1« 

TextFile

.TH PSTEX 1
.SH NAME
pstex \- print DVI files on a Postscript printer
.SH SYNOPSIS
.\" number register Q should be 1 for MDQS, 0 for lpr
.nr Q 1
.B pstex
[
.B \-clpsN
] [
.B \-d
.I maxdrift
] [
.B \-m
.I magnification
] [
.B \-o
.I document-option
] [
.B \-I
.I prologue
] [
.B \-L
.I dir
] [
.ie \nQ \{\
.B \-q
.I queue
\}
.el \{
.B \-P
.I printer
.\}
] [
.B \-r
.I resolution
] [
.B \-X
.I x-offset
] [
.B \-Y
.I y-offset
]
.I filename
.SH DESCRIPTION
.I Pstex
takes a DVI file produced by TeX and converts it to a format suitable
for Postscript printers, particularly the Apple LaserWriter.
.I filename
should be the name of a
.B .dvi
file, or ``\-'' for standard input (useful for reading the output
of the
.I dviselect
program).  By default,
.I pstex
produces output for
a 300 dpi printer.  This may be overridden with the
.B \-r
flag.
.PP
To get landscape mode (rather than portrait mode) output, use the
.B landscape
document option:
.BR "\-o landscape" .
Other document options may also be available;
see the MC-TeX User's Guide and your Local Guide for details.
.PP
The
.B \-m
flag applies a global magnification to the output.  If you have slides
that are to be reduced, you can fiddle with the output size using \-m.
(By the way, \-r is really \-m in disguise.)
.PP
Normally, 
.I pstex
will print the page number of each page (actually
the value in \ecount0) as it runs.
If this is not desired, use the
.B \-s
option to suppress unnecessary verbiage.  (And yes, it really
.I is
supposed to count down from the last page.)
.PP
.I Pstex
is actually a shell script that invokes the conversion program and
feeds its output to
.ie \nQ \{\
MDQS's
.I qpr
.\}
.el \{\
the
.I lpr
.\}
command.  Normally this is done by creating a file in $TMPDIR
(default /tmp), so that missing fonts can be caught before 
.ie \nQ .I qpr
.el .I lpr
runs away with the output.  However, if desired, you can force
the output to be piped directly to 
.ie \nQ .I qpr
.el .I lpr
with the
.B \-c
flag.
.ie \nQ \{\
A particular queue can be specified via the
.B \-q
flag; if no queue is given,
.I pstex
uses the value of the environment variable
.I PS
(see
.IR sh (1)
and/or
.IR csh (1)
for environment-setting commands).
If neither -q nor an
.I PS
is specified,
.I pstex
will complain, and either stop, or use a system default.
.\}
.el \{
A particular printer can be specified via the
.B \-P
flag.
.\}
.PP
The
.I maxdrift
parameter controls the behaviour of 
.I pstex 
under certain obscure conditions,
as described in the MC-TeX Guide.
.PP
The
.BR \-I ,
.BR \-L ,
and
.B \-N
flags control which prologue files are loaded,
as described in the MC-TeX Guide.
Most people will use only the
.B \-I
option,
which adds a request for a particular prologue.
.PP
There are three options that are normally only useful to people installing
.I pstex
which are quickly summarized here:
.B \-p
prevents page reversal (useful with some engines);
.B \-X
and
.B \-Y
set an offset to apply to every page (useful with the LBP-10, for
example, where output starts a few tenths of an inch away from the upper
left hand corner of the page).  The offsets are in thousandths of an inch
and may be negative.  Default offsets should be set in the
.I Pstex
shell script; they will be overridden by explicit
.B \-X
and
.B \-Y
arguments.
.SH DIAGNOSTICS
Most of these should be self explanatory.  The message ``unable to
copy input to temp file'' should only occur when reading standard
input, and indicates that the temporary file required when reading
pipes is too large for wherever it is being stored.  The environment
variable ``TMPDIR'' defines which file system is used for this
temporary file; the default is /tmp.  Either put the intermediate DVI
file in a real disk file, or set TMPDIR, in such cases.
.SH AUTHORS
Louis Mamakos, University of Maryland
.br
Chris Torek, University of Maryland
.SH FILES
postscript - conversion program
.br
.ie \nQ qpr - output spooler
.el lpr - line printer spooler
.SH "SEE ALSO"
dviconcat(1), dviselect(1), latex(1), tex(1)
.br
.I "MC-TeX User's Guide"
.SH BUGS
.I Still
needs to handle more ``\especial''s.