DVItoVDU v3.3		24 April 1990
~~~~~~~~~~~~~


1.  INTRODUCTION
~~~~~~~~~~~~~~~~ 
This directory tree contains the files needed to upgrade Trevorrow's
DVItoVDU v3.1 to v3.3. The changes made BETWEEN V3.1 AND V3.3 are detailed
in the file 00CHANGES.TXT.  The files provided are: 

-----------------------------------------------------------------------------
00README.TXT		     -	this file
00CHANGES.TXT		     - 	details of the changes made between v3.1
			      	and v3.3

DVITOVDU.CLD		     -	the command verb definition file for DVItoVDU
DVITOVDU_ONLINE.HLP	     -	the file used by DVItoVDU to provide online 
				help

DVITOVDU_DCL.HLP	     -	a help file suitable for inclusion in a DCL 
				help library
RMCS_USERGUIDE.TEX	     -	the DVItoVDU user guide prepared at RMCS

SRC.DIR			     -	a subdirectory containing the new / changed
				.DEF  & .MOD source modules.  For users of 
				DEC's module management system (MMS), there
				is a DESCRIP.MMS file for building DVItoVDU.

In addition, compiler .OBJ and .SYM files have been placed in the directory
[TeX-Archive.Binary.DVItoVDU]; these were generated using V4.1-0 of the
Modula-2 compiler supplied by Logitech.  For those without this compiler, a
linked executable DVItoVDU.EXE is also provided in this directory; this has
been linked against Logitech's run-time library, so will run on VMS V5.1
and later, even when the shareable image for that library is not available.
-----------------------------------------------------------------------------



2.  INSTALLING DVItoVDU
~~~~~~~~~~~~~~~~~~~~~~~

The files needed to install DVItoVDU v3.3 are:

	DVITOVDU.CLD
	DVITOVDU.EXE
	DVITOVDU_ONLINE.HLP

The image DVITOVDU.EXE is provided, though you can build it from the 
sources (see section 4.)

The DVItoVDU.CLD file defines the DVItoVDU command verb.  You will need to 
edit several items to suit your system setup (notably the IMAGE line and the 
default values of the /HELP_FILE, /PK_FONT_DIRECTORY & /PXL_FONT_DIRECTORY 
qualifiers).  Once you've copied the above files to the chosen locations, 
DVItoVDU v3.3 is ready to use.



3.  INSTALLING DVItoVDU
~~~~~~~~~~~~~~~~~~~~~~~
Some documentation is provided, namely a user guide and a help file suitable 
for online DCL help.

To add DCL help for DVItoVDU to (for example) the main help library, use a 
command like:

	LIBRARY/LOG/HELP/REPLACE SYS$HELP:HELPLIB.HLB DVITOVDU_DCL.HLP

The userguide is in LaTeX source format, and can be processed ready for use by 
your DVI-to-?? driver with the commands:

	LATEX rmcs_userguide
	LATEX rmcs_userguide


4.   BUILDING DVItoVDU FROM SOURCES
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
You'll need a MODULA-2 compiler to build DVItoVDU from sources.  Assuming 
that you already have the sources for DVItoVDU v3.0, you should COPY in the 
files provided in the [.SRC] subdirectory. This will replace some of the 
existing files and insert some new ones.  

If you are fortunate to have DEC's Module Management System (MMS), the 
supplied DESCRIP.MMS file will do most of the work for you.  If you don't have 
MMS, the command file BUILD_DVITOVDU.COM may help.

Before compiling, check the 00CHANGES.TXT file as some of the changes made may 
not be supported by your compiler.  If you do manage to produce a working 
DVItoVDU, please let us know - we'd like to support as many compilers as 
possible.



5.  CONTACT ADDRESS
~~~~~~~~~~~~~~~~~~~
Most of the changes were made at RMCS, with some of VDU modules and ideas 
contributed Phil Taylor of RHBNC <chaa006@uk.ac.rhbnc.vaxa>.
Suggestions and/or constructive criticisms are welcome!  Please post them to:

			Niel Kempson

.-------------------------------------------------------------------------.
| JANET:     tex@uk.ac.cranfield.rmcs                                     |
| BITNET:    tex%uk.ac.cranfield.rmcs@ukacrl                              |
| INTERNET:  tex%uk.ac.cranfield.rmcs@nsfnet-relay.ac.uk                  |
| Smail:     School of Electrical Engineering & Science, Royal Military   |
|            College of Science, Shrivenham, SWINDON SN6 8LA, U.K.        |
| Phone:     Swindon (0793) 785687 (UK), +44-793-785687 (International)   |
`-------------------------------------------------------------------------'
