home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Mega Top 1
/
os2_top1.zip
/
os2_top1
/
APPS
/
ARCH
/
11UNZS
/
UNZSH.DOC
< prev
next >
Wrap
Text File
|
1994-12-01
|
23KB
|
523 lines
Power Programming, Inc. proudly Presents:
-- The UnZip Shell - UNZSH.EXE --
OS/2 PM front-end for ZIP Files
Shareware Version
Version 1.1s
12/1/94
-- Legal Issues --
---------------------------------------------------------
The UnZip Shell is Copyright (C), John Wagner 1994. All Rights Reserved.
---------------------------------------------------------
The UnZip Shell is Shareware
---------------------------------------------------------
If you have the shareware version:
You may evaluate the program for TWO WEEKS. If you wish to continue
using the program after TWO WEEKS, you must purchase a registered copy
from John Wagner.
If you don't wish to continue using the program after two weeks, you
must stop using the program. All users are allowed and encouraged to
pass on copies of the SHAREWARE version of the program.
There are two versions of The UnZip Shell, one is the SHAREWARE version
and the other is the REGISTERED VERSION. The two programs are identical
in function, but there are some additional features in the REGISTERED
version.
---------------------------------------------------------
The UnZip Shell SHAREWARE VERSION:
---------------------------------------------------------
Default settings are not editable. You can modify the
settings while the program is running, but the settings
aren't saved.
Cannot use Object Association when inspecting items
in ZIP files.
Cannot use the Multiple Selection feature to selectively
extract a user selected list of files from the archive.
Uses the OS/2 E.EXE editor as a file viewer.
"SETUP" option works, but the changes you make aren't
saved.
Reminder window pops-up when you view a file, when you
enter the "SETUP" window, and when you quit the program.
The SHAREWARE version allows for a full evaluation of
the program to see if it suits your needs.
---------------------------------------------------------
The UnZip Shell REGISTERED VERSION:
---------------------------------------------------------
Defaults can be modified and saved.
Allows the use of any editor to view files.
Enables the multiple select feature so the user can selectively
extract one or many files from an archive.
Optionally uses the OS/2 Association feature when a
file is selected for viewing by calling the appropriate
(default) associated object. This means if you select a
file with a .ICO extension, the OS/2 Icon Editor will
be called up with the icon loaded into it.
"SETUP" option saves the settings.
No reminder window - A clear conscience!
Includes a FREE bonus program!
---------------------------------------------------------
If you have purchased a registered version:
---------------------------------------------------------
Thank you! Please make sure that you do not give anyone your registered
software, as doing so would seriously hurt my business (and be really
uncool!). Please do not upload it to BBS's, do not give a copy to a
friend, or offer it for distribution in any way shape or form. You will
find a copy of the SHAREWARE version of the program on your distribution
disk, so if someone wants a copy, please give them the SHAREWARE version
only. Thank you again for supporting my efforts to bring you quality
software at an honest price.
---------------------------------------------------------
Info-ZIP UNZIP:
---------------------------------------------------------
Prior versions of the The UnZip Shell required the use of a seperate
Info-ZIP UNZIP.EXE program. Near as I can tell, Info-ZIP is a collection
of very talented programmers who created and maintain UNZIP (and a
number of other ZIP utilities). They do so free of charge, and
distribute the source code to the programs. UNZIP is portable across
many platforms and is quite a piece of work.
The UnZip Shell is now a stand alone program. The source code to the
original UNZIP has been used heavily in the implemenation of The UnZip
Shell. Because of this, the original source code to UNZIP is still
included on the distribution disk of the registered verison of The UnZip
Shell. There are two explicit copyrights listed in the COPYING file
included with INFO-Zip UNZIP. I've read through them, and to the best of
my knowledge (I'm not a lawyer), I am in compliance with all of them.
The UnZip Shell does not use VMS.C, so that copyright shouldn't be in
effect. I have been in contact with Mr. Samuel Smith concerning his
copyrights on UNREDUCE.C and UNSHRINK.C and have his blessing to use the
code.
The following copyrights to UNZIP source follow:
(On UNREDUCE.C and UNSHRINK.C)
Copyright 1989 Samuel H. Smith; All rights reserved
(On the rest of the UnZipping code - from the file "COPYING")
The remaining code was written by many people associated with the
Info-ZIP group, with large contributions from (but not limited to):
Mark Adler (inflate, explode, funzip), Kai Uwe Rommel (OS/2), John
Bush and Paul Kienitz (Amiga), Antoine Verheijen (Mac) and Greg
Roelofs (lots of stuff). See the file CONTRIBS in the source dis-
tribution for a much more complete list of contributors. Also note
that, while this code may not be explicitly copyrighted, we do re-
quest that no one else try to copyright it, either. In other words,
use it with our blessings, but it's still our code. (You can con-
sider that an implicit copyright if it makes you feel better. :-) )
Thank you!
To further clarify, the following is extracted from the file COPYING
in the Info-ZIP UNZIP package:
Q. Can I use the source code of Zip and UnZip in my commercial
application?
A. Yes, so long as you include in your product an acknowledgment
and an offer of the original compression sources for free or
for a small copying fee, and make clear that there are no extra
or hidden charges resulting from the use of the compression
code by your product. In other words, you are allowed to sell
only your own work, not ours. [Note the additional restrictions
above on the code in unreduce.c, unshrink.c and vms.c.] If you
have special requirements, contact us at zip-bugs@wkuvx1.wku.edu.
So therefore:
It should be noted that the registration of The UnZip Shell does not
cover the free portions of Info-ZIP UNZIP, only the portions that I have
added, the OS/2 PM front end.
The original source for UNZIP is available widely on BBS's and on the
internet. If you do not have access to either, I will gladly send you a
copy of the original source code to UNZIP.EXE for a copying and handling
fee of $10. Please note that I do not wish to charge anyone a copying
and handling fee, but I must do so to cover my operating expenses. I
would rather you obtained the original UNZIP source code at no charge
via BBS or the internet.
---------------------------------------------------------
How to Register The UnZip Shell:
---------------------------------------------------------
Registration for The UnZip Shell is a mere $12 U.S. That price includes
shipping (in North America) and floppy disk media. There are three
methods of registering The UnZip Shell...
Register via CompuServe:
Type GO SWREG to enter the CompuServe Shareware Registry. Register
product 2576. The price is $12 U.S. If you are an overseas customer, you
_will not_ be charged the $2 shipping and handling fee that is added
when you order by mail.
Register by mail:
Orders being sent outside of North America, the price is $12 U.S. plus
$2 U.S. for shipping and handling. Please send checks drawn from a U.S.
bank, or money orders that are drawn in U.S. funds, made out to John
Wagner (or Power Programming, Inc.).
Register by Shareware!:
If you are an OS/2 shareware author, I would like extend my thanks to
you by offering a free copy of The UnZip Shell to you in exchange for a
free copy of your OS/2 shareware program. Just mail me a copy of your
program (the same version you would mail someone who registers your
program), and I'll send you a registered copy of The UnZip Shell.
When you register, you will receive the latest version of The Unzip
Shell on a 3.5 inch disk. Please see the matrix above for the
differences between the SHAREWARE and REGISTERED versions of the
program. Also, please note that 5.25" disks are not available.
The address for registering The UnZip Shell is:
Power Programming, Inc.
Attn. John Wagner
RR 1 Box 107
Derby Line, VT 05830
For your convenience, a file called INVOICE.DOC is included that
contains all of the information I'll need to get your order processed.
To expedite your order, please print INVOICE.DOC, fill out the requested
information and send it in with your order.
---------------------------------------------------------
Upgrade policy:
---------------------------------------------------------
Since the low, low price of $12 pretty much rules out mass mailings to
registered users, I will be unable to notify registered users of
upgrades. I will release upgrades to the shareware version of the
program which will reflect the latest features of the registered
program. If you are a registered user, and come across a newer version
of the program, and you would like upgrade to a registered copy of it,
send $5 and I'll send you a disk as mentioned above.
Indicate on your order that you are a registered user and the current
registered version # that you have. If you are using the latest version,
I'll deposit your check, but hold your order until an upgrade is
available, at which time your order will be sent promptly.
Distributing The UnZip Shell:
The SHAREWARE version of The UnZip Shell may be distributed as long as
the ENTIRE package is distributed together, and no additional files are
added to the archive. The following is a list of files included in the
SHAREWARE UnZip Shell archive:
UNZSH.EXE
INSTALL.CMD
UNZSH.DOC
INVOICE.DOC
FILE_ID.DIZ
VENDOR.DOC
Please make certain that all of the files are included when distributing
the archive. If you have the REGISTERED version of the program, PLEASE
DO NOT distribute it. If you have the REGISTERED version of the program,
I have included a copy of the latest SHAREWARE version on the diskette I
sent you under the filename xxUNZS.ZIP (where xx is the version and
sub-version).
---------------------------------------------------------
Disclaimer - PLEASE READ:
---------------------------------------------------------
The UnZip Shell is provided "as is", with NO GUARANTEE that it works as
described here, or anywhere else. USE IT AT YOUR OWN RISK.
---------------------------------------------------------
What The UnZip Shell does:
---------------------------------------------------------
The UnZip Shell is an OS/2 PM front end for ZIP file archives. The
following instructions will guide you step-by-step to installing UnZip
Shell and integrating it into the Workplace Shell. The UnZip Shell
allows you to activate files in your ZIP archives without unzipping the
whole archive. This is handy for viewing text files, etc... Using the
OS/2 Object Association feature, you can activate any object that is
associated with the files contained within your archive files. Please
note that the REGISTERED version of The UnZip Shell is required if
you want to use Object Association.
---------------------------------------------------------
Quick and Dirty installation:
---------------------------------------------------------
If you are an OS/2 and WPS expert, you can can get up and running
quickly by following these brief instructions:
Make sure you have a TEMP or TMP variable set in you CONFIG.SYS
file
Use INSTALL.CMD
Copy both UNZSH.EXE and INSTALL.CMD to the directory you want to have
The UnZip Shell installed in. Run INSTALL.CMD. INSTALL.CMD will
create a WPS object, and associate it with files ending in .ZIP.
- or -
Put UNZSH.EXE somewhere on your hard drive
Create a program reference object for UNZSH.EXE
Set the association for the object you just created to *.ZIP
Optionally, you can add a default target path as a parameter in
the settings notebook like so: -d=path
---------------------------------------------------------
How to install The UnZip Shell:
---------------------------------------------------------
Make sure you have a TEMP or TMP variable set in your CONFIG.SYS file:
-CONFIG.SYS-
SET TEMP=C:\TEMP
Make sure C:\TEMP exists! The UnZip Shell uses the directory specified
in the TMP or TEMP environment variable as a work directory. The UnZip
Shell will run if you don't have a TMP or TEMP environment variable, but
it will use the root directory of the drive that OS/2 started from.
I would like to point out that running The UnZip Shell without a TMP or
TEMP variable set is a potentially dangerous situation in the rare case
that you have a ZIP file with a file in it called CONFIG.SYS, and you
attempt to read it, and ignore the warning that reading the file will
overwrite a file that exists... make sure you have a TMP or TEMP
environment variable set, it's the right thing to do!
These directions will assume you have unpacked the distribution archive
into the directory C:\TEMP and you want to install the program into the
directory C:\OS2\APPS.
First, start an OS/2 command line session.
Copy UNZSH.EXE to the C:\OS2\APPS directory:
COPY C:\TEMP\UNZSH.EXE C:\OS2\APPS
COPY C:\TEMP\INSTALL.CMD C:\OS2\APPS
Now, make sure you are in the C:\OS2\APPS directory by entering the
following:
C:
CD\OS2\APPS
Run the INSTALL.CMD program:
INSTALL
The INSTALL.CMD program will create a WPS shell object, and associate
the object with WPS file objects that end in .ZIP. Anytime you see a WPS
file object, it will have the icon of The UnZip Shell. By double
clicking on the WPS file object, you will automatically invoke The UnZip
Shell, with that file loaded.
If you always unzip files to the same directory, you should open
up the settings notebook of the new UnZip Shell object, and enter
the following into the PARAMETERS field:
-D=DRIVE:\DIR
WHERE: DRIVE: is the drive to (exp. C:)
WHERE: \DIR is the path on the drive (exp. \TEMP)
EXAMPLE: -D=C:\TEMP
---------------------------------------------------------
You can also run The UnZip Shell from the command line:
---------------------------------------------------------
USAGE: UNZSH [-D=path to unzip to] [filename.zip]
WHERE: [path to unzip to] is optional, do not include the []'s - it
specifies the target drive/directory to place the unzipped
files. Do include the -D= though.
WHERE: [filename.zip] specifies the file to unzip.
If you don't specify a file to unzip (by running the program without the
command line parameters) you can still load a ZIP file from within the
program by clicking the "FILE OPEN..." button.
---------------------------------------------------------
Running The UnZip Shell:
---------------------------------------------------------
Regardless of how you start The UnZip Shell, you will have the following
options...
Actions before unzipping:
Viewing text files in the ZIP archive:
You can double click on a filename in the file listbox and The
UnZip Shell will bring up the OS/2 'E' editor with the selected
file loaded. When UnZip Shell exits, it shuts down any 'E'
sessions that may have been started and erases any files that are
being viewed. All of this takes place in the directory specified
in your TEMP or TMP environment variable.
Existing file Options:
These options control what The UnZip Shell does when it tries to
extract a file from a ZIP file, and the file already exists in the
directory that it is extracting to.
Embedded directory Options:
ZIP files can have sub-directories embedded in them. It is usually
desirable to re-create these sub-directories when unzipping the
file. By default, The UnZip Shell will create the sub-directories.
If you select "Junk directories" then the sub-directories won't be
created, and all of the files will be extracted into the Target
Directory.
Specify the drive/dir you want to unzip the files to (Target Directory):
If you specify a directory that doesn't exist, The UnZip Shell
will make sure you want to create it. NOTE: UnZip Shell will only
create a directory one level deep, and it can't create drives that
don't exist<g>.
Enable Multiple Selection:
By selecting this option, you can select which files are extracted
in the archive. Note that when this option is CHECKED, you cannot
view items in the list by double clicking on them.
Viewing the ZIP comment:
If the currently loaded ZIP file has an embedded comment, the
COMMENT button will be enabled. Click on this button to view the
comment. After you are done viewing the comment, click the DONE
button on the comment viewing window.
Opening another ZIP file:
If you click the "FILE OPEN..." button, you can select another
file to unzip.
Drag-and-Drop:
You can also drag a ZIP file from the WPS onto The UnZip Shell
to open it. The list that displays the file contents is a good
target for Drag-and-Drop, or any other part of the window that
doesn't have a control on it.
Setup the program configuration: (REGISTERED VERSION ONLY)
If you click the "SETUP" button, you will be presented with a
dialog window that contains the program startup defaults. From
this window, select the settings you want the program to start up
with every time.
You can also select a different editor or file viewer to use when
you select a file to view. If the program you choose to view files
is not in your path, be sure to include the fully qualified path
name to the program (ie: C:\DOS\EDIT.COM) (like an OS/2 user is
going to use DOS EDIT!). Also, be sure to include the extension of
the program (ie: EPM.EXE) (that's more like it!).
The registered version of The UnZip Shell allows you to use the
object association feature of the WPS. To do so, select this
option while in the setup dialog.
Actions after unzipping:
Create a WPS Shadow of the dir the files are being placed in:
This is the default setting. Click the checkbox off if you don't
want this to happen. As the object that is created is a shadow, it
can be safely deleted without affecting the actual directory. If
you delete the file objects however, the files will be deleted.
Create an OS/2 session:
Select this option if you want The UnZip Shell to start an OS/2
command line window for you after unzipping the files. The session
will be started and the active drive/dir will be the one that the
unzipped files were placed in.
How to exit:
Select "EXTRACT":
If you select "EXTRACT", The UnZip Shell will start it's thread
that unzips files (go OS/2!). Depending on the options you've
chosen for "Actions after UnZipping", you will see a shadow object
of the directory the files are placed in, and or an OS/2 Command
Window.
Select "CANCEL":
If you select "CANCEL", The UnZip Shell will confirm that you want
to cancel.
Exit with the "System Menu":
If you select "Close" from the System Menu (upper left corner),
The UnZip Shell will close immediately without confirming you want
to quit and without unzipping any files. The SHAREWARE version
will still display it's reminder window (only $12 to register!).
IMPORTANT!!!:
Regardless of how you exit the program, The UnZip shell will
shutdown any viewers or programs that you started while viewing a
files contents, and delete the temporary files that it created.
---------------------------------------------------------
Contacting the author:
---------------------------------------------------------
John Wagner is available on on CompuServe, account # 72122,2412
(72122.2412@compuserve.com for internet). He can also be reached by
phone at (802)895-4512 - after 5pm and before 10pm EST. The author
suggests (and requests) that you attempt to contact him electronically
(CIS, or phone) for a speedy response.
History:
- 1/25/94 Initial Release
v1.0 - (v1.0s Shareware and v1.0r Registered)
- 12/1/94
v1.1 - (v1.1s Shareware and v1.1r Registered)
No longer requires seperate UNZIP.EXE program
Added "COMMENT" button to view comments in ZIP file
Changed "OPEN" button text to "FILE OPEN"
Change "OK" button text to "Extract"
Added progress window while unzipping files
Added drive and directory picker
Added mutliple select option
Added Drag & Drop
The UnZip Shell is now distributed by Power Programming, Inc.