summaryrefslogtreecommitdiff
path: root/Build/source/texk/dvipos/dvipos.1
blob: 477fdcec7bfa7e2e70bd710a14dd2898c22f3036 (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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
.TH "DVIPOS" "1" "January 2007" "dvipos 20030628 (KPATHSEA)" "ConTeXt"
.de URL
\\$2 \(laURL: \\$1 \(ra\\$3
..
.if \n[.g] .mso www.tmac
.de EX
.in +3
.nf
.ft CW
..
.de EE
.in -3
.ft R
.fi
..

.SH NAME
dvipos \- compute positions in a DVI file

.SH SYNOPSIS
\fBdvipos\fP [ \fIOPTION\fP... ] \fIinfile[.dvi]\fP

.SH DESCRIPTION
\fBdvipos\fP parses a DVI file looking for \fIpos:\fP specials.  It
currently recognizes \fIpos:pxy\fP, \fIpos:pxywhd\fP,
\fIpos:pxyplus\fP, \fIpos:begbox\fP, \fIpos:endbox\fP,
\fIpos:beglines\fP, and \fIpos:endlines\fP.  It then outputs the
information from those specials along with information that only a DVI
postprocessor could determine, such as the current \fIx\fP and \fIy\fP
location.  The output looks like:
.EX
\\pospxywhd{text:54}{54}{10663sp}{8535sp}{21326sp}{34081sp}{0sp}
.EE
and is suitable for including in a 
.BR tex (1)
or
.BR pdftex (1)
auxilliary file, such as \fIdocument.tuo\fP, to be read in on the next run.

.SH OPTIONS

.TP
\fB-h, --help\fR
print usage.
.TP
\fB-W, --warning\fR
print warnings.
.TP
\fB-v, --verbose\fR
print verbose output.
.TP
\fB-d, --debug\fR
print 
.BR dvitype (1)
debugging data.
.TP
\fB-s, --smashchars\fR
regard height and depth as zero.
.TP
\fB-o, --output=\fIFILE\fR
send all output to FILE.  Without this option, output goes to stdout.
.TP
\fB-b, --bbox[=\fP\fIFILE\fP]\fR
send bounding box to FILE (default FILE is \fIinfile.pos\fP).
.TP
\fB-f, --framed[=\fP\fIBASE\fP]\fR
request copy of DVI file, \fIBASE.dvi\fP, with bounding boxes
\fBframed\fP (default FILE is \fIinfile_frames.dvi\fP).  See the
\fB--framesize\fP option.
.TP
\fB-m, --mag=\fIINT\fR
override 
.BR tex (1)
magnification by INT.
.TP
\fB-w, --framesize=\fIINT\fR
set frame rule size by INT (default 6554 = .1pt).
.TP
\fB-p, --pages=\fIX:Y\fR
set page ranges from X to Y.

.SH USAGE
.B dvipos
is run mostly by ConTeXt's
.BR texexec (1)
between runs of 
.BR tex (1)
or
.BR pdftex (1),
in order to compute positions for the metafun interface to
.BR mpost (1).
A typical use:
.EX
dvipos notes.dvi
.EE
The position information that is output is collected by
.BR texexec (1)
to include in the \fInotes.tuo\fP auxilliary file for the next run
to use.

.SH EXAMPLES
.TP
Extract positions from \fIdoc.dvi\fP, with output to \fIdoc.loc\fP:
\f(CWdvipos -o doc.loc doc.dvi\fP
.TP
Same as above, but also send bbox information to \fIdoc.pos\fP:
\f(CWdvipos -b -o doc.loc doc.dvi\fP
.TP
Instead send bbox information to \fI/tmp/debug.pos\fP:
\f(CWdvipos -b=/tmp/debug.pos -o doc.loc doc.dvi\fP

.SH "SEE ALSO"
.BR dvips (1),
.BR dvitype (1),
.BR mpost (1),
.BR pdftex (1),
.BR tex (1),
.BR texexec (1).

.SH BUGS
If you specify a file for the \fB-b\fP option, you must join the
option and name with rather than (the more common) space:
.EX
dvipos -b=/tmp/debug.pos notes.dvi
.EE
works, but
.EX
dvipos -b /tmp/debug.pos notes.dvi
.EE
does not.

.SH AUTHOR
.B dvipos
is written by Jin-Hwan Cho <chofchof@ktug.or.kr>.  It is free
software (GPLv2 or later).  This manpage was written by Sanjoy
Mahajan <sanjoy@mit.edu> and is in the public domain.