UNSTUFF (tm) version 1.1 for DOS compatible computers.

Freeware StuffIt decompression utility written by Jody P. Nickel
Version 1.1 software update by John Kent
Documentation written by Marco A. Gonzalez
Copyright (c) 1992-1993 Aladdin Systems, Inc. and Raymond Lau.
All Rights Reserved.

-----------------------------------------------------------------------------
INTRODUCTION
-----------------------------------------------------------------------------
UNSTUFF is a program that can decompress the contents of StuffIt archives
including archives created with StuffIt 1.5.1 through StuffIt Deluxe 3.0.3.
Items which have been encrypted or optimized (with a StuffIt compression
optimizer) cannot be unstuffed by this version of UNSTUFF.

You may freely distribute this package to anyone who needs access to StuffIt
archives provided that UNSITINS.EXE (the installer that includes UNSTUFF.EXE
and this file, UNSTUFF.DOC) is distributed in whole. Although you can
distribute this product to your friends for free, it cannot be redistributed
as part of a commercial product without a license from Aladdin Systems, Inc.
Aladdin Systems allows free distribution of the UNSTUFF package on all major
online services, bulletin boards, and user group disks.

What is StuffIt?
StuffIt is the Macintosh industry standard compression and archiving
application. Most Macintosh telecommunication users and users who wanted to
save disk space were never caught without their most recent version of
StuffIt. Aladdin Systems provides the StuffIt program in shareware (StuffIt
Lite) and commercial versions(StuffIt Deluxe). Each has its benefits.

For years, StuffIt Deluxe has been able to access PC compressed archives, but
PC users were not able to access StuffIt archives. Now with this UNSTUFF
program, PC users also can UnStuff files from StuffIt archives. As a PC
user, you'll see thousands of StuffIt archives in the Macintosh (and some
other) forums on online services and BBSs. With UNSTUFF, you'll have access
to these files! As a matter of fact, online services such as CompuServe and
America Online have made StuffIt archives their recommended standard method
of posting Macintosh files.

What is a StuffIt archive?
A StuffIt archive is a file that contains one or more compressed files and
directories. Most StuffIt archives have the ".sit" extension in their
filename so they are easy to recognize.

There are three advantages to storing documents in an archive: (1) archives
usually contain compressed files, and thereby save space on disk and reduce
the time it takes to transmit them over phone lines or networks; (2) files
stored in an archive can be sent over networks and telecommunication lines
as a single file making it easier for other people to retrieve all related
material; (3) associated files can be kept in one archive for easy retrieval
and backup.

Terms and Conventions
An "archive item" is any file or directory located in a StuffIt archive.

"Archive.sit" is used to indicate any StuffIt archive. You should type the
name of the archive that you wish to indicate whenever you see "archive.sit"
used in this documentation.


-----------------------------------------------------------------------------
WHAT'S NEW IN VERSION 1.1
-----------------------------------------------------------------------------

Embedded Archive Support (MacBinary and AOL headers)
------------------------
StuffIt archives that are embedded inside of other files can now be recognized.
This means that even if StuffIt archives have a MacBinary header on them, they
will be UnStuffed. StuffIt archives that have any kind of custom header placed
on them, such as by America Online, are also able to be UnStuffed.

StuffIt 1.5.1 Archives
----------------------
We've fixed every known problem with handling StuffIt 1.5.1 archives except the
one shown below in Known Problems.

DOS File Name Extensions
------------------------
Macintosh file names can have up to 32 characters in their file name and can
include spaces. Since DOS file names can only support 8 characters plus an 3
character extension after a period, some file names need to be truncated while
they are being UnStuffed.
Plain TEXT files will now be named with a ".TXT" DOS file convention extension,
if they don't already have an extension.
(If you have any suggestions for naming conventions for other types of files,
please let us know!)

Known Problems
--------------
The following problem was known to exist at shipping time; however, we
chose to ship this version because it offers significant improvements over
the previous version.
* In some cases, UnStuff/PC doesn't see all the files in a StuffIt 1.5.1
archive, and so the program won't display or UnStuff those files it
doesn't see.


-----------------------------------------------------------------------------
COMMAND LINE OPTIONS
-----------------------------------------------------------------------------

UnStuff Archive Contents
------------------------
YOU TYPE: unstuff archive
OR
YOU TYPE: unstuff archive.sit

