diff options
Diffstat (limited to 'Master/texmf/doc/man/man1/dvi2tty.1')
-rw-r--r-- | Master/texmf/doc/man/man1/dvi2tty.1 | 98 |
1 files changed, 66 insertions, 32 deletions
diff --git a/Master/texmf/doc/man/man1/dvi2tty.1 b/Master/texmf/doc/man/man1/dvi2tty.1 index 168a073373d..443308ccd57 100644 --- a/Master/texmf/doc/man/man1/dvi2tty.1 +++ b/Master/texmf/doc/man/man1/dvi2tty.1 @@ -1,36 +1,38 @@ -.TH DVI2TTY Local "7 June 1986" +.TH DVI2TTY 1 "13 November 1990" .SH NAME -dvi2tty \- preview a dvi\-file on an ordinary ascii terminal +dvi2tty \- preview a TeX DVI\-file on an ordinary ascii terminal .SH SYNOPSIS .B dvi2tty [ options ] dvi\-file .SH DESCRIPTION .I dvi2tty -converts a TeX DVI\-file to a format that is apprporiate for terminals -and lineprinters. The program is intended to be used for +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. .PP The output leaves much to be desired, but is still -usefull if you want to avoid walking to the -laserprinter (or whatever) for each iteration of your +useful if you want to avoid walking to the +laser printer (or whatever) for each iteration of your document. .br Since .I dvi2tty -produces output for terminals and lineprinters the +produces output for terminals and line printers the representation of documents is naturally quite primitive. -Fontchanges are totally ignored, which implies that -special symbols, such as mathematical symbols, get mapped into the -characters at the corresponding positions in the "standard" fonts. +In principle Font Changes are totally ignored, but +.I dvi2tty +recognizes +a few mathematical and special symbols that can be be displayed on an +ordinary ascii terminal, such as the '+' and '-' symbol. .PP 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 .I dvi2tty although they will be printed as one line on regular TeX output -devices (e.g. laserprinters). To show that a broken line is really +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 @@ -39,7 +41,7 @@ Such a continuation line is started with a a space and an asterisk in the first two columns. .PP Options may be specified in the environment variable DVI2TTY. -Any option on the commandline, conflicting with one in the +Any option on the command line, conflicting with one in the environment, will override the one from the environment. .PP .B Options: @@ -54,7 +56,7 @@ Numbers refer to TeX\-page numbers (known as \\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''. +e g \-1 comes before \-4 as in ``\-p\-1:\-4,17''. .TP .B \-P list Like \-p except that page numbers refer to @@ -71,61 +73,93 @@ be a good idea to use \-w132 and toggle the terminal into this mode as output will probably look somewhat better. .TP +.B \-v +Specify height of lines. Default value 450000. Allows to adjust linespacing. +.TP .B \-q Don't pipe the output through a pager. This may be the default on some systems -(depending on the whims of the SA installing the program). +(depending on the whims of the person installing the program). +.TP +.B \-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. .TP .B \-f -Pipe through a pager, $PAGER if defined, or whatever your SA compiled +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. .TP .B \-F Specify the pager program to be used. -This overides the $PAGER and the default pager. +This overrides the $PAGER and the default pager. .TP .B \-Fprog Use ``prog'' as program to pipe output into. Can be used to choose an alternate pager (e g ``-Fless''). .TP +.B \-t +\\tt fonts were used (instead of cm) to produce dvi file. (screen.sty +is a powerfull mean to do that with LaTeX). +.TP +.B \-a +Dvi2tty normally tries to output accented characters. With the -a option, +accented characters are output without the accent sign. +.TP .B \-l -Mark pagebreaks with the two-character sequence ``^L''. The default is -to mark them with a formfeed character. +Mark page breaks with the two-character sequence ``^L''. The default is +to mark them with a form-feed character. +.TP +.B \-c +Do not attempt to translate any characters (like the Scandinavion/latin1 mode) +except when running in tt-font. .TP .B \-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 SA made -the decision when the program was installed.) +Toggle option to process certain latin1 characters. Use this if your output +devices supports latin1 cahracters. +Note this may interfere with -s. Best not to use -u and -s together. .TP .B \-s -Try to find the special Scandinavian characters that on most (?) +Toggle option to process the special Scandinavian characters that on most (?) terminals in Scandinavia are mapped to ``{|}[\\]''. -This can be the default, and output from files not containing these -special characters will be identical regardless of this option. +Note this may interfere with -u. Best not to use -u and -s together. +.TP +.B \-J +Auto detect NTT JTeX and ASCII pTeX dvi format. +.TP +.B \-N +Display NTT JTeX dvi. +.TP +.B \-A +Display ASCII pTeX dvi. +.TP +.B \-bdelim +Print the name of fonts when switching to it (and ending it). The delim +argument is used to delimit the fontname. .SH FILES -/usr/ucb/more \ \ \ \ +/bin/more \ \ \ \ probably the default pager. .SH ENVIRONMENT PAGER \ \ \ \ \ \ \ \ \ \ \ \ the pager to use. .br DVI2TTY \ \ \ \ \ \ \ \ \ \ \ -can be set to hold commandline options. +can be set to hold command-line options. .SH "SEE ALSO" TeX, dvi2ps .SH AUTHOR -Svante Lindahl, Royal Institute of Technology, Stockholm +Original Pascal verion: Svante Lindahl, Royal Institute of Technology, Stockholm .br Improved C version: Marcel Mol .br -{seismo, mcvax}!enea!ttds!zap -.br -marcel@duteca.UUCP +marcel@mesa.nl, MESA Consulting .SH BUGS Blanks between words get lost quite easy. This is less likely if you are using a wider output than the default 80. .PP -Only one file may be specified on the commandline. +Only one file may be specified on the command line. + |