summaryrefslogtreecommitdiff
path: root/dviware/ivd2dvi/ivd2dvi.1
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /dviware/ivd2dvi/ivd2dvi.1
Initial commit
Diffstat (limited to 'dviware/ivd2dvi/ivd2dvi.1')
-rw-r--r--dviware/ivd2dvi/ivd2dvi.189
1 files changed, 89 insertions, 0 deletions
diff --git a/dviware/ivd2dvi/ivd2dvi.1 b/dviware/ivd2dvi/ivd2dvi.1
new file mode 100644
index 0000000000..d8231be19c
--- /dev/null
+++ b/dviware/ivd2dvi/ivd2dvi.1
@@ -0,0 +1,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.