home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1995 March / SOFM_Mar1995.bin / pc / os2 / unzs / unzsh.doc < prev    next >
Text File  |  1995-01-27  |  23KB  |  523 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.                                                             Shareware Version
  9.  
  10.                                                                  Version 1.1s
  11.  
  12.                                                                       12/1/94
  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. All Rights Reserved.
  33.  
  34.        ---------------------------------------------------------
  35.  
  36.                       The UnZip Shell is Shareware
  37.        ---------------------------------------------------------
  38. If you have the shareware version:
  39. You may evaluate the program for TWO WEEKS. If you wish to continue
  40. using the program after TWO WEEKS, you must purchase a registered copy
  41. from John Wagner.
  42.  
  43. If you don't wish to continue using the program after two weeks, you
  44. must stop using the program. All users are allowed and encouraged to
  45. pass on copies of the SHAREWARE version of the program.
  46.  
  47. There are two versions of The UnZip Shell, one is the SHAREWARE version
  48. and the other is the REGISTERED VERSION. The two programs are identical
  49. in function, but there are some additional features in the REGISTERED
  50. version.
  51.  
  52.        ---------------------------------------------------------
  53.  
  54.                    The UnZip Shell SHAREWARE VERSION:
  55.        ---------------------------------------------------------
  56.         Default settings are not editable. You can modify the
  57.         settings while the program is running, but the settings
  58.         aren't saved.
  59.  
  60.         Cannot use Object Association when inspecting items
  61.         in ZIP files.
  62.  
  63.         Cannot use the Multiple Selection feature to selectively
  64.         extract a user selected list of files from the archive.
  65.  
  66.         Uses the OS/2 E.EXE editor as a file viewer.
  67.  
  68.         "SETUP" option works, but the changes you make aren't
  69.         saved.
  70.  
  71.         Reminder window pops-up when you view a file, when you
  72.         enter the "SETUP" window, and when you quit the program.
  73.  
  74.         The SHAREWARE version allows for a full evaluation of
  75.         the program to see if it suits your needs.
  76.  
  77.        ---------------------------------------------------------
  78.  
  79.                    The UnZip Shell REGISTERED VERSION:
  80.        ---------------------------------------------------------
  81.         Defaults can be modified and saved.
  82.  
  83.         Allows the use of any editor to view files.
  84.  
  85.         Enables the multiple select feature so the user can selectively
  86.         extract one or many files from an archive.
  87.  
  88.         Optionally uses the OS/2 Association feature when a
  89.         file is selected for viewing by calling the appropriate
  90.         (default) associated object. This means if you select a
  91.         file with a .ICO extension, the OS/2 Icon Editor will
  92.         be called up with the icon loaded into it.
  93.  
  94.         "SETUP" option saves the settings.
  95.  
  96.         No reminder window - A clear conscience!
  97.  
  98.         Includes a FREE bonus program!
  99.  
  100.        ---------------------------------------------------------
  101.  
  102.               If you have purchased a registered version:
  103.        ---------------------------------------------------------
  104. Thank you! Please make sure that you do not give anyone your registered
  105. software, as doing so would seriously hurt my business (and be really
  106. uncool!). Please do not upload it to BBS's, do not give a copy to a
  107. friend, or offer it for distribution in any way shape or form. You will
  108. find a copy of the SHAREWARE version of the program on your distribution
  109. disk, so if someone wants a copy, please give them the SHAREWARE version
  110. only. Thank you again for supporting my efforts to bring you quality
  111. software at an honest price.
  112.  
  113.        ---------------------------------------------------------
  114.  
  115.                             Info-ZIP UNZIP:
  116.        ---------------------------------------------------------
  117. Prior versions of the The UnZip Shell required the use of a seperate
  118. Info-ZIP UNZIP.EXE program. Near as I can tell, Info-ZIP is a collection
  119. of very talented programmers who created and maintain UNZIP (and a
  120. number of other ZIP utilities). They do so free of charge, and
  121. distribute the source code to the programs. UNZIP is portable across
  122. many platforms and is quite a piece of work.
  123.  
  124. The UnZip Shell is now a stand alone program. The source code to the
  125. original UNZIP has been used heavily in the implemenation of The UnZip
  126. Shell. Because of this, the original source code to UNZIP is still
  127. included on the distribution disk of the registered verison of The UnZip
  128. Shell. There are two explicit copyrights listed in the COPYING file
  129. included with INFO-Zip UNZIP. I've read through them, and to the best of
  130. my knowledge (I'm not a lawyer), I am in compliance with all of them.
  131. The UnZip Shell does not use VMS.C, so that copyright shouldn't be in
  132. effect. I have been in contact with Mr. Samuel Smith concerning his
  133. copyrights on UNREDUCE.C and UNSHRINK.C and have his blessing to use the
  134. code.
  135.  
  136. The following copyrights to UNZIP source follow:
  137.  
  138.         (On UNREDUCE.C and UNSHRINK.C)
  139.         Copyright 1989 Samuel H. Smith;  All rights reserved
  140.  
  141.         (On the rest of the UnZipping code - from the file "COPYING")
  142.         The remaining code was written by many people associated with the
  143.         Info-ZIP group, with large contributions from (but not limited to):
  144.         Mark Adler (inflate, explode, funzip), Kai Uwe Rommel (OS/2), John
  145.         Bush and Paul Kienitz (Amiga), Antoine Verheijen (Mac) and Greg
  146.         Roelofs (lots of stuff).  See the file CONTRIBS in the source dis-
  147.         tribution for a much more complete list of contributors.  Also note
  148.         that, while this code may not be explicitly copyrighted, we do re-
  149.         quest that no one else try to copyright it, either.  In other words,
  150.         use it with our blessings, but it's still our code.  (You can con-
  151.         sider that an implicit copyright if it makes you feel better. :-) )
  152.         Thank you!
  153.         
  154. To further clarify, the following is extracted from the file COPYING
  155. in the Info-ZIP UNZIP package:
  156.  
  157.    Q. Can I use the source code of Zip and UnZip in my commercial
  158.          application?
  159.  
  160.    A. Yes, so long as you include in your product an acknowledgment
  161.       and an offer of the original compression sources for free or
  162.       for a small copying fee, and make clear that there are no extra
  163.       or hidden charges resulting from the use of the compression
  164.       code by your product.  In other words, you are allowed to sell
  165.       only your own work, not ours.  [Note the additional restrictions
  166.       above on the code in unreduce.c, unshrink.c and vms.c.]  If you
  167.       have special requirements, contact us at zip-bugs@wkuvx1.wku.edu.
  168.  
  169. So therefore:
  170. It should be noted that the registration of The UnZip Shell does not
  171. cover the free portions of Info-ZIP UNZIP, only the portions that I have
  172. added, the OS/2 PM front end.
  173.  
  174. The original source for UNZIP is available widely on BBS's and on the
  175. internet. If you do not have access to either, I will gladly send you a
  176. copy of the original source code to UNZIP.EXE for a copying and handling
  177. fee of $10. Please note that I do not wish to charge anyone a copying
  178. and handling fee, but I must do so to cover my operating expenses. I
  179. would rather you obtained the original UNZIP source code at no charge
  180. via BBS or the internet.
  181.  
  182.        ---------------------------------------------------------
  183.  
  184.                     How to Register The UnZip Shell:
  185.        ---------------------------------------------------------
  186.  
  187. Registration for The UnZip Shell is a mere $12 U.S. That price includes
  188. shipping (in North America) and floppy disk media. There are three
  189. methods of registering The UnZip Shell...
  190.  
  191. Register via CompuServe:
  192. Type GO SWREG to enter the CompuServe Shareware Registry. Register
  193. product 2576. The price is $12 U.S. If you are an overseas customer, you
  194. _will not_ be charged the $2 shipping and handling fee that is added
  195. when you order by mail.
  196.  
  197. Register by mail:
  198. Orders being sent outside of North America, the price is $12 U.S. plus
  199. $2 U.S. for shipping and handling. Please send checks drawn from a U.S.
  200. bank, or money orders that are drawn in U.S. funds, made out to John
  201. Wagner (or Power Programming, Inc.).
  202.  
  203. Register by Shareware!:
  204. If you are an OS/2 shareware author, I would like extend my thanks to
  205. you by offering a free copy of The UnZip Shell to you in exchange for a
  206. free copy of your OS/2 shareware program. Just mail me a copy of your
  207. program (the same version you would mail someone who registers your
  208. program), and I'll send you a registered copy of The UnZip Shell.
  209.  
  210. When you register, you will receive the latest version of The Unzip
  211. Shell on a 3.5 inch disk. Please see the matrix above for the
  212. differences between the SHAREWARE and REGISTERED versions of the
  213. program. Also, please note that 5.25" disks are not available.
  214.  
  215. The address for registering The UnZip Shell is:
  216.  
  217.                     Power Programming, Inc.
  218.                     Attn. John Wagner
  219.                     RR 1  Box 107
  220.                     Derby Line, VT 05830
  221.  
  222. For your convenience, a file called INVOICE.DOC is included that
  223. contains all of the information I'll need to get your order processed.
  224. To expedite your order, please print INVOICE.DOC, fill out the requested
  225. information and send it in with your order.
  226.  
  227.        ---------------------------------------------------------
  228.  
  229.                             Upgrade policy:
  230.        ---------------------------------------------------------
  231. Since the low, low price of $12 pretty much rules out mass mailings to
  232. registered users, I will be unable to notify registered users of
  233. upgrades. I will release upgrades to the shareware version of the
  234. program which will reflect the latest features of the registered
  235. program. If you are a registered user, and come across a newer version
  236. of the program, and you would like upgrade to a registered copy of it,
  237. send $5 and I'll send you a disk as mentioned above.
  238.  
  239. Indicate on your order that you are a registered user and the current
  240. registered version # that you have. If you are using the latest version,
  241. I'll deposit your check, but hold your order until an upgrade is
  242. available, at which time your order will be sent promptly.
  243.  
  244. Distributing The UnZip Shell:
  245. The SHAREWARE version of The UnZip Shell may be distributed as long as
  246. the ENTIRE package is distributed together, and no additional files are
  247. added to the archive. The following is a list of files included in the
  248. SHAREWARE UnZip Shell archive:
  249.  
  250.         UNZSH.EXE
  251.         INSTALL.CMD
  252.         UNZSH.DOC
  253.         INVOICE.DOC
  254.         FILE_ID.DIZ
  255.         VENDOR.DOC
  256.  
  257. Please make certain that all of the files are included when distributing
  258. the archive. If you have the REGISTERED version of the program, PLEASE
  259. DO NOT distribute it. If you have the REGISTERED version of the program,
  260. I have included a copy of the latest SHAREWARE version on the diskette I
  261. sent you under the filename xxUNZS.ZIP (where xx is the version and
  262. sub-version).
  263.  
  264.        ---------------------------------------------------------
  265.  
  266.                        Disclaimer - PLEASE READ:
  267.        ---------------------------------------------------------
  268. The UnZip Shell is provided "as is", with NO GUARANTEE that it works as
  269. described here, or anywhere else. USE IT AT YOUR OWN RISK.
  270.  
  271.        ---------------------------------------------------------
  272.  
  273.                        What The UnZip Shell does:
  274.        ---------------------------------------------------------
  275. The UnZip Shell is an OS/2 PM front end for ZIP file archives. The
  276. following instructions will guide you step-by-step to installing UnZip
  277. Shell and integrating it into the Workplace Shell. The UnZip Shell
  278. allows you to activate files in your ZIP archives without unzipping the
  279. whole archive. This is handy for viewing text files, etc... Using the
  280. OS/2 Object Association feature, you can activate any object that is
  281. associated with the files contained within your archive files. Please
  282. note that the REGISTERED version of The UnZip Shell is required if
  283. you want to use Object Association.
  284.  
  285.        ---------------------------------------------------------
  286.  
  287.                      Quick and Dirty installation:
  288.        ---------------------------------------------------------
  289. If you are an OS/2 and WPS expert, you can can get up and running
  290. quickly by following these brief instructions:
  291.  
  292.    Make sure you have a TEMP or TMP variable set in you CONFIG.SYS
  293.    file
  294.  
  295. Use INSTALL.CMD
  296.    Copy both UNZSH.EXE and INSTALL.CMD to the directory you want to have
  297.    The UnZip Shell installed in. Run INSTALL.CMD. INSTALL.CMD will
  298.    create a WPS object, and associate it with files ending in .ZIP.
  299.  
  300.  - or -
  301.  
  302.    Put UNZSH.EXE somewhere on your hard drive
  303.  
  304.    Create a program reference object for UNZSH.EXE
  305.  
  306.    Set the association for the object you just created to *.ZIP
  307.  
  308.    Optionally, you can add a default target path as a parameter in
  309.    the settings notebook like so: -d=path
  310.  
  311.        ---------------------------------------------------------
  312.  
  313.                       How to install The UnZip Shell:
  314.        ---------------------------------------------------------
  315. Make sure you have a TEMP or TMP variable set in your CONFIG.SYS file:
  316.  
  317.     -CONFIG.SYS-
  318.     SET TEMP=C:\TEMP
  319.  
  320. Make sure C:\TEMP exists! The UnZip Shell uses the directory specified
  321. in the TMP or TEMP environment variable as a work directory. The UnZip
  322. Shell will run if you don't have a TMP or TEMP environment variable, but
  323. it will use the root directory of the drive that OS/2 started from.
  324.  
  325. I would like to point out that running The UnZip Shell without a TMP or
  326. TEMP variable set is a potentially dangerous situation in the rare case
  327. that you have a ZIP file with a file in it called CONFIG.SYS, and you
  328. attempt to read it, and ignore the warning that reading the file will
  329. overwrite a file that exists... make sure you have a TMP or TEMP
  330. environment variable set, it's the right thing to do!
  331.  
  332. These directions will assume you have unpacked the distribution archive
  333. into the directory C:\TEMP and you want to install the program into the
  334. directory C:\OS2\APPS.
  335.  
  336. First, start an OS/2 command line session.
  337.  
  338. Copy UNZSH.EXE to the C:\OS2\APPS directory:
  339.  
  340.                   COPY C:\TEMP\UNZSH.EXE C:\OS2\APPS
  341.                   COPY C:\TEMP\INSTALL.CMD C:\OS2\APPS
  342.  
  343. Now, make sure you are in the C:\OS2\APPS directory by entering the
  344. following:
  345.  
  346.                   C:
  347.                   CD\OS2\APPS
  348.  
  349. Run the INSTALL.CMD program:
  350.  
  351.                   INSTALL
  352.  
  353. The INSTALL.CMD program will create a WPS shell object, and associate
  354. the object with WPS file objects that end in .ZIP. Anytime you see a WPS
  355. file object, it will have the icon of The UnZip Shell. By double
  356. clicking on the WPS file object, you will automatically invoke The UnZip
  357. Shell, with that file loaded.
  358.  
  359. If you always unzip files to the same directory, you should open
  360. up the settings notebook of the new UnZip Shell object, and enter
  361. the following into the PARAMETERS field:
  362.  
  363.                   -D=DRIVE:\DIR
  364.  
  365.       WHERE: DRIVE: is the drive to (exp. C:)
  366.       WHERE: \DIR is the path on the drive (exp. \TEMP)
  367.  
  368.       EXAMPLE: -D=C:\TEMP
  369.  
  370.        ---------------------------------------------------------
  371.  
  372.         You can also run The UnZip Shell from the command line:
  373.        ---------------------------------------------------------
  374.    USAGE: UNZSH [-D=path to unzip to] [filename.zip]
  375.  
  376.    WHERE: [path to unzip to] is optional, do not include the []'s - it
  377.           specifies the target drive/directory to place the unzipped
  378.           files. Do include the -D= though.
  379.  
  380.    WHERE: [filename.zip] specifies the file to unzip.
  381.  
  382. If you don't specify a file to unzip (by running the program without the
  383. command line parameters) you can still load a ZIP file from within the
  384. program by clicking the "FILE OPEN..." button.
  385.  
  386.        ---------------------------------------------------------
  387.  
  388.                         Running The UnZip Shell:
  389.        ---------------------------------------------------------
  390. Regardless of how you start The UnZip Shell, you will have the following
  391. options...
  392.  
  393. Actions before unzipping:
  394.  
  395.     Viewing text files in the ZIP archive:
  396.       You can double click on a filename in the file listbox and The
  397.       UnZip Shell will bring up the OS/2 'E' editor with the selected
  398.       file loaded. When UnZip Shell exits, it shuts down any 'E'
  399.       sessions that may have been started and erases any files that are
  400.       being viewed. All of this takes place in the directory specified
  401.       in your TEMP or TMP environment variable.
  402.  
  403.    Existing file Options:
  404.       These options control what The UnZip Shell does when it tries to
  405.       extract a file from a ZIP file, and the file already exists in the
  406.       directory that it is extracting to.
  407.  
  408.    Embedded directory Options:
  409.       ZIP files can have sub-directories embedded in them. It is usually
  410.       desirable to re-create these sub-directories when unzipping the
  411.       file. By default, The UnZip Shell will create the sub-directories.
  412.       If you select "Junk directories" then the sub-directories won't be
  413.       created, and all of the files will be extracted into the Target
  414.       Directory.
  415.  
  416.    Specify the drive/dir you want to unzip the files to (Target Directory):
  417.       If you specify a directory that doesn't exist, The UnZip Shell
  418.       will make sure you want to create it. NOTE: UnZip Shell will only
  419.       create a directory one level deep, and it can't create drives that
  420.       don't exist<g>.
  421.  
  422.    Enable Multiple Selection:
  423.       By selecting this option, you can select which files are extracted
  424.       in the archive. Note that when this option is CHECKED, you cannot
  425.       view items in the list by double clicking on them.
  426.  
  427.    Viewing the ZIP comment:
  428.       If the currently loaded ZIP file has an embedded comment, the
  429.       COMMENT button will be enabled. Click on this button to view the
  430.       comment. After you are done viewing the comment, click the DONE
  431.       button on the comment viewing window.
  432.  
  433.    Opening another ZIP file:
  434.       If you click the "FILE OPEN..." button, you can select another
  435.       file to unzip.
  436.  
  437.    Drag-and-Drop:
  438.       You can also drag a ZIP file from the WPS onto The UnZip Shell
  439.       to open it. The list that displays the file contents is a good
  440.       target for Drag-and-Drop, or any other part of the window that
  441.       doesn't have a control on it.
  442.  
  443.    Setup the program configuration: (REGISTERED VERSION ONLY)
  444.       If you click the "SETUP" button, you will be presented with a
  445.       dialog window that contains the program startup defaults. From
  446.       this window, select the settings you want the program to start up
  447.       with every time.
  448.  
  449.       You can also select a different editor or file viewer to use when
  450.       you select a file to view. If the program you choose to view files
  451.       is not in your path, be sure to include the fully qualified path
  452.       name to the program (ie: C:\DOS\EDIT.COM) (like an OS/2 user is
  453.       going to use DOS EDIT!). Also, be sure to include the extension of
  454.       the program (ie: EPM.EXE) (that's more like it!).
  455.  
  456.       The registered version of The UnZip Shell allows you to use the
  457.       object association feature of the WPS. To do so, select this
  458.       option while in the setup dialog.
  459.  
  460. Actions after unzipping:
  461.    Create a WPS Shadow of the dir the files are being placed in:
  462.       This is the default setting. Click the checkbox off if you don't
  463.       want this to happen. As the object that is created is a shadow, it
  464.       can be safely deleted without affecting the actual directory. If
  465.       you delete the file objects however, the files will be deleted.
  466.  
  467.    Create an OS/2 session:
  468.       Select this option if you want The UnZip Shell to start an OS/2
  469.       command line window for you after unzipping the files. The session
  470.       will be started and the active drive/dir will be the one that the
  471.       unzipped files were placed in.
  472.  
  473. How to exit:
  474.  
  475.    Select "EXTRACT":
  476.       If you select "EXTRACT", The UnZip Shell will start it's thread
  477.       that unzips files (go OS/2!). Depending on the options you've
  478.       chosen for "Actions after UnZipping", you will see a shadow object
  479.       of the directory the files are placed in, and or an OS/2 Command
  480.       Window.
  481.  
  482.    Select "CANCEL":
  483.       If you select "CANCEL", The UnZip Shell will confirm that you want
  484.       to cancel.
  485.  
  486.    Exit with the "System Menu":
  487.       If you select "Close" from the System Menu (upper left corner),
  488.       The UnZip Shell will close immediately without confirming you want
  489.       to quit and without unzipping any files. The SHAREWARE version
  490.       will still display it's reminder window (only $12 to register!).
  491.  
  492. IMPORTANT!!!:
  493.      Regardless of how you exit the program, The UnZip shell will
  494.      shutdown any viewers or programs that you started while viewing a
  495.      files contents, and delete the temporary files that it created.
  496.  
  497.        ---------------------------------------------------------
  498.  
  499.                          Contacting the author:
  500.        ---------------------------------------------------------
  501. John Wagner is available on on CompuServe, account # 72122,2412
  502. (72122.2412@compuserve.com for internet). He can also be reached by
  503. phone at (802)895-4512 - after 5pm and before 10pm EST. The author
  504. suggests (and requests) that you attempt to contact him electronically
  505. (CIS, or phone) for a speedy response.
  506.  
  507. History:
  508.  
  509. - 1/25/94 Initial Release
  510.     v1.0 - (v1.0s Shareware and v1.0r Registered)
  511.  
  512. - 12/1/94
  513.    v1.1 - (v1.1s Shareware and v1.1r Registered)
  514.       No longer requires seperate UNZIP.EXE program
  515.       Added "COMMENT" button to view comments in ZIP file
  516.       Changed "OPEN" button text to "FILE OPEN"
  517.       Change "OK" button text to "Extract"
  518.       Added progress window while unzipping files
  519.       Added drive and directory picker
  520.       Added mutliple select option
  521.       Added Drag & Drop
  522.       The UnZip Shell is now distributed by Power Programming, Inc.
  523.