Download MetaPost: A User`s Manual

B.2.2
The dvitomp Program
The dvitomp program converts DVI files into low-level MetaPost code. MetaPost uses the dvitomp
program when typesetting btex/etex labels by TEX for the final conversion back into MetaPost
code. The command-line syntax of the executable is
[︀
]︀
[︀
]︀
dvitomp ⟨switches⟩ ⟨infile⟩ ⟨outfile⟩
Parameters ⟨switches⟩ and ⟨outfile⟩ are optional.
⟨infile⟩ This is the name of the DVI file to convert. If the name doesn’t end with .dvi, that
extension is appended. Note, dvitomp never opens files not ending .dvi. This file is in general
automatically generated by TEX or troff, driven by MetaPost.
⟨outfile⟩ This is the name of the output file containing the MetaPost code equivalent to ⟨infile⟩. If
⟨outfile⟩ is not given, ⟨outfile⟩ is ⟨infile⟩ with the extension .dvi replaced by .mpx. If ⟨outfile⟩
is given and doesn’t end with .mpx, that extension is appended.
⟨switches⟩ Command-line switches can be prefixed by one or two dashes. Both forms have the same
meaning. The following command-line switches are provided by dvitomp:
-help
Show help on command-line switches.
-kpathsea-debug=⟨number⟩
Set debugging flags for path searching.
-progname=⟨string⟩
Pretend to be the ⟨string⟩ executable.
-version
Print version information and exit.
The dvitomp program used to be part of a set of external tools, called mpware 14 , which were used
by MetaPost for processing btex/etex labels. Since MetaPost version 1.100, the label conversion is
handled internally by the mpost program. The mpware tools are therefore obsolete and no longer
part of the MetaPost distribution. Nowadays, dvitomp is either a copy of the mpost executable with
the name dvitomp or a wrapper, calling mpost as
mpost -dvitomp ⟨infile⟩ ⟨outfile⟩
14 makempx,
mpto, dvitomp, and dmp.
99