Unzip for QDOS
==============

Requirements
------------

        Ql with TK2
        Disk drive
        Plenty of RAM, let's say 512K+
                (that's to do something useful as well as run unzip!)


Unzip
-----

This is a port of the unzip 5.0p1 package. Being written entirely in C,
it is not too hard to modify the programs for QDOS and compile them with
C68; which is what I did.


Programs
--------

There are three programs: unzip, zipinfo and funzip. Most users will
only be interested in the first of these. For full documentation, see
the files unzip_txt, zipinfo_txt and funzip_txt. However, note the
following:

1) Under QDOS, the suffix for a zipfile is '_zip' and not '.zip'.

2) Files created by QDOS zip typically contain extra header information
beyond the usual zipfile headers. This can only be interpreted sensibly
by QDOS versions of unzip, etc --- other versions ignore it (QDOS
generated zipfiles work OK with DOS PKUnzip and Linux Unzip, at any
rate.)

You can see the information in detail with a command like

        zipinfo -v flp2_frob_zip

3) By a command like

	unzip foo bar

I mean

	ew flp1_unzip,#1;'foo bar'

I don't use the SuperBASIC notation much because it's grotesque.


Extensions
----------

You can change the directory which unzip extracts into from the command
line with an option I've added:

        unzip -Dram1_ flp2_frob_zip

I've modified zipinfo so that (by default) it doesn't spit out form
feeds scattered through its -v output; new option -F puts them back.


Hints
-----

To extract all the files in a zipfile, set DATA_USE to point to the
right place and do:

        unzip flp1_frob_zip

(See above for how to write this in SuperBASIC.) To extract a few named
members:

        unzip flp1_frob_zip fred harry

To extract members specified by 'globbing':

        unzip flp1_frob_zip *_c *_h

To list the contents of a zipfile:

        unzip -l flp1_frob_zip
or      unzip -v flp1_frob_zip

If you leave out the #1, you'll get a separate window for unzip. I
suggest you use 'ex' instead of 'ew' in that case.


Compiling
---------

If you have the source distribution, it should contain a 'QDOS'
subdirectory. Use the Makefile in this directory e.g.

        make -fQDOS_Makefile all

(If your version of C68 predates version 4.13b then you should edit the
Makefile, or (better) upgrade immediately, there are compatibility
issues.)

Finally...
----------

This port of unzip was done by:

	Richard Kettlewell

        Churchill College       or      12 Limited Rd 
        Cambridge                       Bournemouth
        CB3 0DS                         BH9 1SS

	rjk1002@hermes.cam.ac.uk	+44 202 522467

4/5/1994 RJK

P.S. You can overrule the message 'press any key' with the extra option
-W on the command line.
