gemini - kennedy.gemi.dev

💾 Archived View for mirrors.apple2.org.za › archive › apple.cabi.net › Utilities › Auto.UnShrink.SHK… captured on 2024-05-10 at 12:24:32.
-=-=-=-=-=-=-

AUTO UnShrinkIt
---------------

This program is freeware.  Please distribute it, but you may NOT sell it
without a license agreement explicitly allowing you to do so.  This includes
bundling Auto-UnShrinkIt with any other products.

Questions, Comments, and Donations are welcome at:

Andy Nicholas
8415 Thornberry Drive East
Upper Marlboro, MD   20772

America-Online & GEnie: shrinkit
CompuServe: 70771,2615

Release Notes
-------------

Version 1.0, 10/13/90 --

This is the first version of auto-unshrink.  This is also a very simple program
with a simple mission: extract stuff from archives which can be built on an
Apple II using any Apple II which can run ProDOS.

If you launch auto-unshrink from a program launcher shell that provides a
startup filename (such as launching from ECP-8 or Dave Lyons' Davex shell),
then that archive will be opened and the contents extracted to the current
prefix.

If you launch auto-unshrink from a program which does not supply a startup
filename, then you will be told what the source folder (current prefix) is and
be allowed to enter the name of the archive to open.  After you successfully
enter the name of an archive to open, you will be prompted for the name of a
folder to extract the contents of the archive INTO.

At any prompt except those asking for a filename, a 40 second timeout is in
effect.  The default option in most cases for a YES/NO situation is YES, and
for most cases where more than one choice is available, the default is chosen
for you.

AUTO is capable of extracting the following types of archives:

NuFX (ShrinkIt)
NuFX (ShrinkIt) inside a Binary II envelope.
NuFX (ShrinkIt) inside MacBinary.
NuFX (ShrinkIt) from America-Online.
Binary II
Binary II inside a Binary II envelope.
Binary II inside MacBinary.
ACU
ACU inside a Binary II envelope.
ACU inside MacBinary.
SQ

NuFX from America-Online has a 32-byte header in front of the actual archive
data if the archive was uploaded to America-Online from a Macintosh.

Scavenge
--------

Q: What do I do if a disk which contains my most precious archive goes bad and
   says it has bad blocks?

A: Copy the disk using a disk-copier which will ignore the bad blocks.  Then,
   using Auto-UnShrink, try to extract the contents of the archive from the
   good disk. 

   Auto-UnShrink will "scavenge" its way through the archive and pick out all
   the stuff in the archive which is still good.


	****


Q: After I did that, I ran regular ShrinkIt on the archive and could not
   extract everything from the archive.  I did the same for GS-ShrinkIt except
   GSHK said that the archive was "Damaged."  Why can't I extract using the
   regular programs?

A: ShrinkIt and GS-ShrinkIt do not have an archive scavenger built in like
   Auto-UnShrink does.  ShrinkIt displays an asterisk beside the archive name
   if the archive is damaged, while GS-ShrinkIt actually says "Damaged," but
   can't really do anything about it (yet).


	****


If auto-unshrink finds a damaged entry in an archive, you will be given 3
choices.  The first is S = Scavenge.  Scavenge works for shrinkit archive by
searching from the end of the last header looking for the alternating ascii
"NuFX" signature within the file.  If it finds one, it switches back into
normal extraction mode.  If it never finds another good header or gets an EOF
or position past EOF error, then the scavenger will say that it has reached
the end of the archive without any success.

In the case of getting munged data when regular shrinkit would give the data
corrupted $81 error, auto-unshrink will close the existing file, set the file's
attributes as best it can, and then automatically enter scavenge mode, and
begin scavenging from the end of the last good header.

The second option usually given is T = Try extracting.  Although this could
lead to an amazing crash, I included it so that people could at least attempt
to extract a file whose header might simply not even exist.

Scavenge also works for Binary II files.  If scavenge is ever kicked in, the
search for a valid header begins from the end of the last known good header.

Scavenge will not work on ACU files.  The main reason for this is that the
ACU file format is protected by a 16-bit CRC only.  This makes looking for
valid headers amongst the data in the file extremely slow.  If someone
really needs this feature, send me a lot of money and I'll add it.

Speech Support
--------------

If you have an Echo or SlotBuster card, auto-unshrink will make use of the card
and speak as it works.  If you have a Street Electronics Echo card, you must
put the PT.OBJ file from Street's distribution disk into the same folder as
auto-unshrink.  If you want the current Text-Talker software to be overwritten
and Text-Talker reloaded (or just initialized for the first time), hold down
the Open-Apple key on your Echo-equipped machine.  If you have previously run
the Text-Talker software, Text-Talker will not be re-loaded from disk unless
told to do so via the Open-Apple key.

If you have an Apple IIGS, you may need to set the system speed to slow.

At any prompt for a name, pressing Control-L (once) will read the contents of
the name as it exists. Pressing Control-X will clear the filename and say that
the name is empty.