===============================================================================
Title                   : The Eternity Engine v3.40.25 "Midgard"
Filename                : ee-3.40.25-win32.zip
Release date            : 08/26/2012
Author                  : Team Eternity
                          James "Quasar" Haley, Stephen "SoM" McGranahan, 
                          Charles "Ladna" Gunyon, and David "DavidPH" Hill
Email Address           : haleyjd@hotmail.com
Other Files By Author   : ee-3.40.25-src.zip 
                          ee-3.40.25-edf.zip

Description             : The Eternity Engine is an advanced Doom source port
                          which uniquely combines a high compatibility rate 
                          with bleeding-edge editing and gameplay enhancements.
                          Eternity supports all versions of Doom, Doom II,
                          Final Doom, HACX, and the FreeDoom project, and it 
                          has in-progress support for Raven Software's Heretic
                          and Hexen and Rogue Entertainment's Strife.
                          
Additional Credits to   : - GPL DOOM Source, Quake 2 Source -
                              id Software                          
                          - GPL Heretic and Hexen Source - 
                              Raven Software
                          - DosDOOM - 
                              Chi Hoang
                          - BOOM by TeamTNT - 
                              Lee Killough, Jim Flynn, Rand Phares, 
                              Ty Halderman, Stan Gula
                          - MBF - 
                              Lee Killough
                          - SMMU, Chocolate Doom - 
                              Simon "fraggle" Howard
                          - PrBoom - 
                              Colin Phipps, Florian Schulze
                          - PrBoom-Plus - 
                              Andrey Budko
                          - ZDoom - 
                              Randy Heit, Graf Zahl
                          - libConfuse Parser Library - 
                              Martin Hedenfalk
                          - SpiderMonkey 1.8.0 -
                              Mozilla Foundation; Brendan Eich et al.
                          - zlib -
                              Jean-loup Gailly, Mark Adler, et al.
                          - libpng -
                              Glenn Randers-Pehrson, Andreas Dilger,
                              Guy Eric Schalnat, et al.
                          - snes_spc 0.9.0 - 
                              Shay Green
                          - DJGPP libc - 
                              DJ Delorie et al.
                          - MinGW libc - 
                              Matt Weinstein et al.
                          - SDL and Support Libraries - 
                              Sam Lantinga et al.
                          - Three-Band EQ and Rational-tanh Clipper -
                              Neil C / Etanza Systems, cschueler
                          - Graphics -
                              Michael "esselfortium" Mancuso, 
                              Sven "ptoing" Ruthner, Bob Satori
                          
Special Thanks to       : - Major Code Contributors -
                              Anders Astrand
                              Cephaler
                              Joe Kennedy
                              Joel Murdoch
                              Julian Aubourg
                              Russel Rice
                              Samuel "Kaiser" Villarreal
                              Yagisan
                          - Patch Contributors -
                              4mer
                              Gez
                              Kate
                              MP2E
                              SargeBaldy
                          - Hosting -
                              Mike "Manc" Lightner
                          - Idea People and Beta Testers -    
                              Catoptromancy
                              CSonicGo
                              ellmo
                              Lut
                              Mordeth
                              printz
                              Xaser
                          - Friends of Team Eternity -    
                              Assmaster 
                              Chris Rhinehart
                              DooMWiz
                              James Monroe
                              John Romero 
                              Toke
                              

===============================================================================
* What is included *

New levels              : 1 (START Map)
Sounds                  : Yes
Music                   : No
Graphics                : Yes
Dehacked/BEX Patch      : No
Demos                   : No
Other                   : Yes (Required data and wad files)
Other files required    : DOOM, DOOM II, Final Doom, HACX, or Heretic 
                          IWAD(s)


* Construction *

Base                    : SMMU v3.21 / v3.30
Build Time              : Eleven years and counting
Editor(s) used          : Visual Studio 2005, Visual Studio 2008, 
                          UltraEdit-32, Slade, Doom Builder
Known Bugs              : Too many to mention here, see below for more info
May Not Run With...     : Anything made for other source ports (duh...)


* Copyright / Permissions *

Authors MAY use the contents of this file as a base for modification or 
reuse, subject to the terms of the GNU General Public License which may be
found inside the file named "COPYING".  Permissions have been obtained from
original authors for any of their resources modified or included in this 
file.

You MAY distribute this file, subject to the terms of the GNU General Public
License.


* Where to get the file that this text file describes *

Web sites: http://eternity.mancubus.net/ee-3.40.25-win32.zip
FTP sites: None

      
===============================================================================
* Disclaimer *

This software is covered by NO WARRANTY, implicit or otherwise, including
the implied warranties of merchantability and fitness for a particular
purpose. The authors of this software accept no responsibility for any ill
effects caused by its use and will not be held liable for any damages, 
even if they have been made aware of the possibility of such damages.

Bug reports and feature requests will be appreciated.

Please email haleyjd@hotmail.com with any concerns.


