home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the DOOM Programming Gurus / Tricks_of_the_Doom_Programming_Gurus.iso / bonus / linux / deulinux / deu-linu.txt < prev    next >
Encoding:
Text File  |  1995-03-27  |  6.5 KB  |  150 lines
  1. Linux Port of DEU 5.21                                        8/25/94
  2.  
  3.     This program is free software; you can redistribute it and/or modify
  4.     it under the terms of the GNU General Public License as published by
  5.     the Free Software Foundation; either version 1, or (at your option)
  6.     any later version.
  7.  
  8.     This program is distributed in the hope that it will be useful,
  9.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  10.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  11.     GNU General Public License for more details.
  12.  
  13.     You should have received a copy of the GNU General Public License
  14.     along with this program; if not, write to the Free Software
  15.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  16.  
  17.  
  18. Intro
  19. =====
  20.  
  21. This is a joint port between Brad Hawthorne (u9c192@ugrad.cs.ubc.ca)
  22. and Sam Lantinga  (slouken@cs.ucdavis.edu).
  23.  
  24.       This is presented to you as a tool for building
  25. DOOM wad levels in the Linux environment. It is our hope that when
  26. DOOM for Linux is released, you will be able to make fast changes
  27. to levels while DOOM is running in another virtual console.
  28.  
  29.       It is not an official port, though it has been seen by
  30. the authors of DEU, and it contains known bugs.  The next version
  31. of DEU slated to be released will be DEU 5.22 and will be on the way
  32. very soon.  We will port it as well, and correct any problems found
  33. in this port.  Since the newer versions will be out soon (we all hope),
  34. we will not expend much effort debugging this version of DEU
  35. for Linux.
  36.  
  37.       Please do not send mail to the original authors of DEU
  38. if you have problems with this port.  Send mail to either of us
  39. who ported this beast, and we will do our best to respond.
  40. Remember, this is the first release, so keep up to date, and
  41. see if the problems you are having are fixed in the port of DEU 5.22
  42.  
  43.       DEU 6.0 is in the works and should be done in a few
  44. months.  It is designed with event driven input in mind and will
  45. be the first version of DEU to be handled in the port to X11.
  46. The authors of DEU will likely be working on this themselves.
  47.  
  48. All disclaimers apply!  That said, we hope you enjoy using DEU
  49. for Linux.  It is a great tool, combined with the BSP node builder,
  50. and has produced some of the finest wads on the net.
  51.  
  52.       We don't use DEU enough to be of any major help, so please
  53. do not send us mail asking how to use it.  If you have trouble using
  54. DEU, look on the DOOM only anonymous ftp site infant2.sphs.indiana.edu
  55. for documentation and if you are still stuck, look to the newsgroup
  56. alt.games.doom for helpful advice and hints.
  57.  
  58. Enjoy!
  59.  
  60.  
  61. Setup
  62. =====
  63.  
  64. 1.    Svgalib has been included with this distribution, to ensure
  65. that everyone has a version that works with DEU. If DEU works fine
  66. with your version of svgalib, then you don't have to worry. If it
  67. doesn't, or if you don't have svgalib, read on.
  68.     a) go into the libs directory and type 'make'. This should
  69.        install the libraries and config files for you.
  70.     b) edit /usr/local/lib/libvga.config to reflect your system.
  71.     c) if you have an et4000 card, edit /usr/local/lib/libvga.et4000
  72.        as best you can (its actually the one from my system). If it
  73.        doesn't work, you will need to run tseng3.exe to create
  74.        one specifically for your card. Sorry, you have to get it
  75.        from the svgalib distribution (which can be found on
  76.        dewdrop.water.ca.gov)
  77.  
  78. 2.    In order to use DEU, you must have the files "deu.ini"
  79. and "pc8x14.fnt" in the current directory.  You will probably need
  80. to edit deu.ini so that DEU can locate your main doom.wad.
  81. Note: Your doom.wad will have to be located on a partition mounted
  82. under Linux, which means it cannot be on a stacked partition.
  83.  
  84.  
  85. Running
  86. =======
  87.  
  88.       First of all, this program uses svgalib, so it does not run under X.
  89. Don't even try to run it while in X :)
  90.  
  91.       This program (and any svgalib program) must run with root
  92. privileges.  It is _NOT_ a safe set-uid program.  We are not responsible
  93. for any misuse of DEU or security holes DEU might possess.  If you are
  94. careful, it should be okay, but don't let your kid brother play around
  95. with 'the new DOOM editor', or he may overwrite /bin/sh or something.
  96.  
  97.       Don't Drink and DEU. :)
  98.  
  99. Several new features have been added to this version:
  100.  
  101.     1) From the deu command line you can execute shell commands by
  102.        typing an exclamation point before the command. eg: !ls
  103.  
  104.     2) If DEU receives a SIGTERM while in the level editor, it will
  105.        save the level as deulevel.wad in the user's home directory.
  106.        Note that this is only meant as a safeguard in the case that
  107.        you forget to save the level before you reboot. Don't go
  108.        around throwing SIGTERMs at DEU whenever you want to, since
  109.        it will screw up your display (especially under X)
  110.  
  111. Current known bugs/quirks:
  112. ==========================
  113.  
  114.   <alt>-menu keys won't do anything, nor will shift keys. Use your mouse.
  115.  
  116.   If you've specified microsoft mouse in libvga.config, the middle button
  117.   won't work. (If it does, let me know!) Seems to be because the microsoft
  118.   protocol doesn't support that third button.
  119.  
  120.   You can't run the editor in any video mode other than 0, unless your video
  121.   card supports linear addressing. Don't blame me, pin it on the guy who did
  122.   libgrx ;)
  123.   For what it's worth, here's a quote from the author of GRX for Linux:
  124. ***************************************************************************
  125. ***************************************************************************
  126. ***************************************************************************
  127. ***                                                                     ***
  128. ***  A WORD OF WARNING.  IF YOUR VIDEO CARD SUPPORTS LINEAR ADDRESSING  ***
  129. ***  PLEASE READ THE  README FILES  IN SVGALIB FOR  MORE DETAILS ABOUT  ***
  130. ***  BEING  ABLE TO RUN THIS MODE.  IF YOUR VIDEO SUPPORTS IT BUT YOUR  ***
  131. ***  SYSTEM CONFIGURATION DOES NOT YOU WILL CRASH YOUR SYSTEM!!!!!      ***
  132. ***                                                                     ***
  133. ***************************************************************************
  134. ***************************************************************************
  135. ***************************************************************************
  136.  
  137.   The default font 'pc8x14.fnt' for some reason was too tall, so I used
  138.   pc8x8.fnt and renamed it.
  139.  
  140.   If you edit a level and then read in a pwad and then edit the level again,
  141.   DEU will quit with a little error message. (Is this a bug in DEU itself?)
  142.  
  143. If you discover any bugs that seem to be particular to this Linux version
  144. only, please let us know.
  145.  
  146.  
  147. Brad Hawthorne (u9c192@ugrad.cs.ubc.ca)
  148. Sam Lantinga (slouken@cs.ucdavis.edu)
  149.  
  150.