EXPLANATION
This command extracts every item from the archive indicated into the current
directory. The above example indicates an archive named "archive.sit". It is
not necessary to type the ".sit" extension. You may include optional
parameters in the command line either before or after the archive name to
modify how the unstuffing process will work. For example, to have UNSTUFF
walk you through an unstuffing process, you can type the following line:
unstuff -i archive
where "archive" is the actual archive name.
See "Interactive Mode" below for detailed explanation of the "-i" option.


Display Help
------------
{none} = display help
-h OR -? = display help

YOU TYPE: unstuff
OR
YOU TYPE: unstuff -?
OR
YOU TYPE: unstuff -h

YOUR COMPUTER DISPLAYS:
UNSTUFF (tm) version 1.1, Freeware decompression utility by Jody P. Nickel
Copyright (c) 1992 Aladdin Systems, Inc. and Raymond Lau. All Rights Reserved.
Extract files from StuffIt (tm) 1.5.1, and StuffIt Deluxe (tm) 1.0-3.0 archives

Usage: UNSTUFF [options] [archivename[.sit]]
Options:
{none} = display help
-c[rlf] = do CR -> CR LF translation on Mac text files
-d = don't create directories
-h OR -? = display help
-i = interactive. Prompt to UnStuff each archived item
-l = list archive contents
-lv = verbose (more detailed) listing
-mb = UnStuff each file into MacBinary format
-n = UnStuff files from archive that are newer than existing files
Any files in the archive that are not on disk will also be
UnStuffed
-o = output, UnStuff to this directory
-r = replace existing files/directories without asking
-t = test the integrity of the archive

Commercial distribution restricted. For information, contact Aladdin Systems,
165 Westridge Drive, Watsonville, CA 95076. (408) 761-6200. fax:(408) 761-6206
CIS:75300,1666 GEnie:ALADDINSYS internet:[email protected] AOL:ALADDIN


Convert Text File Line Endings from Macintosh to DOS
----------------------------------------------------
-c[rlf] = do CR -> CR LF translation on Mac text files

YOU TYPE: unstuff -c archive.sit
OR
YOU TYPE: unstuff -crlf archive.sit

EXPLANATION
In a Macintosh text file, each line or paragraph ends with a carriage return
("CR") character. On a DOS compatible machine, text files typically have
each line or paragraph terminated by a carriage return together with a line
feed character ("CR LF"). If you use this option, UNSTUFF will automatically
convert all carriage returns to carriage returns/line feeds ONLY when
unstuffing text files from an archive.


Don't Create Directories
------------------------
-d = don't create directories

YOU TYPE: unstuff -d archive.sit

EXPLANATION
StuffIt archives may contain directories. If you don't want subdirectories
created, and you want all the files in the archive to be unstuffed into a
single directory, use the -d option.


Interactive Mode
----------------
-i = interactive. Prompt to UnStuff each archived item

YOU TYPE: unstuff -i archive.sit

YOUR COMPUTER DISPLAYS: (example)
UnStuff "filename" to C:\DOCS\filename ?
(Yes/No/Rename/Cancel)

EXPLANATION
Interactive mode leads you through the unstuffing procedure by asking if you
want to unstuff each file. UNSTUFF will accept your first keypress as the
answer to the question. Press "Y" to unstuff the file keeping the same name
as in the archive. Press "N" to skip this file and go on to the next file in
the archive. Press "R" if you want to unstuff the file, but want to give it
a different name. Press "C" to cancel the whole interactive unstuff process,
and get back to the DOS prompt. Interactive mode is useful for unstuffing an
individual file without having to unstuff the whole archive.


List Archive Contents
---------------------
-l = list archive contents

YOU TYPE: unstuff -l archive.sit

YOUR COMPUTER DISPLAYS: (example)
Name Saved
--------------------------------------------- -----
ReadMe.txt 82%
Docs.txt 78%
File3 82%
MyDir 59%
test1 55%
test2 60%
---------------------------------------------------
6 Items 73%

EXPLANATION
The -l option is used to display the names of the files and directories that
are stored in the archive file. The first column displays the name of the
file or directory ("item"). Items that are found within a directory are also
listed but they are indented after the directory name. The second column
shows how much space was saved due to compression. The space savings are
indicated by a percentage. For example, if the percentage shown is 73%, it
means that the file was compressed down to 27% of its original size. The
larger the percentage the more the file was compressed.