===============================================================================
* Features New to Version 3.40.25 *

These include some of the major features added in the latest version:

- ACS Improvements -

  * New ACS interpreter by DavidPH.
  
  * Support for ACSE and ACSe ZDoom bytecode formats.
  
  * Support for LOADACS lump and ACS libraries.
  
  * Support for A_START/A_END script lump namespace in WAD files.
  
  * Numerous new internal functions supported for ZDoom compatibility.
  
  * Full savegame support.
  
  * Support for named scripts.
  

- Compatibility -

  * BOOM "use_traditional_menus" behavior is now the default and is no longer
    optional, making skull menus appear correct in most vanilla DOOM mods with
    complex menu graphic replacements.


- EDF Features -

  * EDF 3.0: fully dynamic; all definition types can be loaded from WADs at
    runtime.
    
  * gameproperties block allows overriding many settings of the GameModeInfo
    internal structure (see the Eternity wiki for documentation).
    
  * Support for populating the data of a set of consecutive global states
    using a DECORATE state block in thingtypes, using the firstdecoratestate
    keyword.


- Error Proofing -

  * Most missing HUD screen patch graphics can now be tolerated without 
    exiting the game.
    
    
- Gameplay Features -

  * Walkcam can now fly via use of fly up/fly down/fly center keybindings.
  
  * Enhanced "cooldemo" mode; try "cooldemo random" and "cooldemo follow"
    in the console while a demo is playing!


- Graphics -

  * HUD screen patches now display in their normal 4:3 aspect ratio when a
    widescreen video mode is active. Pillar boxing and backgrounds are used
    to fill in the "wings" of the screen depending on the current game mode.
    

- Heretic/Hexen Support Progress -

  * Support for player flight. Try out "fly" cheat in the console!
    p_pitchedflight cvar allows optional support for flying up or down when 
    looking in the corresponding direction.


- Interface Enhancements -

  * Support for raw mouse sensitivity and custom acceleration options.
  
  * Improved spy mode with support for bidirectional iteration through the
    players in the game (spectate_prev, spectate_next, spectate_self).
    
  * Support for storage of writeable files in a separate "user" directory,
    apart from the base directory. -user command-line parameters and
    ETERNITYUSER environment variable are supported for overriding default
    directory detection.
    
  * A single .lmp demo file may now be dropped onto the executable from
    windowed operating system shells supporting drag-and-drop gestures.
  
  * Support for UNC paths to access files over SMB shares.
  
  * Better configuration defaults for numerous variables enabling more
    modern and agreeable out-of-the-box behavior.
    
  * New menus: Advanced video options, and Master Levels loading.
   

- Optimizations - 

  * Custom runtime type identification system provides faster down-casting 
    than C++ dynamic_cast.

  * Most caching code has been removed, enabling stream-lining of status bar,
    HUD, and screen border code to avoid long-winded, complex, bug-prone erase
    and redraw code.
    
  * New fast, re-entrant, side-effect-free line of sight algorithm based on
    code from DOOM 1.2 and Heretic provides a significant speed-up to levels
    with large numbers of monsters.
  
  * Direct-threaded ACS interpreter loop available to GCC builds.
  
  * Hash key interfaces use static functions for less stack noise.
      

===============================================================================      
* Coming Soon *

These are features planned to debut in future versions of the Eternity 
Engine:

- Priority -

  ** EDF Inventory/Weapons/Pickup system (Currently in progress!)
  ** 100% Heretic support
  ** UDMF support
  ** Aeon scripting system (Currently in progress!)
  Hexen Support
  Strife Support
  Fully functional linked portals
  Double flats  
  More standard TerrainTypes
  
  ** == TOP PRIORITY

- Long-Term Goals -

  Improved network code


===============================================================================
* Revision History *

3.40.25 "Midgard" -- 08/26/12

  Interim release to hold over the fans until Aeon and inventory branches are
  ready. New improved ACS interpreter by David Hill.

3.40.20 "Mjolnir" -- 12/25/11

  Santa Quas brings a new Christmas release with some cool new features.

3.40.15 "Wodanaz" -- 06/21/11
  
  First release with ability to draw on a hardware-accelerated device context.

3.40.11 "Aasgard" -- 05/02/11

  Minor maintenance release to fix saving of levels that contain polyobjects.

3.40.10 "Aasgard" -- 05/01/11

  "Blue Box" release to showcase Vaporware project demo.

3.40.00 "Rebirth" -- 01/08/11

  10th anniversary release, and the first release from the C++ codebase.

3.39.20 "Resheph" -- 10/10/10

  Point release for additional HACX 1.2 support.

3.37.00 "Sekhmet" -- 01/01/10

  Big release after nearly a year of development time with some major 
  advancements, though many are behind-the-scenes improvements.

3.35.92 "Nekhbet" -- 03/22/09

  Minor maintenance release with numerous interface improvements, and a new
  EDF font specification system.

