                                 DEMON v1.0
                              ================
                (Doom's effective movie organizer's nameless)

                              by Oliver Brakmann
                        <oliver.brakmann@privat.kkf.net>

                             INSTRUCTION MANUAL
                                  01/08/00
----------------------------------------------------------------------------

----------
DISCLAIMER
----------

You may use this program only at your own risk. I will not be held re-
sponsible for any damage done to your computer hardware or software, as
well as any other damage that is caused by the use of this program.

This program is freeware, meaning you may distribute it in any electronical
form, including, but not limited to, the Internet, BBS's, CD-ROMs, etc.,
granted you include the original .ZIP and this file INTACT!

---------------------
TRADEMARK INFORMATION
---------------------

All specific names included herein are trademarks and are so acknowledged:

id Software, DOOM, DOOM II, ULTIMATE DOOM, FINAL DOOM, QUAKE, Raven Software,
Heretic, Hexen.
Any trademarks not mentioned here are still hypothetically acknowledged.

============================================================================


  Have someone screw this legal crap.


------------
[1] CONTENTS
------------

   Disclaimer
   Trademark information

1) Contents
2) Overview
3) Installation
     3.1) System requirements
     3.2) Installation instructions
4) Usage
   4.1) General information
   4.2) Playing a demo
   4.3) Recording a demo
5) Version history
     5.1) Bug list
     5.2) To-do list
6) The source
7) Conclusion


------------
[2] OVERVIEW
------------

 DEMON is a third-party add-on for id Software's great Doom-style series
 of games.

 Its purpose is to let you easily determine of which type of .LMP a file
 really is (single- or multiplayer, PWAD or no PWAD, for example).
 It does this by storing .LMPs in directories depending on their type,
 which you have to specify on recording. There are currently five "types":
 Levels, Misc, Multiplayer, PWAD and DHT.
 DEMON currently supports Ultimate Doom, Doom II and Final Doom.
 Support for Heretic, Hexen or any Quake game is neither available nor
 planned (but if I get enough feedback...).
 Oh yeah, DEMON also lets you record and play those demos :).


----------------
[3] Installation
----------------

 [3.1] System Requirements

 There are only minor requirements:
  - your machine must be capable of running Doom,
  - if you want to use the DHT features, you'll need PKUNZIP.EXE somewhere.
  - to have DEMON load .WADs, you'll have to keep them in a 'wads\' subdir
    beneath each game directory (ie. beside each 'lmp\' directory). If you
    don't, it won't work.
  - the 'edit info file' menu item expects that you have 'edit.com' some-
    where in your PATH.

 Oh yeah, you need at least, say, 70 kb free disk space for DEMON :).
 Well, it dwarves the 50+ MB you need for the .LMPs.


 [3.2] Installation instructions

 The installation of DEMON is fairly easy. Just unzip everything into any
 directory (I suggest 'x:\id\demon') and start DEMON.EXE.
 The program will greet you with a setup screen where you can see a menu
 with the four supported games as items. Use your cursor keys to select
 a game and press 'Enter'. In the box that appears, type the path to the
 game you selected (just the path, NOT the .EXE or the .WAD).
 That's it. From now on DEMON supports that specific game.
 Repeat for the other games as necessary.
 Note that in your game directories there will be a directory tree created
 where all your future .LMPs will be stored if you record with DEMON.
 The tree looks like this:

  DOOM              or DOOM2 or TNT or PLUTONIA or whatever
      LMP
          LEVELS    for walkthrough kind of levels
          MISC      for anything that doesn't fit elsewhere
          MULTIPLR  for multi-player recordings (DM and coop)
          PWAD      for .LMPs which need a PWAD to run
          DHT       for DHT exam .ZIPs

 If you want to add (or remove (???)) support for a game, you can find this
 screen again in DEMON by selecting 'SETUP' -> 'ADD/REMOVE GAME'.
 To remove a game, simply clear the box (press 'ESC') and press 'Enter'


