bz2extract.exe (version 1.0)
	by Iapetus, the Titan
------------------------------------------------------------------------------

The bz2extract program allows you to extract particular files or sets of files
from Battlezone II's internal data files (the .pak files).  The extracted
files are unpaked and then automatically decompressed if necessary.  The
extracted files will be placed in the current directory, presumably a
directory you've created to hold them.

You don't need to run the bz2expand program seperately.  However, bz2extract
does use the bz2expand program to perform decompressions, so it must be in
the current directory when you run bz2expand.


------------------------------------------------------------------------------

bz2extract usage (from a DOS window):
	bz2extract <pak file> <file to extract>

The <file to extract> may contain the standard Unix wildcards '*?' (which
behave the same as DOS/Windows wildcards except that the filename and
extension are treated together, making periods just normal characters).


Examples:

To extract the object definition file for the standard ISDF walker:
	bz2extract data.pak ivwalk.odf

To extract all the object definition files (odf's):
	bz2extract data.pak *.odf

To extract all the data files from data.pak:
	bz2extract data.pak *.*		or just		b2extract data.pak *

To extract all the files for the HiLo multiplayer map from data.pak:
	bz2extract data.pak hilo.*

To extract the Mars terrain textures from smtex.pak:
	bz2extract smtex.pak mars?.tga


------------------------------------------------------------------------------

File types/extensions in data files:

data.pak:  aip, cfg, inf, msh, odf, otf, pic, tga, wav, map types (bzn, sky,
ter, trn, wat, related others), misc. others.

smtex.pak:  pic, tga (and one odd odf)

bumps.tex:  pic, and one bmp


------------------------------------------------------------------------------

Possible future modifications:
-- Integrate bz2expand into bz2extract if I can get either compression specs
   or bz2expand source code.

-- Add switch to only list the files inside the .pak files


------------------------------------------------------------------------------

DISCLAIMERS:

I have performed basic testing of this program, and it contains error
checking routines that should prevent damaging problems, but I make absolutely
no guarantees regarding the safety or utility of this program.


This program is provided AS IS, WITHOUT SUPPORT, and is used AT YOUR OWN RISK!


While I would definitely like to hear of any problems encountered with this
program or ideas for it's improvement, I make no guarantees of future support.



The extracted files are legally the intellectual property of Pandemic Studios
and/or Activision.  These programs are being distributed only to aid user map
creation, as governed by the Battlezone II editor's license agreement.


------------------------------------------------------------------------------

Thanks to:  Whoever wrote the first unpaker and provided the source code
(Slight?),  Nypyren for telling me how to fix that unpaker, and Johnny
for creating the bz2expand program.


------------------------------------------------------------------------------

Gladly Serving the BZ2 Community,

~AA~ Iapetus, the Titan
iapetus@angryangels.com
(Battlezone II Team Commander for the Angry Angels Gaming Community)
