summaryrefslogtreecommitdiff
path: root/dviware/ivd2dvi/doc
blob: dd23d74471a0ff9642dce75221abdccd132c2ac3 (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
NAME
     ivd2dvi  -  convert a dvi-ivd file to a normal dvi file

SYNOPSIS
     ivd2dvi [-Xv] [-b buffersize] [filename]

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.  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 processed is specified on the command line;
     if the named file cannot be found and contains no period following
     its rightmost slash, ".dvi" is appended and ivd2dvi tries again.
     Unlike most dvi processors, ivd2dvi is a true filter and reads its
     standard input if no file is specified.  The dvi file produced by
     ivd2dvi is written to standard output.

     Since dvitype says only "unrecognized command!" about the reflection
     commands found in dvi-ivd files, ivd2dvi also performs careful error
     checking for proper use of these commands.

OPTIONS
     -v   Verbose mode.  The number of each page is printed as it is 
          processed.

     -b newbuffersize
          Change the size of ivd2dvi's buffers.  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.  The default buffer size is 1024.

     -X   Exact mode.  In this mode, 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 ivd2dvi will substitute
          the exact value).  As a result, dvi files with no reflection
          commands are more likely to emerge totally unchanged.  Use of
          this flag is discouraged except for debugging.

ENVIRONMENT
     TEXFONTS
          Colon-separated list of directories to be searched for font
          metric files.  The default is /usr/lib/tex/fonts.

FILES
     /usr/lib/tex/fonts/*.tfm        Font metric files.

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.

AUTHOR
     Larry Denenberg, larry@bbn.com or larry@harvard.edu.