---------
[4] Usage
---------

 [4.1] General information

 First, I'll tell you how to navigate through the menus (although it's
 quite straight forward).
 To select a particular menu item, you can use the cursor keys, as well as
 the 'POS', 'HOME', 'PGUP' and 'PGDN' keys. You can also press the number
 that is shown before each choice. It will save you the time to press
 'Enter', which you'd have to do the other way. Pressing 'ESC' exists the
 current menu, dialog or window.
 You'll get the hang of all the program's features after using it for some
 time. I'm sorta fed up with writing manuals...


 [4.2] Playing a demo

 To play a demo, select the game in the main menu ('CHANGE GAME'). You can
 see, which game is currently selected by looking into the upper right
 corner of the screen.
 Then select 'VIDEO' -> 'LOAD'. The next menu lets you choose the category
 of the desired demo. It's really darn simple, so I won't explain it in
 further detail.
 Just a few notes:
  - You can only select .WADs when you are in either the PWAD or MULTI-
    PLAYER category, where the PWAD choice absolutely requires you to
    load a .WAD (i.e. you can't leave the dialog box until you do so).
  - To play a demo in a DHT exam file, first select a .ZIP from 'DHT-
    EXAMS', then choose a .LMP from 'FILE FROM EXAM'.
  - To start the replay, exit the category menu and select 'PLAY' (D'oh).
  - If there is a descriptive text file for the .LMP (or the DHT exam),
    it will be displayed before playing. The name of the .TXT file has
    to be 'LMPFILE.TXT' for 'LMPFILE.LMP'.
  - With the 'SETUP' -> 'TOGGLE FAST PLAYBACK' flag you can choose bet-
    ween normal and fast (or slow on a 386 :) playback speed.


 [4.3] Recording a demo

 Recording is just as simple. Again, I'll not go into details here, just
 point out some points that might be not that obvious.

 Uhm, after thinking about it, the only thing that might be a bit
 irritating is the text box that appears when you press 'START'. I forgot
 to give that box a caption. Sorry :). So, just enter the name for this
 recording.


-------------------
[5] Version history
-------------------

 Hm, looks like this is the first version. But actually, this program was
 originally a 4DOS batch file before I converted it to PASCAL. However,
 I really did a total rewrite, so the only thing these two programs have
 in common is their purpose. But each one has its advantages: for example,
 the 4DOS batch had some features which this one has not (yet).


 [5.1] Bug list

 The dialog boxes and, above all, the .TXT file viewer have some minor
 glitches which I don't like. For example, they start flickering if you
 keep your fingers on the movement keys. Also, the .TXT file viewer has
 a problem when a line in the file is longer than the width of the window.
 However, that is all that I am aware of up to now.
 You can submit bug reports to <oliver.brakmann@privat.kkf.net>


 [5.2] To-do list

 This is rather a "what features this prog is missing"-list, because unless
 I get enough feedback to continue development on this project, there
 won't even be a single bugfix.

 Here it is, short and sweet: DEMON...
  ...doesn't copy available .LMPs into their respective directories upon
     installation
  ...can't associate PWAD .LMPs with the .WADs needed
  ...can't load multiple .WADs
  ...has no support for recent Doom ports, it's just id's original .EXEs
  ...can't record and zip DHT exams
  ...doesn't calculate FPS when replaying Fast Recordings
  ...works with only one Doom version, it won't convert .LMPs from other
     Doom versions
  ...can't play internal demos
  ...can't be associated with .LMPs in Windows, so that you could do a
     double-click on a .LMP in explorer and watch it

--------------
[6] The source
--------------

 I have included the source code of this baby so that you can do the
 changes yourself if you don't like some of this (or want to fix some of
 the bugs).
 The program was written and compiled in Borland Turbo PASCAL 6.0.
 Please excuse me for not commenting _anything_ in the source files. I
 didn't think I'd actually release this thing to the public.
 However, you'll find this code to be pretty readable, except in those
 areas where the parameter lists get exceedingly long.

 If you use some of the code in your own programs, please credit me.

 ***
 One last thing: if you make any improvements or changes to either UI.PAS
 or LIST.PAS, please, please absolutely keep me informed and send me the
 new files. Thanks in advance.
 ***

--------------
[7] Conclusion
--------------

 That's it. I'd still like to thank some people, so here we go...

 Thanks are due to (in no particular order):
 rec.games.computer.doom.editing:
        After reading the TeamFortress Classic NG for some time, I thought
        the Usenet was totally useless. Those people in RGCDE made me take
        faith again. They are also responsible for this program to be
        published. Thanks again.
 .WAD authors:
        They are the reason why Doom is still (now (01/08/00) more than six
        years after its publication) one helluva breathtaking game.
 Headbangers and Doom addicts:
        Never again have I experienced such a feeling of brotherhood and
        companionship like among metal heads and Doom fanatics (at least
        in the net :).
        You guys are great.
 id Software:
        Well, finally they have themselves worn out with Quake ]I[. Up to
        now, no single id game has been a 'walkthru and never play again'-
        game. To me, Quake ]I[ is. Sad but true. There's not a single
        strategic element to Q3 DM. All the maps are WAY to small. Good
        thing we still have Doom :)
        Now I'm waiting impatiently for TF II. That'll be just fucking
        great. Oh well, you ever did the Boot Camp of HL - Opposing Force?
        LOL!

 C ya somewhere,
                 Oliver Brakmann, aka Gremlin
