

                         RUNNER -- FIRST RELEASE
                         -----------------------
        (created for Doom/Doom II -- Heretic version also available)

DISCLAIMER: I, PAUL POLLACK, CANNOT TAKE RESPONSIBILITY FOR ANY HARM
            CAUSED BY THIS PROGRAM. THIS IS DISTRIBUTED "AS IS" WITH
            NO WARRANTY EXPRESSED OR IMPLIED.

Preface: What is Runner?

        Runner is a customizable program that allows users to execute your
PWAD without having to type in arcane commands from the command line. It
was developed by Paul Pollack of DragonHawk Productions, and may be freely
distributed with your PWAD provided that some acknowledgement is given, and
that it is NOT distributed with PWAD's that work with the shareware version
of DOOM. This is according to id's wishes, since otherwise I might somehow
be discouraging others from registering.

        This version of Runner has been created specifically to work with
Doom or Doom II, both by id software. A version that supports Heretic
and its PWADs is also available; both are included in Doom Level Design
for Laymen version 1.5 or above.

PART I: REQUIREMENTS

- An ANSI driver loaded before running the program
- EDIT, included with DOS 5.0 and higher
- A PWAD you wish to have a runner for
- Doom/Doom II

PART II: SETTING IT UP

        One of the features that sets RUNNER apart from other similar
programs is its ease of use. Included in this release are 8 files you
should edit in order to get RUNNER to work correctly. First of all,
use the DOS EDIT command to EDIT RUNDATA.DAT (DO NOT EDIT RUNNER.DAT!!!).

        Each line of RUNDATA.DAT contains differnet information about
your PWAD that RUNNER needs to know in order for it to execute properly.
The first line is the name of the WAD, e.g., Imps Unleashed... Thus,
the first line would look like this:

IMPS UNLEASHED

        The second line contains the WAD title name again, this one to 
be displayed prominently on your main menu screen. An example would be:        

IMPS UNLEASHED -- PART 1 BY SLIMY SOFTWARE

        The third line of the file contains information to be displayed
right under the previous line's contents (remember, DMRUNNER automatically
centers these for you, so you don't have to worry about spacing). It
might look something like this:

WITHOUT IMPS UNLEASHED, DOOM IS JUST ANOTHER 3D GAME...

        The fourth line is a miscellaneous message, to be displayed
right above the choices. You might want it to look something like this,
if we're continuing along the IMPS UNLEASHED theme:

SELECT AN OPTION FOR IMPS UNLEASHED NOW!

        The next line is the one which contains the name of the EXE file 
you want your PWAD to run -- (e.g. DOOM2). Replace it and move on...

        The sixth line contains the actual filename of your level. For
example, you might have:        

IMPUNLSD.WAD

        The exit message is stored on the last line. This will be displayed
after your PWAD has been run, and you exit Doom. You might want it to
say:

Thanks for running Imps Unleashed. It's been a pleasure.

        The last line is simple, and usually short. It contains the 
level number you'd like Doom to warp to. For example, you might want 
this line to read 

1 

if you're running a Doom II PWAD which starts off on the first level. 

Then again, you might want it to say: 

2 3 

if you're running a Doom I PWAD that starts off on the third level
of episode 2. After replacing the contents, save the file. Viewing it
with a text editor, or such, it should look something like this (with
one line provided above and below the actual file contents):

IMPS UNLEASHED 
IMPS UNLEASHED -- PART 1 BY SLIMY SOFTWARE
WITHOUT IMPS UNLEASHED, DOOM IS JUST ANOTHER 3D GAME...
SELECT AN OPTION FOR IMPS UNLEASHED NOW!
DOOM2
IMPUNLSD.WAD
Thanks for running Imps Unleashed. It's been a pleasure.
1 

        We're done, right? Not quite... Now that you've finished with those
files, run DMRUNNER.EXE and see how you like it. Not bad, eh? Now rename the
file DMRUNNER.EXE to whatever you want the runner's EXE name to be, for
example, IMPUNLSD.EXE. Copy all the files, except RUNNER.BAS, wherever
you'd like them, whether in your PWAD directory so you can ZIP and U/L
your PWAD ASAP, or to your Doom/Doom II directory, so you check out how
it'll work for the average user. 

PART III: DISTRIBUTION        

        You may distribute DMRUNNER.EXE (or whatever you've renamed it) with
your PWAD; in fact, I encourage to do just that. Remember, however, that
you may NOT use this as a runner for PWAD's that intentionally work with
the shareware version of Doom, nor may you use this without acknowledging
me at least somewhere in your PWAD's documentation.

PART IV: SOURCE CODE

        I've included RUNNER.BAS (created by QuickBASIC 4.5 and stored
in text format), the only file (aside from this one) not needed by 
DMRUNNER.EXE, to give you an idea of how RUNNER was made. You may use this to 
modify RUNNER, and/or improve on it, provided that you state that the 
original program was created by Paul Pollack.

PART V: GOOD LUCK!

        Good luck creating the PWAD runner of your dreams! If you have        
any questions I can be reached on the Board of Trade BBS as Paul Pollack,        
or on the Internet as paul.pollack@intol.com. Also be sure to check out my
home page at http://www.intol.com/paul\paul.htm. Thanks for downloading and 
happy DOOMING!

                                                        -- Paul Pollack

                        Future Version Wish List
                        ------------------------

        These features may or may not be in the next version of RUNNER:

        1. Removal of the one-line limit
        3. Any user suggestions

                           THANKS FOR DOWNLOADING!!!







