
Eternal III Upgrade Installation

The file E3UPG.ZIP is used to upgrade the Eternal II release to Eternal
III. You must have a working Eternal II installation in order to use the
upgrade.

Requirements: 50MB free disk space for installation
              386 with 8M of RAM or better
              A working DOOM II installation or Final DOOM installation

Environment: We recommend a Win'95 DOS window, and if you don't have
             one of those, a pure DOS session.

Note: You cannot install Eternal in a path involving any long Win'95
filenames due to DOOM's inability to parse long filenames in a response
file - unless you use DOOM95 or a Win'95 command line to run Eternal,
rather than the shell provided.

===========================================================================
BRIEF UPGRADE INSTALLATION (You need ETERNAL II installed first!):
===========================================================================

If you only own Final DOOM, or have 8M of memory or less and run EMM386,
or just have questions, please refer to the detailed instructions further
below for installation in special circumstances.

1) Make sure you have 50 (!!) megabytes of free hard-disk space.  "Only"
   30M or so are required after installation, and that includes the 28M
   Eternal II installation too.

2) Copy E3UPG.ZIP (upgrade) to your ETERNAL directory, and unzip it
   there. Answer "Y" or "A" to questions about replacement of files.

3) Enter "ETERNAL" at the DOS prompt. This runs the shell, which carries
   out installation and exits. If you have a slow system or slow disk,
   installation can take a considerable period, perhaps as much as half
   an hour. It runs in just a minute or so on a P90 system.

This file provides detailed instructions for each of the possible
situations a downloader may encounter further below.

===========================================================================
RUNNING ETERNAL:
===========================================================================

   DOOM II owners:

    Enter "ETERNAL" at the DOS prompt one more time. You are now in
    the Eternal DOOM shell. Press Enter to begin Eternal, or TAB to
    the levels window and select the level you wish to start at before
    hitting Enter.

   Final DOOM only owners:

    Install according to the Final DOOM directions further below.

    If you have installed TNT or PLUTONIA for DOS, and used that IWAD for
    installation, you can use ETERNAL to run the shell.

    If you have only installed Final DOOM for Windows '95 or specified
    that directory in installation the shell cannot be used. Instead:

       Run DOOM95 and specify the ETERNAL.WAD file in the ETERNAL
       directory as the play wad. Use TNT.WAD or PLUTONIA.WAD for the
       game wad (the one that was specified during installation). The
       Eternal shell cannot be used with DOOM95.EXE. You need a copy
       of DOOM2.EXE, or DOOM.EXE to put in the Final DOOM directory.

   Command-line devotees:

    If you prefer the command line, simply issue 

     DOOM2 -file X:\Eternal\ETERNAL.WAD

    where X:\Eternal\ represents your Eternal drive and directory path.

===========================================================================
REVISION INSTALLATION:
===========================================================================

After downloading an Eternal revision (none available yet!), unzip it in
the Eternal directory, noting the name of the wad inside. Then run the
shell and press Alt-I. Choose Wad from the menu, enter the wadname in the
prompt and press Enter.

If you have extremely little DOS memory, or are low on disk space, this
may fail. Enter the following from a clean booted system prompt in the
Eternal directory in that case, but you MUST insure you have sufficient
disk space first. The ETERNAL.WAD and ETERNXXX.WAD may require nearly
50MB together (possibly 60MB or more with Final DOOM configurations). The
MER starts by truncating ETERNAL to 0 bytes so only the additional space
required by REVISION.WAD (usually insignificant) is necessary. Any file
can be on any drive if that helps, just specify the full path to it.

COPY ETERNAL.WAD ETERNXXX.WAD    
MER ETERNXXX REVISION ETERNAL
DEL ETERNXXX.WAD
                                
===========================================================================
BACKUP
===========================================================================

The Eternal software attempts to maintain retryability, and the ability
to reinstall later if necessary. This may be more security than necessary
and you might rather have disk space in its place. Just delete the files
in the BACKUP subdirectory AFTER installation in that case.

Leaving the old ETERNAL.ZIP and E3UPG.ZIP in the directory you install
from allows the software to delete the unneeded files without losing the
ability to recover, for example from a power failure during 
installation. It will require MORE disk space if you delete them prior 
to installation.  Delete the BACKUP directory after installation if you 
so wish.

