DEACC.EXE v1.1 and DEACCOS2.EXE v1.1 by Luc Cluitmans
(OS/2 port by Mark Matthews) 


DEACC11X.ZIP contains DEACC.EXE, my hexen script decompiler.
It is the same as DEACC11.ZIP, except that it also contains an OS/2
executable (DEACCOS2.EXE).


*USE*

Type 'DEACC' without arguments to get the usage info.

Examples:
    DEACC sample.o > sample.acs
    DEACC sample.o sample.acs
    DEACC mywad.wad MAP01 map01.acs
    DEACC mywad.wad MAP01 | more


*About Decompilation*

DEACC tries to decompile hexen scripts into ACS files.

Some info that was in the original ACS source for the script is
not available in the compiled form of the script: DEACC will not
be able to recover this information. DEACC is not able to:
- recover the original variable names
- recover any comments
- recover the exact source for constructs that can be written
  in several ways. DEACC tries to generate 'break' and 
  'continue' statements only if no other construct can be found.

I tested DEACC on all scripts of the original Hexen.Wad. The output
it produces for each original hexen script was compilable by ACC.
When ACC compiled the ACS files produced by DEACC, the resulting
behavior lump was exactly equal to the original for all maps (the bug
for MAP22 and MAP39 in deacc 1.0 has been fixed)!


*Frequently Asked Question*
Q: "Hey, I get an error when I try to decompile the behavior of
    MAP07. What is going on?"
A: There is no MAP07 in the original hexen wad! The other missing
   numbers are: MAP14, MAP15, MAP16, MAP17, MAP18, MAP19, MAP20,
   MAP29, and any MAPxy with xy>41.


*Bugs*

None. Well, I know of some constructs that would not decompile
correctly, but you probably will not encounter them :-).


*Acknowledgements*

Thanks to:
- Raven Software and id Software for creating Hexen
- Ben Morris for the Hexen Specs
- John B. Williston for getting me on the track of
  hexen decompilation
- Mark Matthews for the OS/2 port


*History*

21 November 1995
    Released version 1.0 of DEACC

05 December 1995
    Version 1.1:
    - fixed the string variable problem (DEACC 1.0 did not correctly
      decompile scripts containing string variables, like MAP22 and
      MAP39 in the original hexen wad).
    - fixed a few small and barely noticable bugs. 

06 December 1995
    Version 1.1x:
    - included a native OS/2 executable DEACCOS2.EXE.
      (thanks to Mark Matthews)


*Updates*

Updates will be available from ftp.cdrom.com and its mirrors in
the 'utils/level_edit/hexen_scripting' directory.


*Feedback*

If you have comments or bug reports: send me  a message via email:
   L.J.M.Cluitmans@ele.tue.nl



    Luc.

