There are three types of Emulator release:

        (1) Emulator only, initial letter "D": e.g. D07MAR.ZIP
        (2) XLisp only, initial letter "X": e.g. X07MAR.ZIP
        (3) Combined Emulator and XLisp, no initial letter: e.g.
            07MAR.ZIP 

Following the initial letter is a two-digit day-of-month followed by
a three-letter month optionally followed by a single-digit version
(for multiple releases on the same day).

I'll begin with instructions for a first installation of a combined
release. 

1. Unzip the release in the top-level directory, e.g.:

        C:\>pkunzip -d 07mar

This will create two top-level directories: XLISP and EMULATOR.

2. Edit AUTOEXEC.BAT to create the following path and environment
entries: 

        PATH=C:\XLISP;C:\XLISP\WINDEBUG;%PATH%
        SET MPARSE=C:\EMULATOR;C:\MPE_include
        SET XLISP=C:\XLISP;C:\EMULATOR;C:\USER

The PATH entry is necessary in order to use the command-line version
of the Emulator. 

The MPARSE environment variable is a search-path for include files
within an assembler source file. The EMULATOR directory must appear
here; the MPE_include directory contains MPE ROM routines for
numerical functions such as reciprocal and square root; other
directories can be added to the list as appropriate. 

The XLISP environment variable is a search-path for opening XLisp's
LOAD command (normally used to load *.LSP files). It must contain the
XLISP and EMULATOR directories; the USER directory can be any
location where other customizing XLisp files live.

3. Open Visual C++ and build the MERLIN project as follows. Select
"Open Workspace..." from the File menu, and select Merlin.mdp in the
folder C:\EMULATOR\MERLIN. (After the first time, this project will
appear at the bottom of the File menu, and can simply be selected
without the directory search.) Choose "Rebuild all" from the Build
menu. Afterwords select "Close Workspace" from the File menu.

4. Build the MPARSE project in the same way -- it is located in
C:\EMULATOR\MPARSE.

5. Each step produced both a .DLL and a .LIB file; copy all of these
to the XLISP directory (a batch file may be convenient here):

        copy \emulator\mparse\windebug\mparse.dll \xlisp
        copy \emulator\mparse\windebug\mparse.lib \xlisp
        copy \emulator\merlin\debug\merlin.lib \xlisp
        copy \emulator\merlin\debug\merlin.dll \xlisp

(If this is not being done for the first time, make sure the old DLLs
aren't loaded in an active instance of the Emulator, since that will
prevent their being overwritten.)

6. Back in Visual C++, build the XLISP project (in C:\XLISP) and then
the XLISPW project (in C:\XLISP\XLISPW). The former of these is the
command-line version, and the latter is the windowing version.

7. If it is desired to create a desktop icon to launch the Emulator,
use Win95 to open the C:\XLISP\XLISPW\WinDebug folder (starting with
"My Computer", for example); select the icon labelled Xlispw.exe, and
drag it to the desktop using the RIGHT mouse button -- this gives you
the option of creating a Shortcut which you can rename to something
suggestive like "Merlin Emulator". By right-mouse-clicking on this
icon and selecting the Properties menu item, the most convenient
starting directory can be set in the Shortcut tab.

8. Restart Windows so that the new entries in AUTOEXEC.BAT can take
effect. 

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

In subsequent installations it is recommended that the old XLISP and
EMULATOR directories be removed (e.g. with DELTREE), since that will
eliminate dead files which might remain after a fresh unzipping. (A
more conservative approach, which will succeed even if a DLL is open,
is to rename these directories: e.g.

        ren xlisp xlisp.old
        ren emulator emulator.old

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

For installation of an XLISP-only release, begin by deleting or
renaming the XLISP directory, and then unzipping: e.g.,

        ren xlisp xlisp.old
        pkunzip -d x07mar

Use Visual C++ to rebuild XLISP and XLISPW.

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

For installation of an EMULATOR-only release (this will be the most
frequent case), begin by deleting or renaming the EMULATOR directory,
and then unzipping: e.g.,

        ren emulator emulator.old
        pkunzip -d d07mar

Next use Visual C++ to rebuild the MERLIN and MPARSE projects.
Finally, copy the MERLIN and MPARSE DLLs to the XLISP direcrtory. It
is not necessary to copy MERLIN.LIB or MPARSE.LIB, nor is it
necessary to rebuild XLISP or XLISPW.

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

        