ETERNAL.INI will be preserved from the ETERNAL II installation, and
provides automatic DOOM II location during installation. Delete it if
you wish to change the location for DOOM II. ETERNAL.ZIP and E3UPG.ZIP
are saved in the BACKUP subdirectory.

===========================================================================
Recreation of missing or corrupted ETERNAL.INI or ETERNAL.BAT
===========================================================================

   If you lose your ETERNAL.INI or ETERNAL.BAT it's not fatal, you don't
   even have to unzip the archive again. To replace ETERNAL.INI, or if
   the settings in it become damaged or you can't get them working, just
   DEL ETERNAL.INI if it still exists and the shell will recreate the
   file (with default settings everywhere), next time you run ETERNAL.

   If you lose ETERNAL.BAT or it becomes damaged enter the line

   ESHELL BAT

   and ESHELL will recreate ETERNAL.BAT.

===========================================================================
Un-installation of Eternal II
===========================================================================

   Note: If your intention is to re-install later, first recover the
   ETERNAL.ZIP and E3UPG.ZIP files from the BACKUP subdirectory of the
   Eternal directory and store them somewhere safe, out of the ETERNAL
   path. If you don't have ETERNAL.ZIP still, copy ETERNAL.WAD from the
   Eternal II installation instead (zipped into ETERNAL.ZIP is best).
   This is the minimum disk space that can be used and still re-install
   without re-downloading.

1) IF you have installed in the DOOM II or Final DOOM directory, or other
   directory containing non-Eternal files, first use the shell to delete
   all saves and demos (Highlight one and press DEL, choose All and
   confirm with Y). Then use the list of files provided below to delete
   each from the directory. Remove the subdirectory DATA with RD. Delete
   all the files in DOOM2SV and use RD on it as well.

     Files in Eternal DIR from Eternal III

     ETERNAL.WAD     All the Eternal resources and levels, after installation

     ETERNAL  BAT    Shell runner batch file (ESHELL BAT recreates it)
     ESHELL   EXE    Shell and Installation executable
     PATCHER  EXE    Utility executable
     RESOURCE DEF    DOOM II resource definitions for Patcher
     CWSDPMI  EXE    DJGPP runtime DOS extender/DPMI manager
     
     NULL     WAD    Used to build wads
     SEPI3    BMP    Blue sky bitmap
     STARS    BMP    Starry sky bitmap
     UDSKY    BMP    Ultimate DOOM sky bitmap
                     
     WELCOME  EXE    Welcome to Eternal DOOM self-playing sound
     ETERNAL  LEV    List of level, author, and music names by map number
     PATCHKIL RES    List of patches to delete from old ETERNAL.WAD
     
     CSWEEPER WAD    Bonus wad (plays as 33 from the shell, Map01 from DOS)
     RANCY    EXE    CSWEEPER randomizer executable
     CREDITS  WAD    Bonus wad (plays as 34 from the shell, Map01 from DOS)

     ETERNAL  TXT    This is the one you're looking at now
     SHELL    TXT    Instructions for the shell
     SHELLKEY TXT    Quick key reference for shell
     GENERAL  TXT    Some general help
     ED-MUSIC TXT    The complete Eternal music playlist
     INSTALL  TXT    Detailed installation instructions
     RELEASE  NOT    Details on what is different from Eternal I
     ETERNAL  INI    Contains setup/configuration and shell status information.
     ETERNAL  BAT    Used to play Eternal through shell.

     DEFAULT.CFG     Present if IWAD configuration used

2) If you have installed Eternal in its own directory, say \ETERNAL, then
   it can be removed with the command DELTREE \ETERNAL, unless your DOS
   is pre 6.0. Use caution - DELTREE can delete many more files than you
   wish if you are not very careful what you type. In particular DO NOT
   put a space between the \ and the directory name, ETERNAL!!! This
   would delete ALL files on the drive.

3) Without DOS 6.0+, or if we just scared you off DELTREE <g>, we
   recommend File Manager in Windows to delete the \ETERNAL dir.

4) Without DOS 6.0+ or Windows, use the shell to delete all saves and
   demos, and perform manual deletion of the files in DOOM2SV. Then RD
   DATA, RD DOOM2SV, and manually delete all files from the ETERNAL dir
   with DEL *.* from it. Then change to its parent directory (CD ..) and
   RD ETERNAL to complete removal of all Eternal files.

