summaryrefslogtreecommitdiff
path: root/dviware/umddvi/man/dvipr.1
blob: 4d1acc7767be1e81eca04c0286aca0ed682510a0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
.TH DVIPR 1
.SH NAME
dvipr \- print dvi version 2 files, produced by TeX82, to the Versatec
.SH SYNOPSIS
.B dvipr
[
.B \-q
] [
.B \-v
] [
.B \-c
] [
.B \-m
.I number
] [
.B \-h
] [
.B \-s
] [
.B \-d
.I number
]
.I .dvi file name
.SH DESCRIPTION
.I dvipr
prints .dvi files produced by
.IR TeX (1)
on the Versatec.  The basic process involves two passes.  In the first
pass, the .dvi file is converted into a list of characters.
The second pass takes this list and prints it onto the Versatec.  When
the
.B \-q
option (for quiescent) is invoked, intermediate output is not spooled
to the Versatec; instead, it is written to the standard output.  The
.B \-v
option (for Versatec) is used to print this intermediate output.
The
.B \-c
option indicates you want to have your output centered on the page.
Otherwise, a default left margin is used.  The
.B \-m
.I number
option is used to change the device magnification (which is in addition to
any magnification defined in the TeX source file).
.I number
should be replaced by an integer which is 1000 times the magnification
you want.
for example,
.B \-m 1315
would produce output magnified to 131.5% of true size.  Using device
magnification is most useful when you are trying to produce a output for
publication.  (Many photocopiers will reduce output to 77% of size.  When you
reduce output printed at 131.5% to 77%, you
get close to the true size.)  The default is
no magnification (1000).  Note, however, that a site will only
support particular magnifications.  If you get error messages indicating that
fonts are missing when using this option, you probably have picked an
unsupported magnification.
.PP
The
.B \-h
flag, when
supplied, causes printing to be done vertically on the page.
This is only useful if you plan to use a reducing copier.
.PP
Normally the first pass prints the page numbers from the .dvi file.  The
.B \-s
flag suppresses these.
.PP
The default
.I maxdrift
parameter is 2 pixels (1/100th of an inch); the
.B \-d
option may be used to alter this.  The
.I maxdrift
parameter determines just how much font spacing is allowed to
influence character positioning.  The value 2 allows a small amount of
variation within words without allowing any letters to become too far
out of position; this had been happening in rare cases before the
.I maxdrift
code was added.
.SH FILES
/usr/local/dvipr
.br
/usr/local/verser1    first pass
.br
/usr/local/verser2    second pass
.SH SEE ALSO
dviselect(1), iptex(1), tex(1)
.SH AUTHOR
The original version was written by Janet Incerpi of Brown University.
Richard Furuta and Carl Binding of the University of Washington
modified the programs for DVI version 2 files.  Chris Torek of
the University of Maryland rewrote
both passes in order to make them run at reasonable speeds.
.SH BUGS