
[This file is ./DVIware/crt-viewers/X/NOTE-xdvi.
 It is intended for users of the UNIX TeX distribution.
 April 1991.]


The ./xdvi/README file directs you to "Edit the Imakefile or Makefile";
we found it necessary to edit both.  

Check the settings for LIBDIR, INCDIR, DESTDIR, CC, etc. (i.e.,
examine all the settings) in addition to those to which the README file 
directs you.  These settings should reflect how things are set up on 
your machine.  

The commands for steps 2, 3, and 4 are "make xdvi", "make xdvi.man",
and "make install".

--------------------------------------------------------------------------

Making xdvi requires that you have a robust imake or ximake on your system.

If you do not succeed in getting the previewer made on your first run
(especially if you receive a complaint from your system about templates
not being available), look near the end of the imake or ximake man-page
for a reference to "xmkmf" (it generates a makefile while bypassing the
imake template), and try re-making the program using that.  

Be sure to use pk300w (write-white) fonts.  You will find a set of them 
in the pk300w subdirectory of each of the distribution's font directories 
(utilityfonts, cmfonts, LaTeXfonts, ./ams/amsfonts).  If you use the plain
pk300 fonts, you will have difficulty reading the material being previewed.

--------------------------------------------------------------------------

DEC-windows:

Xdvi under UNIX does not yet work under DEC-windows.  A routine called 
"XSetWMHints" must be placed somewhere into the xdvi program.  As the 
program currently stands, your window will be set up beautifully, the 
first page of your .dvi file will be presented beautifully, but you 
will not be able to turn pages because the window will not allow keyboard
input. (Vol.2, p. 457, of O'Reilly's X reference manual is worth looking 
at, should you decide to dive in and do the work.  Let us know!  We have 
no access to a DEC-windows machine.)

--------------------------------------------------------------------------

SUN OpenLook:

Under Sun OpenLook, compilation is still rather problematic.
Sun Microsystems does not yet supply the Athena Widgets (we have been 
told that they are planning to do so with future releases of their 
operating system), and the various *Xaw* references are therefore not yet 
available.  If you can acquire the libXaw* files for your specific 
architecture from some FTP site, (also the include files) that is, 
of course the best solution. (By pulling off the ./Xaw and the ./Xmu 
files to supplement its OpenLook X files, a Sparc site made, installed, 
and is happily using xdvi on its machine.)  Otherwise it may be possible 
to use -DNOTOOL option in place of -DBUTTONS in the Makefile.  That gives 
an apparently successful compilation, but you run into an unsatisfied 
reference later on in the shared-object loader.  We are still working 
on that, and would appreciate any ideas you have.  

Another approach is to define XVIEW and add an #ifndef XVIEW ...
#endif surround to the lines which ask for Xaw material in xdvi.c.
You will also have to eliminate -lXaw and =lXmu from the loader line
in the Makefile. Substitute -DXVIEW for -DBUTTONS.  That leaves the
viewportWidgetClass undefined, so that compilation still fails, but
viewportWidgetClass may be a pretty generic Class.  More news as soon
as we have it.  We welcome any other constructive thoughts.

If you leave -DBUTTONS defined, and use the -DXVIEW suggestion
the missing objects are not many, and most of them are associated with
buttons:  XtNChainTop XtNChainBottom XtNChainLeft XtNChainRight 
	  [XtNtop] XtNbottom XtNleft XtNright
          XtNdefaultDistance XtNfromHoriz

The only other real problems are:
          commandWidgetClass formWidgetClass viewportWidgetClass

Let's have some XVIEW gurus get to work on this.

--------------------------------------------------------------------------
	NOTE: The whole of X11R4 can be retrieved via anonymous ftp from 
	lll-crg.llnl.gov, in ~/pub/X.V11R4.  Both ./Xaw and ./Xmu are in
	the material in the subdirectory tape-1.  Note, too, that X11R4 
	makes use of /usr/include/sundev/cg6reg.h.  Check to see that it
	is on your system.  It is part of the Sun Developer's package;
	it should have been presented as an option in the initial instal-
	lation of the operating system.  
--------------------------------------------------------------------------

EOF











