summaryrefslogtreecommitdiff
path: root/dviware/ivd2dvi/doc
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/doc
Initial commit
Diffstat (limited to 'dviware/ivd2dvi/doc')
-rw-r--r--dviware/ivd2dvi/doc60
1 files changed, 60 insertions, 0 deletions
diff --git a/dviware/ivd2dvi/doc b/dviware/ivd2dvi/doc
new file mode 100644
index 0000000000..dd23d74471
--- /dev/null
+++ b/dviware/ivd2dvi/doc
@@ -0,0 +1,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.