Debian Codegraph @

texmf-dist/doc/man/man1/dvi2tty.1

raw
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.