            DeuSF version 2.9	 11/94

	 Copyright (C) Olivier Montanuy 1994. 

    DeuSF is inspired from DMADDS by Bernd Kreimeier

 
-------------------Data Utility License---------------------------------
DOOM(tm) is a trademark of Id Software, Inc. The DOOM characters and the
Id Software logo are trademarks of Id Software, Inc. 
DOOM Copyright (c) 1993. Id Software Inc. All rights reserved.
This utility product is not a product of Id Software, Inc. and has not
been approved by Id Software, Inc.
Id Software will not provide technical support for this product.
The purchaser of this utility product may not distribute for money or
other consideration any software data created and/or modified by the
use of this utility product.
------------------------------------------------------------------------


*******************  DeuSF Commands  *************************

SUMMARY:   

 DeuSF replaces DMADDS, because it addapts to all versions of DOOM,
 requires less perverted PWAD structure, and appends to a PWAD rather
 than generate a new PWAD (saves space).

 you have a PWAD containing sprites and flats (and even other entries)
 but all the sprites and flats are not present:
 > DeuSF -app mywad.wad
 And DeuSF will append to your PWAD the necessary sprites and flats
 from DOOM.WAD or DOOM2.WAD
 > DeuSF -res mywad.wad
 Will restore the PWAD to it's original state.

 That kind of PWAD should PREFERABLY be built with DeuTex.

 You *should* take the time to evaluate this tool even if you're not
 convinced at all. Trust that this time won't be wasted.

 Note: version 1.0 of NewWadTool is not as powerful as DeuSF for
 inserting sprite and flats. This should improve in future version,
 achieving compatibility between the two tool.


First let DeuTex/DeuSF locate your REGISTERED doom or doom 2 files.
set environment variable DOOMWADDIR to your DOOM path like:  
set DOOMWADDIR= d:\doom     in autoexec.bat  under DOS  
setenv DOOMWADDIR ~/doom    in .tcshrc under Linux/Unix


COMPLETE COMMAND REFERENCES:

 All the optional commands must appear before the non optional ones
 else they will be ignored.


* Help commands

DEUSF -help
DEUSF -format
	Will print the format of PWAD that DeuSF can recognise

* Optionnal commands

DEUSF  -doom <doom directory>
	OPTIONAL COMMAND
	DEFAULT IS: CURRENT DIRECTORY or \DOOM or \DOOM2
	use that command to indicate the directory where you put your DOOM.WAD and DOOM.EX
	example:        -doom C:\DOOM

DEUSF -sprite
DEUSF -flat
 	OPTIONAL COMMANDS
	to be use with -add or -app, to add only sprites or only flats.
 

* Mandatory Commands

DEUSF -app  <myown.wad>

	Will append to MYOWN.WAD only those sprites of DOOM which
	are not redefined. Saves disk space, compared to -add command.

DEUSF -add  <myown.wad> <allsf.wad>

	Will put in ALLSF.WAD all the sprites and flats of DOOM.WAD
	together with those contained in MYOWN.WAD.

DEUSF -res <myown.wad>

	Restores a PWAD which had been modified with -app command.
	Quite safe.


DEUSF -wadir <thatcool.wad>

	List the entries in the PWAD directory with identification.
	Usefull to check is DeuSF recognise all the entries correctly,
	if there is a problem with -app or -add.


****************** Technical Insight **************************

DeuSF need only be applied to PWADS that contain:
	-some sprites to replace those of DOOM.WAD.
	-some flats to replace those of DOOM.WAD.

DeuSF need no be used if:
	- the PWAD contains *all* the sprites of DOOM.WAD
	- the PWAD contains *all* the flats of DOOM.WAD
	- the PWAD contains sprites which are not referenced in 
	  DOOM.WAD. (a dehacked patch is needed to have them work)
	
DeuSF shall only be used on PWAD that respect a precise format.
	- That format is compatible with the old DMADDS.
	- That format is generated by DeuTex automatically.
If the format is not respected, DeuSF might fail to identify
some entries correctly. This is because there is no type identifier
for entries of IWADs and PWADs.

 Sprites are identified only if comprised between:
 - S_START or SS_START
 - S_END   or SS_END 
 Flats (floor/ceilings) are identified only if comprised between:
 - F_START or FF_START
 - F_END   or FF_END  


About DeuSF:
 The code for DeuSF is 80% the same as that of DeuTex.
 the DeuSF -app command is only a modified version of the amazing
 DeuTex -merge command (the only command that remove all the
 limitations of PWADS :-> )
 

******************* Known problems **********************


-	DeuSF does NOT test that all required sprite viewpoints
		are available, when you change some viewpoints.
		DOOM will lock up if you forget one sprite.
-	If the -app command is interrupted, then the PWAD file
		becomes bigger, due to appended waste data.
		but it is still operationnal.
-	DeuSF says stupid things if no command is given.
		

***************** CONVIVIALITY ************************ 

 DeuSF has NO human interface. I will seriously frown upon complaints
 about the lack of human interface. DeuSF IS MEAN TO BE RUN IN BATCH.

 DeuSF, like DeHacked, is here to help you distribute special PWADS.
 You must write by yourself a batch file to install the PWAD.


 example of DeuSF usage on ALIENDOOM 1.0:

 DeuSF -doom c:\doom -sprite -add ALIENGFX.WAD ALINGRFX.WAD
 or, better:
 DeuSF -doom c:\doom -sprite -app ALIENGFX.WAD
 