3.35.90 "Simorgh" -- 01/11/09

  It took two years and almost 450 SVN revisions to create this new
  incarnation of the Eternity Engine.

3.33.50 "Phoenix" -- 10/23/06

  Sad times have given way to happy ones as the energy to do great work
  has been unleashed.

3.33.33 "Paladin" -- 05/17/06

  The most work ever done for a single release possibly excepting only the
  port of v3.29 Gamma to Windows. We apologize for the delay, but it is
  well worth the wait.

3.33.02 "Warrior" -- 10/01/05

  A very respectable amount of progress hopefully offsets the terrible 
  delay experienced for this release. 3D object clipping improvement,
  new EDF TerrainTypes engine, and various EDF improvements are the
  most significant features.

3.33.01 "Outcast" -- 06/24/05

  Minor fixes, some user-requested and CQIII-needed features implemented,
  and HUD scripting functions for Small.

3.33.00 "Genesis" -- 05/26/05

  Small scripting finally complete and available to the user. Lots of
  fixes, tweaks, and feature additions on top of that.

3.31.10 "Delta" -- 01/19/05

  More Small support, ExtraData, global MapInfo, and tons of other new 
  features and bug fixes make this an extremely critical release.

3.31 Public Beta 7 04/11/04

  High resolution support enabled via generalization of the screen 
  drawing code. Some minor fixes to portals, and a new codepointer just 
  for good measure.

3.31 Public Beta 6 02/29/04

  A huge amount of progress toward all current goals for the engine.
  Portals, the brain child of SoM, are the major stars of this release.
  Small and ExtraData are on the verge of becoming available to users 
  for editing.

3.31 Public Beta 5 12/17/03

  Several minor bug fixes over beta 4, including 3D object clipping and
  file drag-and-drop. Incremental improvements to EDF and to several
  parameterized codepointers.

3.31 Public Beta 4 11/29/03

  Most effort put into improving EDF, largely via user feature requests.
  Major progress has been made toward working ExtraData as well. The
  Heretic status bar is now implemented.

3.31 Public Beta 3 08/08/03

  A long time in coming, and a ton of features to show for the delay.
  EDF steals the show for this release.

3.31 Public Beta 2 03/05/03

  New BFGs, object z clipping, movable 3DMidTex lines, tons more Heretic
  support, and some really nasty bugs fixed. Also first version to use
  SDL_mixer for better sound.

3.31 Public Beta 1 09/11/02

  Prelim. Heretic support, 3DMIDTEX flag, zdoom-style translucency, and
  some other stuff now in. And of course, bug fixes galore.

3.29 "Gamma" 07/04/02

  Final release for v3.29. Massive changes all over. First version to
  include Windows support. SoM is now co-programmer.

3.29 Development Beta 5 10/02/01

  Minor release to demonstrate dialog, primarily

3.29 Public Beta 4 06/30/01

  Fixed a good number of bugs once again. Improved portability with 
  Julian's help, major feature is working demo recording. See info below
  and changelog for more info, as usual.

3.29 Public Beta 3 05/10/01

  Fixed a large number of bugs, added several interesting features. See
  bug list below, and the changelog, for more information.

3.29 Public Beta 2 01/09/01

  Fixed mouse buttons - problem was leftover code in I_GetEvent() that
  caused the mouse button variables to never be asserted - code was
  unreachable because of an assignment of the variable 'buttons' to 
  'lastbuttons'.
  
3.29 Public Beta 1 01/08/01

  Initial Release


===============================================================================
* Bugs Fixed, Known Issues *

Bugs Fixed (since 3.40.20):

+ Polyobj_StartLine and Polyobj_StartExplicit are recognized as ExtraData-
  enabled line types if used directly in DOOM-format maps.
  
+ No crash if IO disk is enabled during a runtime video mode change.

+ Changing value of "use correct heights" at runtime will not change some
  objects such as dead monsters to incorrect height values.

+ Aiming works correctly when firing bullet tracer weapons with autoaim off.

+ Correct psprite is manipulated by gun action functions when recursive calls
  to P_SetPsprite occur.

+ Various changes in the sound engine hopefully stop additional instances of
  player sounds being cut off.
  
+ No more crash if any castinfo entries after the first 17 do not define a 
  name in EDF.
  
+ "goto" is no longer treated as case-sensitive inside DECORATE state blocks.

+ mn_selectmusic menu does not start out empty before the first time a music
  change occurs.
  
+ Advanced menu filebox widgets do not crash the game if empty.

+ -net parameter does not crash the game if given insufficient arguments.


Known Issues in v3.40.25:

- Start map is currently disabled, and may be restored in a later version.

- Volume sliders may permanently affect desktop volume levels. This is due
  to bugs/limitations/oversights in SDL_mixer and NOT because of any
  problem inherent in Eternity.

- Network code is incomplete; game may desync if some settings differ
  between nodes, or if certain console commands are used at runtime.