Linux Port of DEU 5.21                                        8/25/94

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 1, or (at your option)
   any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


Intro
=====

This is a joint port between Brad Hawthorne ([email protected])
and Sam Lantinga  ([email protected]).

     This is presented to you as a tool for building
DOOM wad levels in the Linux environment. It is our hope that when
DOOM for Linux is released, you will be able to make fast changes
to levels while DOOM is running in another virtual console.

     It is not an official port, though it has been seen by
the authors of DEU, and it contains known bugs.  The next version
of DEU slated to be released will be DEU 5.22 and will be on the way
very soon.  We will port it as well, and correct any problems found
in this port.  Since the newer versions will be out soon (we all hope),
we will not expend much effort debugging this version of DEU
for Linux.

     Please do not send mail to the original authors of DEU
if you have problems with this port.  Send mail to either of us
who ported this beast, and we will do our best to respond.
Remember, this is the first release, so keep up to date, and
see if the problems you are having are fixed in the port of DEU 5.22

     DEU 6.0 is in the works and should be done in a few
months.  It is designed with event driven input in mind and will
be the first version of DEU to be handled in the port to X11.
The authors of DEU will likely be working on this themselves.

All disclaimers apply!  That said, we hope you enjoy using DEU
for Linux.  It is a great tool, combined with the BSP node builder,
and has produced some of the finest wads on the net.

     We don't use DEU enough to be of any major help, so please
do not send us mail asking how to use it.  If you have trouble using
DEU, look on the DOOM only anonymous ftp site infant2.sphs.indiana.edu
for documentation and if you are still stuck, look to the newsgroup
alt.games.doom for helpful advice and hints.

Enjoy!


Setup
=====

1.    Svgalib has been included with this distribution, to ensure
that everyone has a version that works with DEU. If DEU works fine
with your version of svgalib, then you don't have to worry. If it
doesn't, or if you don't have svgalib, read on.
       a) go into the libs directory and type 'make'. This should
          install the libraries and config files for you.
       b) edit /usr/local/lib/libvga.config to reflect your system.
       c) if you have an et4000 card, edit /usr/local/lib/libvga.et4000
          as best you can (its actually the one from my system). If it
          doesn't work, you will need to run tseng3.exe to create
          one specifically for your card. Sorry, you have to get it
          from the svgalib distribution (which can be found on
          dewdrop.water.ca.gov)

2.    In order to use DEU, you must have the files "deu.ini"
and "pc8x14.fnt" in the current directory.  You will probably need
to edit deu.ini so that DEU can locate your main doom.wad.
Note: Your doom.wad will have to be located on a partition mounted
under Linux, which means it cannot be on a stacked partition.


Running
=======

     First of all, this program uses svgalib, so it does not run under X.
Don't even try to run it while in X :)

     This program (and any svgalib program) must run with root
privileges.  It is _NOT_ a safe set-uid program.  We are not responsible
for any misuse of DEU or security holes DEU might possess.  If you are
careful, it should be okay, but don't let your kid brother play around
with 'the new DOOM editor', or he may overwrite /bin/sh or something.

     Don't Drink and DEU. :)

Several new features have been added to this version:

       1) From the deu command line you can execute shell commands by
          typing an exclamation point before the command. eg: !ls

       2) If DEU receives a SIGTERM while in the level editor, it will
          save the level as deulevel.wad in the user's home directory.
          Note that this is only meant as a safeguard in the case that
          you forget to save the level before you reboot. Don't go
          around throwing SIGTERMs at DEU whenever you want to, since
          it will screw up your display (especially under X)

Current known bugs/quirks:
==========================

 <alt>-menu keys won't do anything, nor will shift keys. Use your mouse.

 If you've specified microsoft mouse in libvga.config, the middle button
 won't work. (If it does, let me know!) Seems to be because the microsoft
 protocol doesn't support that third button.

 You can't run the editor in any video mode other than 0, unless your video
 card supports linear addressing. Don't blame me, pin it on the guy who did
 libgrx ;)
 For what it's worth, here's a quote from the author of GRX for Linux:
***************************************************************************
***************************************************************************
***************************************************************************
***                                                                     ***
***  A WORD OF WARNING.  IF YOUR VIDEO CARD SUPPORTS LINEAR ADDRESSING  ***
***  PLEASE READ THE  README FILES  IN SVGALIB FOR  MORE DETAILS ABOUT  ***
***  BEING  ABLE TO RUN THIS MODE.  IF YOUR VIDEO SUPPORTS IT BUT YOUR  ***
***  SYSTEM CONFIGURATION DOES NOT YOU WILL CRASH YOUR SYSTEM!!!!!      ***
***                                                                     ***
***************************************************************************
***************************************************************************
***************************************************************************

 The default font 'pc8x14.fnt' for some reason was too tall, so I used
 pc8x8.fnt and renamed it.

 If you edit a level and then read in a pwad and then edit the level again,
 DEU will quit with a little error message. (Is this a bug in DEU itself?)

If you discover any bugs that seem to be particular to this Linux version
only, please let us know.


Brad Hawthorne ([email protected])
Sam Lantinga ([email protected])