
             NZIP64V2.00
             ------------

      OPYRIGHT 1998 RROL MITH

 HIS IS THE FIRST PUBLIC RELEASE
VERSION OF NZIP64V2, A PROGRAM TO
DECOMPRESS 'ZIP' ARCHIVES CREATED BY
V2.04G OR EQUIVALENT PROGRAMS. T
WILL WORK ON A C64 OR C128 IN 64 MODE.

 HIS PROGRAM IS FREE TO BE DISTRIBUTED
AS LONG AS IT IS UNMODIFIED IN IT'S
ORIGINAL ARCHIVE, USING THE ORIGINAL
FILENAME. (6420.)
 HE FILE IS A SELF-EXTRACTING-ZIP,
-NOT- A 'NORMAL' C64 PROGRAM. LEASE DO
NOT COMPRESS IT WITH SOMETHING ELSE!
(YOU WON'T GAIN MUCH IF YOU TRY)

 F YOU FIND THE PROGRAM USEFUL, 
WOULD APPRECIATE SOME ENCOURAGEMENT TO
CONTINUE DEVELOPMENT.  DONATION OF $10
(OR MORE! (-: ) IS SUGGESTED, THOUGH A
SIMPLE APRECIATIVE EMAIL/LETTER WILL
SUFFICE.
  WOULD ALSO BE HAPPY WITH DONATIONS
OF SOFTWARE (EG. IF YOU ARE A SOFTWARE
AUTHOR OR DISTRIBUTOR), OR HARDWARE (A
128 WOULD BE NICE, AS WOULD UTILITY
CARTS - ,  ETC, OR ANY  DEVICE).
F YOU WOULD LIKE TO DONATE SOME OF THE
ABOVE PLEASE CONTACT ME IN ADVANCE.
 NYONE MAKING A HEALTHY CONTRIBUTION
WILL RECIEVE ACKNOWLEDGEMENT IN THIS
DOCUMENTATION AS WELL AS ON MY WEB
PAGE.

  WOULD LIKE TO THANK ALL THE PEOPLE
THAT HELPED BETA TEST THE PROGRAM AND
PROVIDE FEEDBACK & SUGGESTIONS -
PARTICULARLY THOSE THAT SUPPLIED ME
WITH ZIP FILES CAUSING THE PROGRAM TO
BREAK. ITHOUT THOSE ZIP FILES TRACKING
DOWN THE BUGS WOULD HAVE BEEN NEXT TO
IMPOSSIBLE.
 HOUGH THIS IS A PUBLIC RELEASE, THE
PROGRAM IS FAR FROM FINISHED, THOUGH 
AM CONFIDENT THAT MOST BUGS HAVE BEEN
IRONED OUT. (STILL GOT WRINKLES THOUGH)


ONTACT NFORMATION
-------------------

 HE LATEST NEWS & UPDATES OF UNZIP64V2
CAN BE FOUND ON MY 64 WEB PAGE AT:
HTTP://WWW.ROS.COM.AU/^ERROL/64.HTML
(NOTE THE ^ ABOVE REPRESENTS A TILDE OR
'SQUIGLY LINE')

NTERNET E-MAIL: ERROL@ROS.COM.AU

IDONET ETMAIL: RROL MITH
                 3:712/523.5

 CAN ALSO BE CONTACTED IN ANY OF THE
IDONET , -128 & - ECHOES.

NAIL AIL:
 RROL MITH
  OX 119
 OUND ORNER
  2158
 USTRALIA


MPORTANT OTES
---------------

* HIS PROGRAM IS STILL IN DEVELOPMENT,
AND MAY STILL CONTAIN BUGS. T DOES NOT
HAVE MUCH IN THE WAY OF ERROR CHECKING,
AND MAY CRASH OR ACT UNPREDICTABLY. NY
BUG REPORTS & SUGGESTIONS FOR
IMPROVEMENTS ARE WELCOME. F REPORTING
A BUG  WOULD APRECIATE BEING SENT THE
ZIPFILE THAT CAUSED THE ERROR (IF THE
ZIP FILE IS VALID).

* NZIP64V2 CANNOT DECOMPRESS 'S
CREATED BY 1.XX. OU WILL NEED TO
USE ILL UCIER'S NZIP64 OR AVID
CHMOLLS 128 PACKAGE TO DECOMPRESS
THESE FILES. (THE EXCEPTION TO THIS IS
IF THE FILES ARE ALL STORED, BUT THAT
IS UNLIKELY).
 F NZIP64V2 SAYS '!' WHEN
UNZIPPING THEN YOU PROBABLY HAVE A
1.XX ARCHIVE.

*  HAVE CHANGED THE VERSION CONVENTION
SINCE THE BETA TESTING TO UNZIP64V2.XX
WHERE 2.XX IS THE REVISION NUMBER,
STARTING WITH 2.00 WITH THIS INITIAL
RELEASE. ON'T GET CONFUSED.

* F YOU POSESS OR KNOW OF ANY BETA
VERSIONS OF UNZIP64V2, PLEASE DELETE
THEM. HIS IS ESPECIALLY TRUE OF ANY
PUBLICLY AVAILABLE VERSIONS (EG ON 
OR  SITES). -- THE BETA VERSIONS
HAVE BUGS AND SHOULD BE ELIMINATED.

* HE DISTRIBUTION ARCHIVE -- A SELF
EXTRACTING ZIP ARCHIVE. NFORTUNATELY
THE CODE IS CUSTOM WRITTEN FOR THIS
PACKAGE AND ISN'T PUBLICLY USEABLE.
HERE ARE SEVERE PRACTICAL LIMITATIONS
TO USING ZIP FOR SELF EXTRACTING FILES,
SO DON'T EXPECT A PUBLICLY USABLE
'' (??) MODULE IN THE NEAR FUTURE.
  DIDN'T CALL THE DISTRIBUTION AN 
AS IT WOULD BE CONFUSED WITH Ƞ
FILES.  PROPOSE THE EXTENSION ''
FOR FUTURE ELF ETRACTING IPS. NY
COMMENTS?


AIN ENU
---------

 OST OPTIONS ARE REASONABLY SELF
EXPLANATORY BUT 'LL DETAIL THEM ANYWAY
TO HELP STOP ANY CONFUSION.

1 - HOWS A DIRECTORY OF THE INPUT
     DEVICE, USING THE SOURCE PATH.

2 - HIS TOGGLES THE INPUT DEVICE
     NUMBER. HIS IS THE DEVICE THAT
     THE SOURCE ZIP FILE IS ON. T
     SHOULD AUTOMATICALLY FIND THE NEXT
     VALID DEVICE ON YOUR SYSTEM. ALID
     DEVICE NUMBERS ARE 8 THROUGH 30.

+  - HANGE THE SOURCE PATH. HIS IS
     ONLY OF USE TO USERS OF  TYPE
     DEVICES, AND ALLOWS YOU TO SET THE
     PARTITION & SUBDIRECTORY FOR THE
     SOURCE ZIP FILES. HE PATH YOU
     ENTER IS PRE-PENDED TO THE INPUT
     FILE VERBATIM. T  INCLUDE A
     TRAILING COLON!

3 - HOWS A DIRECTORY OF THE
     DESTINATION DEVICE, USING THE
     DESTINATION PATH.

4 - OGGLES THE DESTINATION DEVICE
     NUMBER (WHERE THE EXTRACTED FILES
     WILL GO). IMILAR TO 2.

-  - HANGE THE DESTINATION PATH. HIS
     IS WHERE EXTRACTED FILES WILL GO.
     EE NOTES ABOVE ABOUT SOURCE PATHS
     & REMEMBER THE TRAILING COLON.

5 - ET ZIP FILENAME. LLOWS YOU TO
     CHANGE THE NAME OF THE INPUT FILE.

6 - OGGLE THE DEFAULT OUTPUT FILE
     TYPE -  () OR  (). HIS IS
     THE FILE TYPE THAT EXTRACTED FILES
     WILL HAVE. OTE YOU CAN MANUALLY
     OVERRIDE THIS WITH INDIVIDUAL
     FILES.

7 - NZIP A FILE. HIS STARTS
     UNZIPPING THE SPECIFIED FILE. EE
     'NZIPPING' LATER ON FOR DETAILS.

Q  - UIT UNZIP64V2.

 ENERALLY TO USE UNZIP64V2, YOU SET
THE APPROPRIATE SOURCE & DESTINATION
DEVICES (AND PATHS IF NEEDED), SET THE
ZIP FILE NAME WITH 5, THEN START
UNZIPPING WITH 7.


NIPPING
---------

 NZIPPING HANDLES FILES WITHIN THE ZIP
ARCHIVE ONE AT A TIME. S EACH FILE IS
PROCESSED, THE FILENAME WILL BE
DISPLAYED, FOLLOWED BY A QUERY WITH
OPTIONS [YNQAPS]. ACH LETTER MEANS THE
FOLLOWING:

Y - XTRACT THIS FILE USING THE DEFAULT
    FILE TYPE.
N - O NOT EXTRACT THIS FILE & SKIP
    TO THE NEXT ONE.
Q - UIT UNZIPPING & RETURN TO THE MENU
A - XTRACT THIS FILE AND  REMAINING
    FILES WITHOUT FURTHER PROMPTS,
    USING THE DEFAULT FILE TYPE.
P - XTRACT THIS FILE AS A  FILE,
    REGARDLESS OF THE DEFAULT TYPE.
S - XTRACT THIS FILE AS A  FILE,
    REGARDLESS OF THE DEFAULT TYPE.

 IMPLY PRESS THE LETTER OF THE OPTION
YOU WANT.
 HE SCREEN BORDER WILL FLASH DURING
INFLATING - THIS IS DEBUGGING INFO FOR
MYSELF, PLUS IT LETS YOU KNOW THAT
SOMETHING IS HAPPENING WHEN INFLATING
FILES.
 LEASE ENSURE THERE IS ADEQUATE DISK
SPACE ON THE DESTINATION DRIVE BEFORE
BEGINNING!


AST, RESENT & UTURE
----------------------

 HIS PROGRAM HAS BEEN IN DEVELOPMENT
PART-TIME FOR OVER 2 YEARS (SINCE LATE
1995).  BEGAN THE PROJECT PRIMARILY AS
A SELF-EDUCATION ON COMPRESSION THEORY.
T WAS ALSO A SHIFT FROM MY PREVIOUS =
EXPERIENCE WHICH WAS ALMOST ENTIRELY
DEMO-CODING.

 HE PROGRAM CODE IS BASED PARTLY ON
PUBLICLY AVAILABLE  SOURCE
(EG. NFO-NZIP) ALONG WITH MANY OTHER
SOURCES OF INFORMATION ON COMPRESSION
THEORY, AND THE DEFLATE ALGORITHM.
 NZIP64V2 USES APPROXIMATELY 35K OF
MEMORY DURING DECOMPRESSION. 32K IS
USED FOR THE SLIDING DICTIONARY, AND
THE REMAINDER IS USED FOR THE VARIOUS
HUFFMAN TABLES. HE DEFLATE CODE ITSELF
IS APPROXIMATELY 2.5K, PLUS VARIOUS
LOOKUP TABLES & VARIABLE SPACE. HE
REMAINDER OF THE PROGRAM IS CODE TO
HANDLE THE ZIP ARCHIVE FORMAT, STORED
FILES, THE USER INTERFACE & MISC. DISK
ROUTINES.

  HAVE MANY IDEAS FOR THE FUTURE, BOTH
MY OWN AND THAT OF THE MANY PEOPLE WHO
HAVE PROVIDED INPUT TO THIS PROGRAM
DURING BETA TESTING. HOUGH  CAN'T
PROMISE TO DO ANY OF THEM, HERE ARE
SOME OF THE IDEAS FOR FUTURE VERSIONS:
(IN NO PARTICULAR ORDER)
 -  CHECKING
 - PEED IMPROVEMENTS
 - ETTER HANDLING OF CORRUPTED ZIPS
 - SER NTERFACE IMPROVEMENTS
 - SE OF 2MHZ MODE ON A 128 IN 64 MODE
 - ATIVE 128 VERSION
 - BILITY TO LIST THE FILES IN A ZIP
   WITHOUT EXTRACTING THEM
 - ICK LIST FOR CHOOSING SOURCE ZIPS
 - OS WEDGE
 - REATION OF STORED ZIP FILES.
 - REATION OF COMPRESSED ZIP FILES (!)
 - ELF ETRACTING IP ROUTINE (??)
 - XTRACTION OF  ARCHIVES
 - ECOMPRESSION OF ZIP1.XX ARCHIVES
   (IMPLODED, SHRUNK, REDUCED)

 HICH OF THESE IS DONE AND WHEN WILL
BE DETERMINED LARGELY BY USER FEEDBACK
AS TO WHAT PEOPLE WANT, HOW MUCH
INSPIRATION ɠHAVE, AND WHAT IS
ACTUALLY PRACTICAL. (H, AND HOW MUCH
ENCOURAGEMENT  GET! (-: )
 OMPRESSION IS A LARGE STEP, AND MAY
BE QUITE DIFFICULT (IF NOT IMPOSSIBLE)
ON A STOCK 64 (OR EVEN GENERALLY).
REATION OF STORED-ONLY ZIP ARCHIVES IS
RELATIVELY EASIER, BUT THE USEFULNESS
OF UNCOMPRESSED ARCHIVES IS PERHAPS
QUESTIONABLE.
  128 VERSION IS DIFFICULT AT PRESENT
AS  DON'T OWN A 128 NOR DO  HAVE
ACCESS TO THE PROGRAMMING INFORMATION
REQUIRED FOR A CONVERSION. O IF
ANYBODY WANTS TO DONATE A C128 AND/OR
128 PROGRAMMERS REFERENCE GUIDE.......

 NYWAY, COMMENTS, CONSTRUCTIVE
CRITICISM OR CASH PAYMENTS ARE ALL
WELCOME! <GRIN>

RROL MITH

(A.K.A TROBE/???)

ND.

