Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DVI2TTY(1)		    General Commands Manual		    DVI2TTY(1)

NAME
       dvi2tty - preview a TeX DVI-file	on an ordinary ascii terminal

SYNOPSIS
       dvi2tty [ options ] dvi-file

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

       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.
       Since  dvi2tty produces output for terminals and	line printers the rep-
       resentation of documents	is naturally quite  primitive.	 In  principle
       Font  Changes  are totally ignored, but dvi2tty recognizes a few	mathe-
       matical and special symbols that	can be be  displayed  on  an  ordinary
       ascii terminal, such as the '+' and '-' symbol.

       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  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  dvi2tty.
       Such  a	continuation line is started with a a space and	an asterisk in
       the first two columns.

       Options may be specified	in the environment variable DVI2TTY.  Any  op-
       tion on the command line, conflicting with one in the environment, will
       override	the one	from the environment.

       Options:

       -o file
	      Write output to file ``file''.

       -p list
	      Print the	pages chosen by	list.  Numbers refer to	TeX-page  num-
	      bers  (known  as	\count0).   An	example	 of format for list is
	      ``1,3:6,8'' to choose pages 1, 3 through 6 and 8.	 Negative num-
	      bers can be used exactly as in TeX, e g -1 comes before -4 as in
	      ``-p-1:-4,17''.

       -P list
	      Like -p except that page numbers refer to	the sequential	order-
	      ing of the pages in the dvi-file.	 Negative numbers don't	make a
	      lot of sense here...

       -w n   Specify terminal width 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.

       -v     Specify  height of lines.	Default	value 450000. Allows to	adjust
	      linespacing.

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

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

       -f     Pipe  through  a	pager,	$PAGER if defined, or whatever the in-
	      staller 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.

       -F     Specify the pager	program	to be used.  This overrides the	$PAGER
	      and the default pager.

       -Fprog Use  ``prog''  as	 program  to  pipe output into.	Can be used to
	      choose an	alternate pager	(e g ``-Fless'').

       -t     \tt fonts	were  used  (instead  of  cm)  to  produce  dvi	 file.
	      (screen.sty is a powerfull mean to do that with LaTeX).

       -a     Dvi2tty  normally	 tries to output accented characters. With the
	      -a option, accented characters are  output  without  the	accent
	      sign.

       -l     Mark page	breaks with the	two-character sequence ``^L''. The de-
	      fault is to mark them with a form-feed character.

       -c     Do not attempt to	translate any  characters  (like  the  Scandi-
	      navion/latin1 mode) except when running in tt-font.

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

       -s     Toggle  option  to  process  the special Scandinavian characters
	      that on  most  (?)   terminals  in  Scandinavia  are  mapped  to
	      ``{|}[\]''.  Note	this may interfere with	-u. Best not to	use -u
	      and -s together.

       -J     Auto detect NTT JTeX, ASCII pTeX,	and upTeX dvi format.

       -N     Display NTT JTeX dvi.

       -A     Display ASCII pTeX dvi.

       -U     Display upTeX dvi.

       -Eenc  Set output Japanese encoding. The	enc argument  'e',  's',  'j',
	      and  'u'	denotes	EUC-JP,	Shift_JIS, ISO-2022-JP,	and UTF-8, re-
	      spectively.

       -bdelim
	      Print the	name of	fonts when switching to	it  (and  ending  it).
	      The delim	argument is used to delimit the	fontname.

FILES
       /bin/more      probably the default pager.

ENVIRONMENT
       PAGER		  the pager to use.
       DVI2TTY		   can be set to hold command-line options.

SEE ALSO
       TeX, dvi2ps

AUTHOR
       Original	 Pascal	verion:	Svante Lindahl,	Royal Institute	of Technology,
       Stockholm
       Improved	C version: Marcel Mol
       marcel@mesa.nl, MESA Consulting

BUGS
       Blanks between words get	lost quite easy. This is less  likely  if  you
       are using a wider output	than the default 80.

       Only one	file may be specified on the command line.

			       13 November 1990			    DVI2TTY(1)

NAME | SYNOPSIS | DESCRIPTION | FILES | ENVIRONMENT | SEE ALSO | AUTHOR | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dvi2tty&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help