% -*-LaTeX-*-
% Converted automatically from troff to LaTeX by tr2tex on Wed May 27 19:51:34 1992
% tr2tex was written by Kamal Al-Yahya at Stanford University
% (Kamal%Hanauma@SU-SCORE.ARPA)


\documentstyle[troffman,oldlfont]{article}
\begin{document}
%
% input file: Dvi2tty.1
%
\phead{DVI2TTY}{Local}{13\ November\ 1990}

\shead{NAME}
dvi2tty -- preview a TeX DVI--file on an ordinary ascii terminal
\shead{SYNOPSIS}
{\bf dvi2tty}
[ options ] dvi--file
\shead{DESCRIPTION}
{\it dvi2tty}
converts a TeX DVI--file to a format that is appropriate for terminals
and line printers. The program is intended to be used for
preliminary proofreading of TeX-ed documents.
By default the output is directed to the terminal,
possibly through a pager (depending on how the program was installed),
but it can be directed to a file or a pipe.
\par
The output leaves much to be desired, but is still
useful if you want to avoid walking to the
laser printer (or whatever) for each iteration of your
document.
\nwl
Since
{\it dvi2tty}
produces output for terminals and line printers the
representation of documents is naturally quite primitive.
In principle Font Changes are totally ignored, but
{\it dvi2tty}
recognizes
a few mathematical and special symbols that can be be displayed on an
ordinary ascii terminal, such as the '+' and '-' symbol.
\par
If the width of the output text requires more columns than fits
in one line (c.f. the --w option) it is broken into several lines by
{\it dvi2tty}
although they will be printed as one line on regular TeX output
devices (e.g. laser printers). To show that a broken line is really
just one logical line an asterisk (``*'') in the last position
means that the logical line is continued on the next physical
line output by
{\it dvi2tty.}
Such a continuation line is started with a a space and an asterisk
in the first two columns.
\par
Options may be specified in the environment variable DVI2TTY.
Any option on the command line, conflicting with one in the
environment, will override the one from the environment.
\par
{\bf Options:}
\par
\begin{TPlist}{{\bf --o} file}
\item[{{\bf --o} file}]
Write output to file ``file''.
\item[{{\bf --p} list}]
Print the pages chosen by list.
Numbers refer to TeX--page numbers (known as \bs count0).
An example of format for list is ``1,3:6,8''
to choose pages 1, 3 through 6 and 8.
Negative numbers can be used exactly as in TeX,
e g --1 comes before --4 as in ``--p--1:--4,17''.
\item[{{\bf --P} list}]
Like --p except that page numbers refer to
the sequential ordering of the pages in the dvi--file.
Negative numbers don't make a lot of sense here...
\item[{{\bf --w} n}]
Specify terminal width
{\it n.}
Legal range 16--132.
Default is 80. If your terminal has the
ability to display in 132 columns it might
be a good idea to use --w132 and toggle the
terminal into this mode as output will
probably look somewhat better.
\item[{{\bf --v}}]
Specify height of lines. Default value 450000. Allows to adjust linespacing.
\item[{{\bf --q}}]
Don't pipe the output through a pager.
This may be the default on some systems
(depending on the whims of the person installing the program).
\item[{{\bf --e} n}]
This option can be used to influence the spacing between words.
With a negative value the number of spaces 
between words becomes less, with a positive value it becomes more.
--e--11 seems to worked well.
\item[{{\bf --f}}]
Pipe through a pager, \$PAGER if defined, or whatever the installer of
the program compiled
in (often ``more''). This may be the default, but it is still okay
to redirect output with ``$>$'', the pager will not be used if output
is not going to a terminal.
\item[{{\bf --F}}]
Specify the pager program to be used.
This overrides the \$PAGER and the default pager.
\item[{{\bf --Fprog}}]
Use ``prog'' as program to pipe output into. Can be used to choose an
alternate pager (e g ``-Fless'').
\item[{{\bf --t}}]
\bs tt fonts were used (instead of cm) to produce dvi file. (screen.sty
is a powerfull mean to do that with LaTeX).
\item[{{\bf --a}}]
Dvi2tty normally tries to output accented characters. With the -a option,
accented characters are output without the accent sign.
\item[{{\bf --l}}]
Mark page breaks with the two-character sequence ``\^{}L''. The default is
to mark them with a form-feed character.
\item[{{\bf --u}}]
Don't make any attempts to find special Scandinavian characters.
If such characters are in the text they will map to ``a'' and ``o''.
This is probably the default outside of Scandinavia. (The installer
makes this decision when  the program is installed.)
\item[{{\bf --s}}]
Try to find the special Scandinavian characters that on most (?)
terminals in Scandinavia are mapped to ``\{$|$\}[\bs ]''.
This can be the default, and output from files not containing these
special characters will be identical regardless of this option.
\end{TPlist}
\shead{FILES}
/usr/ucb/more \ \ \ \ 
probably the default pager.
\shead{ENVIRONMENT}
PAGER \ \ \ \ \ \ \ \ \ \ \ \ 
the pager to use.
\nwl
DVI2TTY \ \ \ \ \ \ \ \ \ \ \ 
can be set to hold command-line options.
\shead{SEE ALSO}
TeX, dvi2ps
\shead{AUTHOR}
Svante Lindahl, Royal Institute of Technology, Stockholm
\nwl
Improved C version: Marcel Mol
\nwl
\{seismo, mcvax\}!enea!ttds!zap
\nwl
marcel@duteca.et.tudelft.nl
\shead{BUGS}
Blanks between words get lost quite easy. This is less
likely if you are using a wider output than the default 80.
\par
Only one file may be specified on the command line.

\end{document}