09/30/93
========

This is the distribution for DVIWIN 2.8 which is a DVI driver for previewing
and printing DVI files under MS-Windows 3.1. The following steps will help
you install the program as quickly as possible. Users of previous versions of
should only follow the upgrading steps; first time users should skip this
part and follow the initial installation procedure.


Upgrading from previous versions of dviwin
------------------------------------------

  1. Run the program "convini.exe" from the Program Manager once ONLY.
     The new version uses private initialization files; convini extracts
     the configuration information from win.ini and creates the files
     "dviwin.ini" and "wbr.ini", so you don't need to do it manually.
     After you run it, just discard that program.

  2. Copy the files "dviwin.exe", "dviwin.hlp", "wbr.exe", "wbr.hlp",
     "clipmeta.exe", "graphio.dll", "miscwin.dll" and "ctl3d.dll" over
     the old files (remember that "ctl3d.dll" should go to the
     \windows\system directory).

  3. Read or print the documentation files "whats.new", "dviwin.wri"
     and "helpme.wri". There are quite a few changes in this version,
     so please read these files.

  4. The files "mspin.flt", "bmpin.flt" and "pcxin.flt" are graphics
     filters. Please read the "Specials" section in "dviwin.hlp" or
     "dviwin.wri" for instructions about the filter installation.

  5. If you want to inspect or modify the source code of the filters,
     unzip the file "graphio.zip" using the "-d" switch in pkunzip
     and read the "readme" files for each directory.

  6. If you want to generate missing fonts automatically, please read
     the appropriate section in "dviwin.hlp" or "dviwin.wri" first.


  The following steps apply only if you are upgrading from dviwin 2.0:

  7. Go to the Options submenu and add the suffix \$r to your font
     directory. Otherwise, the program will NOT be able to find any
     PK fonts.

  8. Make sure that you have a statement "FILES=50" (or more) in your
     config.sys file.

  9. If you use a font substitution file, change it according to the
     new method (uses dpi instead of TeX magnifications). The new
     file should be called "dviwin.sub" instead of "texfonts.sub";
     there is a sample substitution file in this release.


Initial installation
--------------------

  1. Copy "ctl3d.dll" to your windows system directory (eg., c:\windows\system)
     If you use windows 3.0, copy also the file "commdlg.dll" to the
     same directory.

  2. Copy "dviwin.exe", "dviwin.hlp", "clipmeta.exe", "wbr.exe", "wbr.hlp",
     "graphio.dll" and "miscwin.dll" in any directory specified in your PATH
     environment variable.

  3. Make sure that you have a statement "FILES=50" (or more) in your
     config.sys file.

  4. Make new entries in one of your Program Manager groups for the three
     programs (dviwin.exe, wbr.exe, clipmeta.exe).

  5. Read or print the documentation files "dviwin.wri", "wbr.wri",
     "clipmeta.wri" and "helpme.wri" using the Microsoft Write program.

  6. You will also need a collection of PK font files in various
     resolutions; many such files can be found in the SIMTEL archives
     or any of its mirrors. In general, you want to get at least printer
     fonts, and optionally screen fonts. as well as for your printer
     Most screen fonts are in the files "dvivga2.zip" through "dvivga8.zip"
     in the directory pd1:<msdos.tex> of simtel. When you get these files,
     arrange them as following:

     a. Make a "base" directory (eg., c:\tex\pkfonts)
     b. Make a subdirectory under the base directory for each resolution.
        The name of each subdirectory should simply be the resolution.
        For example, you can make the subdirectories "c:\tex\pkfonts\300",
        "c:\tex\pkfonts\329", "c:\tex\pkfonts\360" for the 300 dpi, 329
        dpi and 360 dpi resolutions respectively.
     c. Put your PK font files in the correct subdirectories according
        to their resolution.

  7. The first time that you run "dviwin.exe", go to the "Font Directory"
     entry in the "Options" submenu and specify the base directory for
     your fonts followed by \$r. In the above example, the font directory
     entry should be "c:\tex\pkfonts\$r". If this step is not done, you will
     see NOTHING.

  8. Using a resolution between 100 and 145 dpi, open and see the file
     "demo.dvi". This was produced from the file "demo.tex" and it reads
     the graphics file "demo.wmf". As you will see, it is very easy to
     combine text and graphics using this driver. You can also print the
     file by issuing the "Print" command from the "File" submenu.

I hope that the above steps are clear. If there are any installation or
operation problems, please let me know.

Hippocrates Sendoukas
3 Sifnou St., Athens 11254, Greece