Verbose Listing
---------------
-lv = verbose (more detailed) listing

YOU TYPE: unstuff -lv archive.sit

YOUR COMPUTER DISPLAYS:
Name Type Crea Label Date Expanded Stuffed Saved
----------------------- ---- ---- ----- -------- -------- ------- -----
ReadMe.txt TEXT MSWD - 1/28/92 53275 9325 82%
Docs.txt TEXT MSWD - 10/ 9/91 17050 3601 78%
File3 TEXT MSWD - 9/20/91 10031 1737 82%
MyDirectory 2 Items 11/22/92 45792 18362 59%
test1 TEXT MSWD - 5/19/92 6144 2729 55%
test2 TEXT MSWD - 11/11/92 39424 15633 60%
---------------------------------------------------
6 Items 126372 33025 73%


EXPLANATION
The verbose or detailed archive listing shows more specifics than the simple
listing accessed with the -l option.
The Type column shows the "type" attribute that the Macintosh assigns to
this type of file. A typical type is "TEXT".
The Crea column stands for "Creator" which is the attribute that indicates
which application created the file. A typical creator is "MSWD", which
indicates that Microsoft Word created the file.
The Label column displays the Label assigned to the file by the Macintosh
Finder. UNSTUFF will display the default labels, and not labels customized
by users.
The Date column displays the date the archived item was modified.
The Expanded column shows the original size of the item in bytes.
The Stuffed column indicates the size that the item occupies in the archive,
that is, compressed size.
The Saved column displays how much space was saved due to compression. This
is the same column that is displayed in the simple listing ("-l").


UnStuff into MacBinary format
-----------------------------
-mb = UnStuff each file into MacBinary format

YOU TYPE: unstuff -mb archive.sit

EXPLANATION
Each file will be unstuffed and placed into a MacBinary format. Since a
Macintosh file is composed of two pieces (a data fork and a resource fork)
and a DOS machine only recognizes one piece (the data fork), a Macintosh
file cannot reside on a DOS machine and keep its resource fork unless its
stored in MacBinary format. Most telecommunication programs can un-MacBinary
a file and there are also shareware programs that can un-MacBinary a file.


UnStuff Newer Files
-------------------
-n = UnStuff files from archive that are newer than existing files
Any files in the archive that are not on disk will also be
UnStuffed

YOU TYPE: unstuff -n archive.sit

EXPLANATION
Before UnStuffing, each file in the archive is compared to the same-named
file on disk. If a corresponding file is not found on disk, the file will be
unstuffed from the archive. If a corresponding filename is found on disk AND
the file to be unstuffed has been modified more recently than the file on
disk, the file in the archive will be unstuffed.


Output to Specified Directory
-----------------------------
-o = output, UnStuff to this directory

YOU TYPE: unstuff -o B: archive.sit
OR
YOU TYPE: unstuff archive.sit -o B:

EXPLANATION
This option will unstuff files to the specified directory. Notice that
UNSTUFF will accept command line options before or after the archive name.
The most common place to use the -o option is after the archive name.


Replace Existing Items without Asking
-------------------------------------
-r = replace existing files/directories without asking

YOU TYPE: unstuff -r archive.sit

EXPLANATION
If UNSTUFF encounters an item with the same name in the destination
directory as in the archive, it will not unstuff the archived item. To make
UNSTUFF automatically overwrite items with the same name, include the -r
option in the command line.


Test Archive Integrity
----------------------
-t = test the integrity of the archive

YOU TYPE: unstuff -t archive.sit

EXPLANATION
UNSTUFF will check the integrity of the archive by verifying that the files
in an archive are stored correctly and will be unstuffed flawlessly.


-----------------------------------------------------------------------------
LEGAL
-----------------------------------------------------------------------------
Although the UnStuff(tm) software is copyrighted, it is being licensed to
you for your use free of charge. However, ownership of and interest in this
package shall remain with Aladdin Systems, Inc. Use and distribution is
governed by the following terms in an effort to reasonably ensure that no
one other than Aladdin Systems will derive a commercial benefit from
distributing this package.

LICENSE AGREEMENT
"You", "your", and the "user" refers to any person or entity which obtains
or uses this software.

