-------------------------------------------------------------------------------
 Intelli-Jumble command reference
-------------------------------------------------------------------------------
  Files:
   JUMBLE.EXE	 The program
   JUMBLE.DOC	 This file
   JUMBLE.C	 Jumble's C source file*
   WADFILE.C	 More C source code*
   GENERAL.H	 More C source code*
   WADFILE.H	 More C source code*

   *-You can erase these files if you don't want them.

  Requirements:
   Registered DOOM version 1.2 or above.
   3+ megs free on your hard disk.

  Installation:
   Copy JUMBLE.EXE into your DOOM directory.

  Definition:
   WAD file: A DOOM data file that contains maps and/or graphics. DOOM stores
	     everything in a file called DOOM.WAD.

  Description:
   This program creates a file, JUMBLE.WAD, that contains the 27 maps
   from DOOM in a random order. The things (characters, items, etc.) in each
   map are shuffled and start out facing in a random direction.  Each map
   has a song randomly assigned to it.	The Boss levels are special
   exceptions: they remain in the same place (map 8), but they get new,
   wacky music never before heard in a map. Jumble makes intelligent
   decisions regarding the placement of objects, and as a result, 99+% of
   the maps are playable--unprecedented!

   Episode 3, Map 8 is specially modified to make gameplay "fun".

   The C source code is included so you can add features and look under
   the hood.

   Take note: JUMBLE.WAD is over 3 megs in size.

  Usage:
     JUMBLE filename [random seed]

    where:
       'filename' is the full file path of your DOOM.WAD file.

       'random seed' is an optional parameter. If you want a specific
       shuffling order, use this. There is no way to tell beforehand
       what a particular random seed will yield, but if you find a really
       notable map, you can have your friends generate the same maps by
       using the random seed you used. If you don't specify a random seed,
       JUMBLE looks at the system clock to get a value. A random seed is a
       number between 0 and 99999.

  Examples:

  1) Basic usage

  From your DOOM directory, type
   jumble doom.wad

  Run DOOM with this form:
    DOOM -file JUMBLE.WAD { other normal parameters }
    This tells DOOM to use the maps in JUMBLE.WAD instead of DOOM.WAD.
    [Note: DOOM reports that it is modified, but DOOM.WAD is NOT modified.]

  2) OK, it's time to KFA....
   From your DOOM directory, type
    jumble doom.wad 90210

   The random seed is 90210.

   Run DOOM:
    DOOM -file JUMBLE.WAD { other normal parameters }

   Once inside DOOM, start an Ultra Violence game and type:
     idclev23
   This zaps you to Episode 2, Map 3.  This is a fun map.

 Technical Notes:
  Certain items in the maps are not jumbled. These items are: Player
  starting positions, Deathmatch starting positions, all keycards and
  skull keys, and teleporters.	Moving these objects around usually makes
  the map unplayable.

 History:
  1.0.0  (April 3, 1994)

Legalese:
  JUMBLE SOFTWARE LICENSE AGREEMENT

  1. GRANT OF LICENSE. Michael McMahon and his affiliations (collectively
     the "AUTHOR") grant you (either an individual or an entity) the
     non-exclusive, royalty-free right to use this source code,
     documentation, and executable code (collectively, the "SOFTWARE") for
     any lawful purpose subject to the terms of this license.  By using the
     SOFTWARE you are agreeing to be bound to all the terms of this license.

  2. COPYRIGHT.  The SOFTWARE is Copyright (c) 1994, Michael McMahon,
     PO Box 14807, San Luis Nabisco, CA 93406-4807 USA. All Rights Reserved
     Worldwide.  You may not use, modify, or distribute the SOFTWARE except
     as otherwise provided herein.

  3. DECLARATION OF PUBLIC DOMAIN DISTRIBUTION AND USE. The distribution
     and use of the SOFTWARE is hereby designated PUBLIC DOMAIN by the
     the AUTHOR.  You may not sell, rent, or lease this SOFTWARE.  The
     SOFTWARE may be reproduced verbatim in part or in full by any
     reproduction means for any lawful purpose, and may also be subject to
     the following agreement.

  4. AGREEMENT FOR USE OF SOFTWARE. The AUTHOR grants you a non-exclusive,
     royalty-free right to incorporate the SOFTWARE into any production for
     any legal purpose as long as you agree
     (a) to indemnify, hold harmless, and defend the AUTHOR from and against
	 any claims or lawsuits, including attorneys' fees, that arise or
	 result from the use or distribution of your software production; and
     (b) no matter how much the SOFTWARE is modified, the AUTHOR owns the
	 copyright and this original, unmodified copyright notice remains
	 intact in the source code; and,
     (c) the AUTHOR is not held responsible for fixing bugs or making
	 enhancements or changes to the SOFTWARE for any reason; and,
     (d) the SOFTWARE is not redistributed if it is modified in any way; and,
     (e) otherwise comply with the terms of this agreement; and,
     (f) the AUTHOR is forgiven for making so many demands.

     THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE
     AUTHOR FURTHER DISCLAIMS ALL IMPLIED WARRANTIES, INCLUDING WITHOUT
     LIMITATION ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR OF FITNESS
     FOR A PARTICULAR PURPOSE.	 THE ENTIRE RISK ARISING OUT OF THE USE
     OR PERFORMANCE OF THE SOFTWARE REMAINS WITH YOU.

     The author can be reached at:
	Michael McMahon
	P.O. Box 14807
	San Luis Nabisco, CA 93406-4807 USA
	Internet: mmcmahon@oboe.calpoly.edu
	[Bug reports, suggestions, success stories, etc. are welcome; tech
	 support, and other unnecessary two-way mail, is not]