summaryrefslogtreecommitdiff
path: root/dviware/ivd2dvi/ivd2dvi.1
blob: d8231be19c914a1c662cfa849c433bf8dfadfc12 (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
.TH IVD2DVI 1 "31 August 1988"
.SH NAME
ivd2dvi \- convert a dvi-ivd file to a standard dvi file
 
.SH SYNOPSIS
.B ivd2dvi
[\-Xvcb]
.RI [ filename ]
 
.SH DESCRIPTION
An extension to TeX called TeX-XeT produces ``dvi-ivd'' files, which
are similar to dvi files but include nonstandard commands calling
for the ``reflection'' (horizontal reversal) of text.  In general,
dvi-ivd files cannot be processed by standard dvi drivers because
the reflection commands are not recognized.
.I ivd2dvi
converts a
dvi-ivd file to an equivalent dvi file, that is, to a file in which
the necessary reflections are carried out using only standard dvi
commands.  The resulting file can be processed by any dvi driver.
 
The dvi-ivd file to be translated is specified on the command line;
if the file cannot be found and its name contains no period following
the rightmost slash, ``.dvi'' is appended and
.I ivd2dvi
tries again.
Unlike most dvi processors,
.I ivd2dvi
is a true filter and reads its
standard input if no file is specified.  The dvi file produced by
.I ivd2dvi
is written to standard output.
 
.I ivd2dvi
also performs careful error checking for proper placement
of the reflection commands since
dvitype(1), the dvi-file validation program,
does not understand them.
 
.SH OPTIONS
.IP \-v
Verbose mode.
.IP \-c
Error checking only.  Report if reflection commands are misused
in the input file (or if the input file is malformed in some other
way detectable by
.I ivd2dvi)
but produce no other output.
.IP \-b
Double the size of
.IR ivd2dvi 's
buffers. 
.I ivd2dvi
uses several
internal buffers and cannot proceed if any overflows.  When this
happens, you should try again using \-b to increase the buffer
size.  This flag can be used more than once, but probably
will never be needed
(since the default buffers are plenty big).
.IP \-X
Exact mode.  In this mode,
.I ivd2dvi
attempts to process the input
file without modification.  The comment string is not updated,
NOP commands are retained, and the maximum stack depth is copied
from the input file if possible (this number is conservatively
but imprecisely computed by TeX; normally
.I ivd2dvi
will substitute
the exact value).  As a result, dvi files with no reflection
commands will typically emerge unchanged.  Unnecessary except when debugging.
 
.SH ENVIRONMENT
.IP TEXFONTS
Colon-separated list of directories to be searched for font
metric files.  The default is /usr/lib/tex/fonts.
 
.SH FILES
.ta 32
/usr/lib/tex/fonts/*.tfm        Font metric files.
 
.SH SEE ALSO
``Mixing right-to-left texts with left-to-right texts,'' Donald Knuth
and Pierre MacKay, TUGboat volume 8 (1987), number 1, pp. 14\-\-25.
 
dvitype(1)
 
.SH AUTHOR
Larry Denenberg, larry@bbn.com or larry@harvard.edu.