| 1 |
.TH DVI2TTY 1 "1 May 2022" |
| 2 |
.SH NAME |
| 3 |
dvi2tty \- preview a TeX DVI file on an ordinary ASCII terminal |
| 4 |
.SH SYNOPSIS |
| 5 |
.B dvi2tty |
| 6 |
[ options ] dvifile |
| 7 |
.SH DESCRIPTION |
| 8 |
.I dvi2tty |
| 9 |
converts a TeX DVI file to a format that is appropriate for terminals |
| 10 |
and line printers. The program is intended to be used for |
| 11 |
preliminary proofreading of TeX-ed documents. |
| 12 |
By default the output is directed to the terminal, |
| 13 |
possibly through a pager (depending on how the program was installed), |
| 14 |
but it can be directed to a file or a pipe. |
| 15 |
.PP |
| 16 |
The output leaves much to be desired, but is still |
| 17 |
useful if you want to avoid walking to the |
| 18 |
laser printer (or whatever) for each iteration of your |
| 19 |
document. |
| 20 |
.br |
| 21 |
Since |
| 22 |
.I dvi2tty |
| 23 |
produces output for terminals and line printers the |
| 24 |
representation of documents is naturally quite primitive. |
| 25 |
In principle font changes are totally ignored, but |
| 26 |
.I dvi2tty |
| 27 |
recognizes |
| 28 |
a few mathematical and special symbols that can be displayed on an |
| 29 |
ordinary ASCII terminal, such as the '+' and '-' symbol. |
| 30 |
.PP |
| 31 |
If the width of the output text requires more columns than fits |
| 32 |
in one line (cf.\& the -w option) it is broken into several lines by |
| 33 |
.I dvi2tty |
| 34 |
although they will be printed as one line on regular TeX output |
| 35 |
devices (e.g., laser printers). To show that a broken line is really |
| 36 |
just one logical line an asterisk (``*'') in the last position |
| 37 |
means that the logical line is continued on the next physical |
| 38 |
line output by |
| 39 |
.I dvi2tty. |
| 40 |
Such a continuation line is started with a space and an asterisk |
| 41 |
in the first two columns. |
| 42 |
.PP |
| 43 |
Options may be specified in the environment variable DVI2TTY. |
| 44 |
Any option on the command line, conflicting with one in the |
| 45 |
environment, will override the one from the environment. |
| 46 |
.PP |
| 47 |
.B Options: |
| 48 |
.PP |
| 49 |
.TP |
| 50 |
.B -o file |
| 51 |
Write output to file ``file''. |
| 52 |
.TP |
| 53 |
.B -p list |
| 54 |
Print the pages chosen by list. |
| 55 |
Numbers refer to TeX page numbers (known as \ecount0). |
| 56 |
An example of format for list is ``1,3:6,8'' |
| 57 |
to choose pages 1, 3 through 6 and 8. |
| 58 |
Negative numbers can be used exactly as in TeX, |
| 59 |
e.g., \-1 comes before \-4 as in ``-p-1:-4,17''. |
| 60 |
.TP |
| 61 |
.B -P list |
| 62 |
Like -p except that page numbers refer to |
| 63 |
the sequential ordering of the pages in the dvi-file. |
| 64 |
Negative numbers don't make a lot of sense here... |
| 65 |
.TP |
| 66 |
.B -w n |
| 67 |
Specify terminal width |
| 68 |
.I n. |
| 69 |
Valid range 16\(en132. |
| 70 |
Default is 80. If your terminal has the |
| 71 |
ability to display in 132 columns it might |
| 72 |
be a good idea to use -w132 and toggle the |
| 73 |
terminal into this mode as output will |
| 74 |
probably look somewhat better. |
| 75 |
.TP |
| 76 |
.B -v |
| 77 |
Specify height of lines. Default value 450000. Allows one to adjust linespacing. |
| 78 |
.TP |
| 79 |
.B -q |
| 80 |
Don't pipe the output through a pager. |
| 81 |
This may be the default on some systems |
| 82 |
(depending on the whims of the person installing the program). |
| 83 |
.TP |
| 84 |
.B -e n |
| 85 |
This option can be used to influence the spacing between words. |
| 86 |
With a negative value the number of spaces |
| 87 |
between words becomes less, with a positive value it becomes more. |
| 88 |
-e-11 seems to worked well. |
| 89 |
.TP |
| 90 |
.B -f |
| 91 |
Pipe through a pager, $PAGER if defined, or whatever the installer of |
| 92 |
the program compiled |
| 93 |
in (often ``more''). This may be the default, but it is still okay |
| 94 |
to redirect output with ``>'', the pager will not be used if output |
| 95 |
is not going to a terminal. |
| 96 |
.TP |
| 97 |
.B -F |
| 98 |
Specify the pager program to be used. |
| 99 |
This overrides the $PAGER environment variable and the default pager. |
| 100 |
.TP |
| 101 |
.B -Fprog |
| 102 |
Use ``prog'' as program to pipe output into. Can be used to choose an |
| 103 |
alternate pager (e.g., ``-Fless''). |
| 104 |
.TP |
| 105 |
.B -t |
| 106 |
\\tt fonts were used (instead of cm) to produce the dvi file. |
| 107 |
.TP |
| 108 |
.B -a |
| 109 |
Dvi2tty normally tries to output accented characters. With the -a option, |
| 110 |
accented characters are output without the accent sign. |
| 111 |
.TP |
| 112 |
.B -l |
| 113 |
Mark page breaks with the two-character sequence ``^L''. The default is |
| 114 |
to mark them with a form-feed character. |
| 115 |
.TP |
| 116 |
.B -c |
| 117 |
Do not attempt to translate any characters (like the Scandinavian/latin1 mode) |
| 118 |
except when running in tt-font. |
| 119 |
.TP |
| 120 |
.B -u |
| 121 |
Toggle option to process certain latin1 characters. Use this if your output |
| 122 |
devices supports latin1 characters. |
| 123 |
Note this may interfere with -s. Best not to use -u and -s together. |
| 124 |
.TP |
| 125 |
.B -s |
| 126 |
Toggle option to process the special Scandinavian characters that on most (?) |
| 127 |
terminals in Scandinavia are mapped to ``{|}[\e]''. |
| 128 |
Note this may interfere with -u. Best not to use -u and -s together. |
| 129 |
.TP |
| 130 |
.B -J |
| 131 |
Auto detect NTT JTeX, ASCII pTeX, and upTeX dvi format. |
| 132 |
.TP |
| 133 |
.B -N |
| 134 |
Display NTT JTeX dvi. |
| 135 |
.TP |
| 136 |
.B -A |
| 137 |
Display ASCII pTeX dvi. |
| 138 |
.TP |
| 139 |
.B -U |
| 140 |
Display upTeX dvi. |
| 141 |
.TP |
| 142 |
.B -Eenc |
| 143 |
Set output Japanese encoding. The enc argument 'e', 's', 'j', and 'u' |
| 144 |
denotes EUC-JP, Shift_JIS, ISO-2022-JP, and UTF-8, respectively. |
| 145 |
.TP |
| 146 |
.B -bdelim |
| 147 |
Print the name of fonts when switching to it (and ending it). The delim |
| 148 |
argument is used to delimit the fontname. |
| 149 |
.TP |
| 150 |
.B -h |
| 151 |
Show a help massage and exit successfully. |
| 152 |
.SH FILES |
| 153 |
.nr L1 \w'/bin/more \ \ \ \ ' |
| 154 |
/bin/more\h'|\n(L1u'probably the default pager. |
| 155 |
.SH ENVIRONMENT |
| 156 |
.\".nr L1 \w'DVI2TTY ' |
| 157 |
PAGER\h'|\n(L1u'the pager to use. |
| 158 |
.br |
| 159 |
DVI2TTY\h'|\n(L1u'can be set to hold command-line options. |
| 160 |
.SH "SEE ALSO" |
| 161 |
TeX, dvi2ps |
| 162 |
.SH AUTHOR |
| 163 |
Original Pascal version: Svante Lindahl, Royal Institute of Technology, Stockholm |
| 164 |
.br |
| 165 |
Improved C version: Marcel Mol, MESA Consulting |
| 166 |
.br |
| 167 |
Now maintained at https://github.com/t-tk/dvi2tty/releases. |
| 168 |
.SH BUGS |
| 169 |
Blanks between words get lost quite easily. This is less |
| 170 |
likely if you are using a wider output than the default 80. |
| 171 |
.PP |
| 172 |
Only one file may be specified on the command line. |