summaryrefslogtreecommitdiff
path: root/dviware/umddvi/man/iptex.1
diff options
context:
space:
mode:
Diffstat (limited to 'dviware/umddvi/man/iptex.1')
-rw-r--r--dviware/umddvi/man/iptex.1126
1 files changed, 126 insertions, 0 deletions
diff --git a/dviware/umddvi/man/iptex.1 b/dviware/umddvi/man/iptex.1
new file mode 100644
index 0000000000..5af0c74d31
--- /dev/null
+++ b/dviware/umddvi/man/iptex.1
@@ -0,0 +1,126 @@
+.TH IPTEX 1
+.SH NAME
+iptex \- print DVI files on the Imagen
+.SH SYNOPSIS
+.B iptex
+[
+.B \-c
+] [
+.B \-d
+.I maxdrift
+] [
+.B \-l
+] [
+.B \-m
+.I magnification
+] [
+.B \-p
+] [
+.B \-r
+.I resolution
+] [
+.B \-s
+] [
+.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
+.I \-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
+.I \-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, 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
+.I \-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 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 ipr with the
+.I \-c
+flag.
+.PP
+The
+.I maxdrift
+parameter controls
+.BR iptex 's
+behaviour under certain obscure conditions. Because it is so rarely
+needed, and because 2 is such a wonderful default, I am not going to
+tell you exactly what it really does. (Besides, I have not yet
+figured out how to describe it.)
+.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
+ipr - Imagen spooler
+.SH "SEE ALSO"
+dvipr(1), dviselect(1), tex(1)
+.SH BUGS
+.I Still
+needs to handle more ``\especial''s.