.TH DVISUN 1
.SH NAME
dvisun \- display dvi file on Sun II
.SH SYNOPSIS
.B dvisun
[
.B \-p
] [
.B \-l
] [ \+n
] dvifile[.dvi]
.SH DESCRIPTION
The
.I dvisun
program displays a
.I .dvi
file on a Sun II.
After each page of the
output is displayed the program will wait for a response from
the user.  Type
.B u
, 
.B d
, 
.B l
, 
.B r
to move the displayed
page of the document up, down, left or right.  This provides a facility to 
examine the entire page if the page is larger than the screen.
A 
.B p
will display
the previous page.  <RETURN> goes to the next page.  When a new page is 
displayed the top left corner of the page will be displayed in the top
left corner of the screen.
Multiple pages may be skipped forwards or backwards by entering 
.B \+n <RETURN>
or
.B \-n <RETURN>
to skip n pages.  The program will not skip past the begining or the end
of the document.  Prior to display of the first page in the
document several pages may be skipped by including a
.B \+n
option on the command line.  This will cause n pages to be skipped
prior to displaying the first page on the screen.
Typing 
.B q
will cause
the program to exit.
.PP
After the document is processed a list of errors is printed
on standard error.  This error listing is also saved in
the file dvifile.loh.  The creation of the log file may be prevented
by using the
.B \-l
option when invoking the program.
.PP
This is a `bare bones' DVI-to-Sun program.  Minimal error checking
is done.  For more complete error checking
.IR dvitype(1)
should be run.
.PP
Ocasionally there may be insufficent memory to hold the information about
all of the fonts in the system.  Portions of the document may be previewed
by including the
.B \-p
option on the command line.  This will prevent the preloading of all fonts
into the system and instead use demand loading of the font tables.
.SH FILES
.TP 2.5i
*.dvi
TeX DeVice Independent output file
.TP
/usr/lib/dvifont/*.*pxl
TeX default font rasters
.br
.SH "SEE ALSO"
dvitype(1),
tex(1)
.SH BUGS
When using fonts with decent resolution only part of a page appears
on the screen.
.PP
This program can only be used on the console of the Sun and only at the
top-most level.  In other words, it won't work under the window package or
if your shell is nested.
.SH AUTHOR
Mark Senn wrote the early versions of this program for the BBN BitGraph.
Stephan Bechtolsheim, Bob Brown, Richard Furuta, James Schaad
and Robert Wells improved it.  Norm Hutchinson ported the program to the Sun.