This is dvitool, a quick and dirty hack of an OpenLook style DVI previewer
which is based on xdvi. You will need a working X11 and XView distribution
to compile dvitool.


ATTENTION: The ONLY purpose that this software is reasonable for  
           right now, is to demonstrate the usage of some of
           the XView (i.e. OPEN LOOK) objects and routines.
		   
           IT IS BY NO MEANS QUALITY SOFTWARE AND THE AUTHORS
           MAKE ABSOLUTELY NO WARRANTIES ABOUT CORRECT BEHAVIOR
           OF THE SOFTWARE.
		   
           Considering the development time of just 4 days,
		   it runs quite stable and has a fairly amount of usability. 


THIS PROGRAM MAY BE DISTRIBUTED AND COPIED FREELY PROVIDED THAT THE ORIGINAL AUTHORS' NAMES ARE MENTIONED IN THE SOURCE.


Files that have changed from the original 'xdvi' distribution:

         Makefile
         dvi_draw.c
         dvi_init.c
         xdvi.c     -  (is now named dvitool.c)

Added project documentation files:

		DvitoolDocEnglish.ps
		DvitoolDocGerman.ps
		README.Docs
		
Added original dviinfo files:

		dviinfo.c
		dviinfo.1
		
		

This OPEN LOOK version has been built during an university project
in June 1992. It work's but IT IS QUICK 'n DIRTY. Some functionality
from the original xdvi have been removed for simplicity and easier
adaption to XView. There are lots of things to do, some include:
       - clean up the whole code, there are funtions and variables
         that are not used any longer; split the code create some
         headers etc...
       - implement ERROR HANDLING, most error posibilities are
         NOT catched right now
	   - THERE'S NO MAN-PAGE ! WRITE ONE !
         (As for now, use the XView Help facility for questions)
	   - work over the 'Info' and 'Errors' button notices; 
         they will core dump if there are too many lines of information;
         a textsw or list panel would be a better display facility
	   - catch all output to oops and redirect
         it into a textsw or a notice, so that the user
         may look at errors when loading a new file;
         catch output from check_dvi_file
       - implement an XView conforming command line arguments
         scanning; reimplement the original xdvi options
       - implement a clean and XView conforming color handling
       - there should be an event loop that triggers all the other
         actions and catches resize events etc.; right now
         the canvas repaint procedure is called throughout the
         code; this is dirty !
       - re-implement the magnification glass
       - internationalize the whole thing
       - implement some good ideas, such as 'multi page preview'
         for example, by catching the split notification and
         handle a separate page counter for each view; another
         goodie would be a file browser in the file load frame
         ... and so it goes on and on ...

 Compilation options:
 
 MSBITFIRST	store bitmaps internally with most significant bit first
 BMSHORT	store bitmaps in shorts instead of bytes
 BMLONG		store bitmaps in longs instead of bytes
 ALTFONT	default for -altfont option
 A4			use European size paper
 TEXXET		support reflection dvi codes (right-to-left typesetting)



Good luck !!!