"Software" refers to any computer programs identified at the start of this
documentation file, together with all codes, techniques, software tools,
formats, designs, concepts, methods, ideas, and documentation associated
with the computer program(s). The term also includes all copies of any part
of the software and documentation.

"Aladdin" refers to Aladdin Systems, Inc.

This software is owned by Aladdin and contains valuable and proprietary
information of Aladdin. If you violate any part of this agreement, your
right to use this software terminates automatically. In the event of
termination of this agreement, you must destroy all copies of this software
and derivatives in your possession and cease distributing the same.

This software is being licensed to you as provided by the terms of this
agreement.

You may:
1. Use this software on as many computers as you want at any given time.
2. Make as many backup copies of this software as you like.
3. Alter the software in any manner as you see fit FOR YOUR OWN PERSONAL
USE. Such altered version should not be distributed. The creation of such
derivatives shall not diminish Aladdin's title to this software.
4. Terminate this agreement at any time by destroying all copies of this
software and derivatives of this software and cease distributing the same.

You may not:
1. Create any derivatives works from this software for distribution.
2. Reverse engineer, disassemble, decompile, or otherwise attempt to
discover the logic or source code to this software.

UnStuff may be distributed for non-commercial purposes.

UnStuff may also be freely distributed via wire or electronic communications
(bulletin boards [BBS's] and online information systems) for the sole
purpose of use by their customers.

Contact Aladdin Systems at the address within this document if you wish to
distribute this software in a compilation or commercial usage, or if you
have any questions about re-distribution.

DISCLAIMER OF WARRANTY
In using this software, you understand and agree that this software is
provided "as is" without warranty of any kind. The entire risk as to the
results and performance of using this software lies entirely with you, the
user. Aladdin does not make any warranties, either expressed or implied,
including but not limited to implied warranties of merchantability and
fitness for a particular purpose, with respect to this software.

In no event shall Aladdin be liable for any consequential, incidental, or
special damages whatsoever (including without limitation damages for loss of
critical data, loss of profits, interruption of business, and the like)
arising out of the use or inability to use this software. Because some
states do not allow the exclusion or limitation of liability for
consequential or incidental damages, the above limitations may not apply to
you.

Although Aladdin would appreciate any feedback and bug reports, Aladdin will
not be responsible for correcting any problems which you discover or
otherwise help you maintain and use this software. Furthermore, Aladdin may
at any time replace, modify, alter, improve, enhance, or change this
software.

COMPLETE AGREEMENT
This agreement constitutes the entire agreement and supercedes any prior
agreements between you and Aladdin concerning this software. This agreement
cannot be amended, modified, or waived excepting in writing.

GENERAL
If any provision of this agreement shall be found to be unenforceable, it
shall be deemed severed from the remainder of this agreement.

This agreement shall be construed in accordance with the laws of the State
of California. Any arbitration or litigation relating to this agreement
shall take place in the State of California. The parties further submit to
waive any objections to personal jurisdiction of and venue in any of the
following forums: U.S. District Court for the Northern District of
California, California Superior Court for Santa Cruz County, Santa Cruz
County Municipal Court or any other forum in Santa Cruz County, for any
litigation arising out of this agreement.

U.S. GOVERNMENT RESTRICTED RIGHTS
This software is provided with RESTRICTED RIGHTS. Use, duplication, or
disclosure by the government is subject to restrictions set forth in
subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer
Software clause at 48 CFR 252.227-7013, or in subparagraphs (a) through (d)
of the Commercial Computer Software Restricted Rights clause at 48 CFR
52.227-19, as applicable. The contractor/manufacturer is Aladdin Systems,
Inc; 165 Westridge Drive; Watsonville, CA 95076.

All trademarks are held by their respective owners.


-----------------------------------------------------------------------------
ABOUT ALADDIN SYSTEMS
-----------------------------------------------------------------------------
mailing address: Aladdin Systems, Inc phone:408-761-6200
165 Westridge Drive fax:408-761-6206
Watsonville, CA 95076

online services: AppleLink: ALADDIN
America Online: ALADDIN
CompuServe: 75300,1666
GEnie: ALADDINSYS
internet: [email protected]

Aladdin Systems provides technical support over the phone, fax, and through
the online services listed above. Please visit our forums on America Online,
AppleLink, and CompuServe.

Aladdin Systems, Inc. develops and markets industry standard compression and
utility products for the Macintosh and IBM PC (and compatible) computers.

Contact us for free product information.