================================================================
Title                   : Dzip GUI v2.3

Filename                : dzipgui.exe - Executable
                          dzipshlx.dll - Dll for shell extensions
                          dzipgui.txt - This file

Authors                 : Nolan Pflug, Stefan Schwoon

Email Addresses         : radix@planetquake.com, schwoon@in.tum.de

Description             : Dzip is a compression program much like the very
                          popular WinZip.  It can do just about everything
                          WinZip can, but it uses a different format.
                          Sometimes it compresses files sligthly better than zip
                          programs, sometimes not.  But it always gets a better
                          rate for Quake demo files (.dem format), which was why
                          it was originally created.

                          Unlike the compression provided by Demtool's various
                          switches (e.g. -f and -v), dzip's compression is
                          lossless, i.e. no data is thrown away. Dzip also
                          handles pak files. The compression provided by
                          Dzip for .dem files is approximately twice as good as
                          Zip's on average.  For all other file types, dzip is
                          generally very close in performace to normal .zip
                          utilities, sometimes even slightly better.

                          Important: This program comes without any warranties.
                          Since we've released several versions now, we are
                          fairly confident that it works in all cases, but there
                          will probably be still some obscure demo somwhere that
                          will refuse to work :P  But hey, that's what the test
                          feature is for...

                          Check out the Known Bugs section if you're
                          using Netscape!

                          This download is just the GUI for windows.  If you need
                          a linux or solaris version, or if you would like the
                          dzip source code, check out that download.

Installation            : Unzip the .exe and .dll anywhere you want, just so long
                          as they're in the same folder.  When you first run the exe
                          it will set everything up with Windows and warn you if
                          something isn't right.

                          If you have a previous installation of dzip, you might not
                          be able to overwrite the dzipshlx.dll file; you'll have to do it
                          from dos (exit out of windows) or make it the very first thing
                          you do on bootup.  (from to 2.2 from 2.3, the dll didn't change)

Credits                 : Nolan had the idea to this program, maintains the
                          Windows executable and the graphical user interface.

                          Stefan executed Nolan's idea, maintains the program
                          core and the Unix versions.

Additional Credits to   : Anthony Bailey for writing the original Quake demo
                          parsing source and for help with the Visual C++
                          compiler.

                          Jean-Loup Gailly and Mark Adler whose Zlib
                          compression library is used by Dzip (see inside
                          source package for more information).

                          Various people that helped me in the win32 newsgroups.

                          Attila Csernyik for all the icons.

                          Uwe Girlich for the dem specs.

                          All the people at Speedcon for being there
                          and giving us a great time.
                          
================================================================

More detailed instructions

Hey, it's a GUI, I think you can manage :)

================================================================

Version history:

20.11.00: Version 2.3
          Added expandable pak files, now you can see all the files inside a pak and
            extract them individually
          Fixed sort problems when path column was on
          Fixed problems with selection box not always being used correctly
          Added 'ignore path info' to Actions->extract dbox
          Fixed problems with F2 to rename files
          Fixed several really tiny problems
          Added new options and put in an Options dbox instead of checkable menus
          Added an uninstall

25.10.00: Version 2.21
          Fixed being able to type in view window (how did i miss that!)
          Fixed stupid bugs with extraction of pak files and progress bar during extract

24.10.00: Version 2.2
          Fixed rare dem encoding problem with out of order spawnbaseline messages
          Fixed infinite error loops on trying to open corrupt dz files
          You can now drag out from dzip to any location in explorer, like the desktop
          Added optional type and path columns, see options menu
          While adding files, protection against bad .pak files
          File->rename dz box will have current file in box already
          Fixed dialog boxes like actions->extract wouldn't accept very long paths
          Fixed default options weren't being set on first use of dzip
          Lots of other small bug fixes

24.08.00: Version 2.1
          Fixed a few more dem encoding problems (remaic related)
          Better handling of tiny files
          Added support for Nehahra .dem's
          Other small bug fixes
          Changes to the GUI:
           Colorfull toolbar and menus... thanks to Attila Csernyik for the icons
           New icons for dz files, thanks again Attila :)
           Sorting of files by any of the five columns
           Options menu
           Added ability to rename the files in a .dz (F2 or Actions->Rename)
           Added compressing of whole folders by right clicking on them in the shell, or
             by dragging them into the dzip window.  (you can't add folders directly
             from Actions->Add yet)
           Drag files out of dzip to various applications (but not the shell, sorry :P)
           Fixed inflate_feed bug after moving/renaming a dz file
           Fixed an error with date displays (ex: July 31st would display as August 1st)

28.07.00: Version 2.0
          Slightly improved compression
          Significantly faster
          Removed -p option; dzip now remembers if a file
           was in a pak and re-creates the pak automatically
          Fixed bugs for demos edited with demix or other tools
          Date and time of files are preserved
          Now displays compression ratio
          Finally fixed all bugs with wildcard and path expansion
          Vast improvements to the gui:
	     Can add new files to dz's created with v2.0
	     Can delete files from dz's created with v2.0
	     Display file date, compressed size and ratio for v2.0 files
	     Can extract just certain files instead of all of them
	     Dialog box to ask if you want to overwrite a file
	     Can move and rename dz's from the file menu
	     Lists of recently opened files, extract paths and move paths
	     Shell extension:
                Can right click on non-dz files and pick "compress with dzip"
                Can right click on dz files, drag them wherever and pick
                  "extract here"
                Can drag files onto a dz file to add them

04.07.00: GUI version 0.7

01.07.00: Version 1.2
          Fixed wildcard bug in Windows version
          Improved Hipnotic compatibility

21.06.00: Version 1.1
          Added wildcard expansion for Windows (thanks Nolan)
	  fixed a bug during decompression

20.06.00: Version 1.0
          Initial public release

================================================================

Results (from v1):

I tried Dzip on different kinds of demos to see how well it
would compress them; these are the results.

Demos            Zip size   Dzip size   Ratio

SDA Nightmare
run records        3.51M      1.78M     50.6%

SDA Nightmare
100% records       9.55M      5.20M     54.4%

Marathon of Quake
on Nightmare       7.53M      4.48M     59.5%

Collection of
Deathmatch demos   9.53M      5.60M     58.8%

Devil's Covenant
movie demos        1.85M      0.59M     31.8%

================================================================

Future plans:

Add even more goodies

I'm sure there is some interest in expanding the concept of demo
compression to other games/formats like QuakeWorld, Quake2 etc.
Also, I'm fairly confident that the ideas used in Dzip can be
successful for these games, too. However, let me point out that
these games have much less priority for me than Quake has. Maybe
later.

================================================================

Known Bugs:

Saving a dz file in netscape that is on an http connection may
corrupt the file.  The reason for this is the webserver is sending
the file as plain text since it doesn't recognize the extension.
Adding 'application/x-dzip' as a mime-type for .dz files on the
server will fix the problem.

NOTE: if you find *anything* that seems remotely wrong with the GUI,
please tell me about it by mailing me at radix@planetquake.com.  In
the last few days befoer this release, I changed some things that
could have broken some stuff but I didn't get the chance to retest
every feature to make sure they all work.

================================================================

* Copyright information *

Use of this program is free of charge.
Use of the source code is subject to the conditions pointed
out in the readme file accompanying the source code.

* Where to Get This *

The Dzip homepage is at <http://www.planetquake.com/qdq/dzip.html>.

* Related websites *

Quake done Quick website
        http://www.planetquake.com/qdq

Demtool
        http://www.planetquake.com/qdq/demtool.html

The demo specs page
        http://www.planetquake.com/demospecs

Speed Demos Archive
        http://www.planetquake.com/sda
