⟦39e1409df⟧

TextFile

.TH IPTEX 1
.SH NAME
iptex \- print DVI files on the Imagen
.SH SYNOPSIS
.\" number register Q should be 1 for MDQS, 0 for Imagen
.nr Q 1
.B iptex
[
.B \-clpsg
] [
.B \-d
.I maxdrift
] [
.B \-m
.I magnification
] [
.if \nQ \{\
.B \-q
.I queue
] [
.\}
.B \-r
.I resolution
] [
.B \-X
.I x-offset
] [
.B \-Y
.I y-offset
]
.I filename
.SH DESCRIPTION
.I Iptex
takes a DVI file produced by TeX and converts it to a format suitable
for the Imagen series printers.
.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 iptex
produces output for
a 300 dpi printer (the 8/300) but this may be overridden with the
.B \-r
flag:
.B "\-r 240"
produces output suitable for the Imprint-10 (a.k.a. the 10/240).
.PP
To get landscape mode (rather than portrait mode) output, use the
.B \-l
flag.  However, this has not been extensively tested.
.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
The 
.B \-g
flag enables processing of 
.I SPEC
graphics commands.  For more information see
.IR spec (7)
and the paper
.ie n .I "SPEC -- A TeX-Embedded Graphics Typesetting Language"
.el .I "SPEC\(emA TeX-Embedded Graphics Typesetting Language"
by Jiang-Hsing Chu and Gary Knott.
.PP
Normally, iptex will print the page number of each page (actually
the value in \\count0) as it runs, to demonstrate its blinding speed.
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 Iptex
is actually a shell script that invokes the conversion program and
feeds its output to
.ie \nQ \{\
MDQS's
.I qpr
.\}
.el \{\
Imagen's
.I ipr
.\}
command.  Normally this is done by creating a file in $TMPDIR
(default /tmp), so that missing fonts can be caught before ipr
runs away with the output.  However, if desired, you can force
the output to be piped directly to qpr with the
.B \-c
flag.
.if \nQ \{\
A particular queue can be specified via the
.B \-q
flag; if no queue is given,
.I iptex
uses the value of the environment variable
.I IPTEXQ
(see
.IR sh (1)
and/or
.IR csh (1)
for environment-setting commands).
If neither -q nor an
.I IPTEXQ
is specified,
.I iptex
will complain, and either stop, or use a system default.
.\}
.PP
The
.I maxdrift
parameter controls
.BR iptex 's
behaviour under certain obscure conditions,
as described in the MC-TeX Guide.
.PP
There are three options that are normally only useful to people installing
.I iptex
which are quickly summarized here:
.B \-p
prevents page reversal (useful with the Ricoh engine);
.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 tenths of an inch
and may be negative.  Default offsets should be set in the
.I iptex
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 AUTHOR
Chris Torek, University of Maryland
.br
Mike Urban (TRW) added the \-p, \-X, and \-Y options.
.SH FILES
imagen1 - conversion program
.br
.ie \nQ qpr - output spooler
.el ipr - Imagen spooler
.SH "SEE ALSO"
dviconcat(1), dviselect(1), latex(1), tex(1), spec(7)
.br
.I "MC-TeX User's Guide"
.SH BUGS
.I Still
needs to handle more ``\especial''s.
DataMuseum.dk

DKUUG/EUUG Conference tapes

⟦39e1409df⟧ TextFile

Derivation

TextFile
