home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / 13unzr.zip / UNZSH.DOC < prev    next >
Text File  |  1996-02-15  |  20KB  |  480 lines
  1.  
  2.                                     Power Programming, Inc. proudly Presents:
  3.  
  4.                                             -- The UnZip Shell - UNZSH.EXE --
  5.  
  6.                                               OS/2 PM front-end for ZIP Files
  7.  
  8.                                                            Registered Version
  9.  
  10.                                                                  Version 1.3r
  11.  
  12.                                                                       2/15/96
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                            -- Legal Issues --
  30.        ---------------------------------------------------------
  31.  
  32. The UnZip Shell is Copyright (C), John Wagner 1994-96. All Rights Reserved.
  33.  
  34.        ---------------------------------------------------------
  35.  
  36.                       The UnZip Shell is FREE SOFTWARE
  37.        ---------------------------------------------------------
  38.  
  39. Previous versions of The UnZip Shell were shareware, requiring a $12
  40. registration fee. This has changed as of this version. Why? I love
  41. programming, and do it all day long at work. In past years I spent a lot
  42. of time writing code at home, and even started my own small programming
  43. shop out of my home. All of this has cut into my family life, and I've
  44. decided to spend more time with my family, and leave the programming at
  45. work. I will continue to write code at home, but plan on releasing
  46. whatever comes of it for free.
  47.  
  48. Thanks to all the folks who spent the $12 to register the program. I
  49. hope you feel you've gotten you're moneys worth and I do hope that my
  50. releasing the program as freeware doesn't cause you any hard feelings.
  51. You have my thanks for your support.
  52.  
  53.        ---------------------------------------------------------
  54.  
  55.                             Info-ZIP UNZIP:
  56.        ---------------------------------------------------------
  57. Prior versions of the The UnZip Shell required the use of a seperate
  58. Info-ZIP UNZIP.EXE program. Near as I can tell, Info-ZIP is a collection
  59. of very talented programmers who created and maintain UNZIP (and a
  60. number of other ZIP utilities). They do so free of charge, and
  61. distribute the source code to the programs. UNZIP is portable across
  62. many platforms and is quite a piece of work.
  63.  
  64. The UnZip Shell is now a stand alone program. The source code to the
  65. original UNZIP has been used heavily in the implemenation of The UnZip
  66. Shell. Because of this, the original source code to UNZIP is still
  67. included on the distribution disk of the registered verison of The UnZip
  68. Shell. There are two explicit copyrights listed in the COPYING file
  69. included with INFO-Zip UNZIP. I've read through them, and to the best of
  70. my knowledge (I'm not a lawyer), I am in compliance with all of them.
  71. The UnZip Shell does not use VMS.C, so that copyright shouldn't be in
  72. effect. I have been in contact with Mr. Samuel Smith concerning his
  73. copyrights on UNREDUCE.C and UNSHRINK.C and have his blessing to use the
  74. code.
  75.  
  76. The following copyrights to UNZIP source follow:
  77.  
  78.         (On UNREDUCE.C and UNSHRINK.C)
  79.         Copyright 1989 Samuel H. Smith;  All rights reserved
  80.  
  81.         (On the rest of the UnZipping code - from the file "COPYING")
  82.         The remaining code was written by many people associated with the
  83.         Info-ZIP group, with large contributions from (but not limited to):
  84.         Mark Adler (inflate, explode, funzip), Kai Uwe Rommel (OS/2), John
  85.         Bush and Paul Kienitz (Amiga), Antoine Verheijen (Mac) and Greg
  86.         Roelofs (lots of stuff).  See the file CONTRIBS in the source dis-
  87.         tribution for a much more complete list of contributors.  Also note
  88.         that, while this code may not be explicitly copyrighted, we do re-
  89.         quest that no one else try to copyright it, either.  In other words,
  90.         use it with our blessings, but it's still our code.  (You can con-
  91.         sider that an implicit copyright if it makes you feel better. :-) )
  92.         Thank you!
  93.         
  94. To further clarify, the following is extracted from the file COPYING
  95. in the Info-ZIP UNZIP package:
  96.  
  97.    Q. Can I use the source code of Zip and UnZip in my commercial
  98.          application?
  99.  
  100.    A. Yes, so long as you include in your product an acknowledgment
  101.       and an offer of the original compression sources for free or
  102.       for a small copying fee, and make clear that there are no extra
  103.       or hidden charges resulting from the use of the compression
  104.       code by your product.  In other words, you are allowed to sell
  105.       only your own work, not ours.  [Note the additional restrictions
  106.       above on the code in unreduce.c, unshrink.c and vms.c.]  If you
  107.       have special requirements, contact us at zip-bugs@wkuvx1.wku.edu.
  108.  
  109.        ---------------------------------------------------------
  110.  
  111.                     How to Register The UnZip Shell:
  112.        ---------------------------------------------------------
  113.  
  114. You don't, it's free.
  115.  
  116.        ---------------------------------------------------------
  117.  
  118.                        Disclaimer - PLEASE READ:
  119.        ---------------------------------------------------------
  120. The UnZip Shell is provided "as is", with NO GUARANTEE that it works as
  121. described here, or anywhere else. USE IT AT YOUR OWN RISK. There is also
  122. no guarantee that upgrades to The UnZip Shell will be available at a
  123. future time. There is also no guarantee that The UnZip Shell will remain
  124. compatible with future .ZIP file formats that have yet to be released.
  125.  
  126.        ---------------------------------------------------------
  127.  
  128.                        What The UnZip Shell does:
  129.        ---------------------------------------------------------
  130. The UnZip Shell is an OS/2 PM front end for ZIP file archives. The
  131. following instructions will guide you step-by-step to installing UnZip
  132. Shell and integrating it into the Workplace Shell. The UnZip Shell
  133. allows you to activate files in your ZIP archives without unzipping the
  134. whole archive. This is handy for viewing text files, etc... Using the
  135. OS/2 Object Association feature, you can activate any object that is
  136. associated with the files contained within your archive files.
  137.  
  138.        ---------------------------------------------------------
  139.  
  140.                      Quick and Dirty installation:
  141.        ---------------------------------------------------------
  142. If you are an OS/2 and WPS expert, you can can get up and running
  143. quickly by following these brief instructions:
  144.  
  145.    Make sure you have a TEMP or TMP variable set in you CONFIG.SYS
  146.    file. Make sure TEMP or TMP is in CAPS.
  147.  
  148. Use INSTALL.CMD
  149.    Copy both UNZSH.EXE and INSTALL.CMD to the directory you want to have
  150.    The UnZip Shell installed in. Run INSTALL.CMD. INSTALL.CMD will
  151.    create a WPS object, and associate it with files ending in .ZIP.
  152.  
  153.  - or -
  154.  
  155.    Put UNZSH.EXE somewhere on your hard drive
  156.  
  157.    Create a program reference object for UNZSH.EXE
  158.  
  159.    Set the association for the object you just created to *.ZIP
  160.  
  161.    Optionally, you can add a default target path as a parameter in
  162.    the settings notebook like so: -d=path
  163.  
  164.        ---------------------------------------------------------
  165.  
  166.                       How to install The UnZip Shell:
  167.        ---------------------------------------------------------
  168. Make sure you have a TEMP or TMP variable set in your CONFIG.SYS file:
  169.  
  170.     -CONFIG.SYS-
  171.     SET TEMP=C:\TEMP
  172.  
  173. Make sure C:\TEMP exists! The UnZip Shell uses the directory specified
  174. in the TMP or TEMP environment variable as a work directory. The UnZip
  175. Shell will run if you don't have a TMP or TEMP environment variable, but
  176. it will use the root directory of the drive that OS/2 started from.
  177.  
  178. I would like to point out that running The UnZip Shell without a TMP or
  179. TEMP variable set is a potentially dangerous situation in the rare case
  180. that you have a ZIP file with a file in it called CONFIG.SYS, and you
  181. attempt to read it, and ignore the warning that reading the file will
  182. overwrite a file that exists... make sure you have a TMP or TEMP
  183. environment variable set, it's the right thing to do!
  184.  
  185. These directions will assume you have unpacked the distribution archive
  186. into the directory C:\TEMP and you want to install the program into the
  187. directory C:\OS2\APPS.
  188.  
  189. First, start an OS/2 command line session.
  190.  
  191. Copy UNZSH.EXE to the C:\OS2\APPS directory:
  192.  
  193.                   COPY C:\TEMP\UNZSH.EXE C:\OS2\APPS
  194.                   COPY C:\TEMP\INSTALL.CMD C:\OS2\APPS
  195.  
  196. Now, make sure you are in the C:\OS2\APPS directory by entering the
  197. following:
  198.  
  199.                   C:
  200.                   CD\OS2\APPS
  201.  
  202. Run the INSTALL.CMD program:
  203.  
  204.                   INSTALL
  205.  
  206. The INSTALL.CMD program will create a WPS shell object, and associate
  207. the object with WPS file objects that end in .ZIP. Anytime you see a WPS
  208. file object, it will have the icon of The UnZip Shell. By double
  209. clicking on the WPS file object, you will automatically invoke The UnZip
  210. Shell with that file loaded.
  211.  
  212. If you always unzip files to the same directory, you should open
  213. up the settings notebook of the new UnZip Shell object, and enter
  214. the following into the PARAMETERS field:
  215.  
  216.                   -D=DRIVE:\DIR
  217.  
  218.       WHERE: DRIVE: is the drive to (exp. C:)
  219.       WHERE: \DIR is the path on the drive (exp. \TEMP)
  220.  
  221.       EXAMPLE: -D=C:\TEMP
  222.  
  223.        ---------------------------------------------------------
  224.  
  225.         You can also run The UnZip Shell from the command line:
  226.        ---------------------------------------------------------
  227.    USAGE: UNZSH [-D=path to unzip to] [filename.zip]
  228.  
  229.    WHERE: [path to unzip to] is optional, do not include the []'s - it
  230.           specifies the target drive/directory to place the unzipped
  231.           files. Do include the -D= though.
  232.  
  233.    WHERE: [filename.zip] specifies the file to unzip.
  234.  
  235. If you don't specify a file to unzip (by running the program without the
  236. command line parameters) you can still load a ZIP file from within the
  237. program by clicking the "FILE OPEN..." button.
  238.  
  239.        ---------------------------------------------------------
  240.  
  241.                         Running The UnZip Shell:
  242.        ---------------------------------------------------------
  243. Regardless of how you start The UnZip Shell, you will have the following
  244. options...
  245.  
  246. Actions before unzipping:
  247.  
  248.     Viewing/running files in the ZIP archive:
  249.  
  250.       If you have the "File Viewer" radio button selected:
  251.          You can double click on a filename in the file listbox and The
  252.          UnZip Shell will bring up the OS/2 'E' editor with the selected
  253.          file loaded ('E' is the default editor, you can change your file
  254.          viewer in the "Defaults" dialog). When UnZip Shell exits, it
  255.          shuts down any 'E' sessions that may have been started and
  256.          erases any files that are being viewed. All of this takes place
  257.          in the directory specified in your TEMP or TMP environment
  258.          variable.
  259.  
  260.       If you have the "Start Object" radio button select:
  261.          This is were the beauty of OS/2 comes into play... You can
  262.          double click on any file, and the object/program that is
  263.          associated with the type of file you have selected is started
  264.          with the selected file loaded.
  265.  
  266.       Please note that double clicking is the same as pressing the
  267.       "Start/View selected" button. Also, you can select Start or View
  268.       from the popup menu.
  269.  
  270.  
  271.    Existing file Options:
  272.       These options control what The UnZip Shell does when it tries to
  273.       extract a file from a ZIP file, and the file already exists in the
  274.       directory that it is extracting to.
  275.  
  276.    Embedded directory Options:
  277.       ZIP files can have sub-directories embedded in them. It is usually
  278.       desirable to re-create these sub-directories when unzipping the
  279.       file. By default, The UnZip Shell will create the sub-directories.
  280.       If you select "Junk directories" then the sub-directories won't be
  281.       created, and all of the files will be extracted into the Target
  282.       Directory.
  283.  
  284.    Specify the drive/dir you want to unzip the files to (Target Directory):
  285.       If you specify a directory that doesn't exist, The UnZip Shell
  286.       will make sure you want to create it. NOTE: UnZip Shell will only
  287.       create a directory one level deep, and it can't create drives that
  288.       don't exist<g>.
  289.  
  290.    Use the "Find" button to search/create directories:
  291.       Note when using the "Create directory" option, the directory is
  292.       created as a subdirectory under the directory shown at the top. If
  293.       you create a directory, and precede it with \, it will be created
  294.       below the root directory on the current drive. Simarily, if you
  295.       precede the directory name with a ..\, it will be created on
  296.       directory up from the current directory. In any case, the new
  297.       directory will be shown in the listing, and you can change to it
  298.       by double clicking on it.
  299.  
  300.    Enable Multiple Selection:
  301.       By selecting this option, you can select which files are extracted
  302.       in the archive. Note that when this option is CHECKED, you cannot
  303.       view items in the list by double clicking on them.
  304.  
  305.    File viewer/Start object:
  306.       Select file viewer to use the File viewer specified in the
  307.       "Defaults". Select Start object to use object association.
  308.  
  309.    Viewing the ZIP comment:
  310.       If the currently loaded ZIP file has an embedded comment, the
  311.       COMMENT button will be enabled. Click on this button to view the
  312.       comment. After you are done viewing the comment, click the DONE
  313.       button on the comment viewing window.
  314.  
  315.    Opening another ZIP file:
  316.       If you click the "File Open..." button, you can select another
  317.       file to unzip.
  318.  
  319.    Drag-and-Drop:
  320.       You can also drag a ZIP file from the WPS onto The UnZip Shell
  321.       to open it. The list that displays the file contents is a good
  322.       target for Drag-and-Drop, or any other part of the window that
  323.       doesn't have a control on it.
  324.  
  325.    Setup the program configuration:
  326.       If you click the "SETUP" button, you will be presented with a
  327.       dialog window that contains the program startup defaults. From
  328.       this window, select the settings you want the program to start up
  329.       with every time.
  330.  
  331.       You can also select a different editor or file viewer to use when
  332.       you select a file to view. If the program you choose to view files
  333.       is not in your path, be sure to include the fully qualified path
  334.       name to the program (ie: C:\DOS\EDIT.COM) (like an OS/2 user is
  335.       going to use DOS EDIT!). Also, be sure to include the extension of
  336.       the program (ie: EPM.EXE) (that's more like it!).
  337.  
  338.       The registered version of The UnZip Shell allows you to use the
  339.       object association feature of the WPS. To do so, select this
  340.       option while in the setup dialog.
  341.  
  342.    Use Button 2 to view a popup menu:
  343.       Pressing Mouse Button 2 brings up a popup menu with numerous
  344.       options. If you pressing Button 2 on the list of files, it will
  345.       select the file under the cursor, and then bring up the popup
  346.       menu.
  347.  
  348. Actions after unzipping:
  349.    Create a WPS Shadow of the dir the files are being placed in:
  350.       This is the default setting. Click the checkbox off if you don't
  351.       want this to happen. As the object that is created is a shadow, it
  352.       can be safely deleted without affecting the actual directory. If
  353.       you delete the file objects however, the files will be deleted.
  354.  
  355.    Create an OS/2 session:
  356.       Select this option if you want The UnZip Shell to start an OS/2
  357.       command line window for you after unzipping the files. The session
  358.       will be started and the active drive/dir will be the one that the
  359.       unzipped files were placed in.
  360.  
  361.    Close UnZip Shell:
  362.       Selects whether or not The UnZip Shell exits after unzipping. Note
  363.       that only the REGISTERED VERSION allows you to change this
  364.       setting.
  365.  
  366. How to exit:
  367.  
  368.    Select "Extract xxx":
  369.       If you select "Extract xxx", The UnZip Shell will start it's
  370.       thread that unzips files (go OS/2!). If you selected "Close
  371.       UnZip Shell", the program will exit.
  372.  
  373.    Select "CANCEL":
  374.       If you select "CANCEL", The UnZip Shell will confirm that you want
  375.       to cancel.
  376.  
  377.    Exit with the "System Menu":
  378.       If you select "Close" from the System Menu (upper left corner),
  379.       The UnZip Shell will close immediately without confirming you want
  380.       to quit and without unzipping any files. The SHAREWARE version
  381.       will still display it's reminder window (only $12 to register!).
  382.  
  383. IMPORTANT!!!:
  384.      Regardless of how you exit the program, The UnZip shell will
  385.      shutdown any viewers or programs that you started while viewing a
  386.      files contents, and delete the temporary files that it created.
  387.  
  388.        ---------------------------------------------------------
  389.  
  390.                          Contacting the author:
  391.        ---------------------------------------------------------
  392. John Wagner is available on the net as: jwag@together.net
  393.  
  394. There is no support available for The UnZip Shell. I will answer any
  395. questions about it as time permits.
  396.  
  397. History:
  398.  
  399. - 1/25/94 Initial Release
  400.     v1.0 - (v1.0s Shareware and v1.0r Registered)
  401.  
  402.  
  403. - 12/1/94
  404.    v1.1 - (v1.1s Shareware and v1.1r Registered)
  405.  
  406.       No longer requires seperate UNZIP.EXE program
  407.  
  408.       Added "COMMENT" button to view comments in ZIP file
  409.  
  410.       Changed "OPEN" button text to "FILE OPEN"
  411.  
  412.       Change "OK" button text to "Extract"
  413.  
  414.       Added progress window while unzipping files
  415.  
  416.       Added drive and directory picker
  417.  
  418.       Added mutliple select option
  419.  
  420.       Added Drag & Drop
  421.  
  422.       The UnZip Shell is now distributed by Power Programming, Inc.
  423.  
  424. - 5/15/95
  425.    v1.2 - (v1.2s Shareware and v1.2r Registered)
  426.  
  427.       Made it optional to close program after un-archiving
  428.  
  429.       Added "View selected/Start selected" button Changed the text of
  430.       the "Setup" button to "Defaults"
  431.  
  432.       Added "File viewer" and "Start object" radio buttons so you can
  433.       switch between the two on the fly instead of going to the defaults
  434.       dialog
  435.  
  436.       Added "Use new settings in current shell" checkbox to defaults
  437.       dialog
  438.  
  439.       Now the defaults dialog uses the current settings when editing
  440.       defaults
  441.  
  442.       Multiple selection can now be a default
  443.  
  444.       Changed the "Create shadow of Target Directory" to "Open view of
  445.       Target Directory". No longer creates a shadow, but just opens a
  446.       view
  447.  
  448.       Added a "Now" button to both the "Open view..." and "Create
  449.       Command line Shell" options so those options may be used while the
  450.       program is running.
  451.  
  452.       Now uses the COMSPEC variable for opening a Command Line shell
  453.  
  454.       Added a "Create directory" button in the "Find directory" dialog
  455.  
  456.       Added Button2 popup menu
  457.  
  458.       Switched to Borland C++ version 2.0 as of this version.
  459.  
  460. - 2/15/96
  461.    v1.3 - (v1.3r Freeware)
  462.  
  463.       Released program as freeware. There will be no more updates to the
  464.       software and there is no support available. There will be no bug-fixes,
  465.       or updates made to this software. It is released as-is, for free, and
  466.       all sales are final.
  467.  
  468.  
  469.    Thanks:
  470.       First off, Many, many thanks to Mr. Marcus de Geus for his
  471.       wonderful suggestions. Quite a few of the additional features
  472.       added to version 1.2 were his.
  473.  
  474.       Thanks to IBM for Warp! I thought v2.x of OS/2 was great, Warp is
  475.       even better!
  476.  
  477.       Thanks to Steve Lumos, Nelson Grandjean and Bob Falbo for beta
  478.       testing since the programs inception. Also thanks to Marcus de
  479.       Geus for beta testing version 1.2.
  480.