home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / PM_ZIP.ZIP / PMZIP.TXT < prev    next >
Text File  |  1991-01-14  |  33KB  |  1,403 lines
  1.  
  2.  
  3.  
  4.     INTRODUCTION
  5.  
  6.  
  7.  
  8.                                 PMZIP(TM) Manual
  9.                                    Version 1.0
  10.  
  11.                            Copyright (c) 1991 Nico Mak
  12.                                All Rights Reserved
  13.  
  14.     PMZIP(TM) is a ZIP file manager for the OS/2 Presentation Manager. It
  15.     features:
  16.  
  17.     o   An SAA/CUA compatible interface for quickly adding, deleting,
  18.         extracting, and viewing files in a ZIP file
  19.     o   Extensive online hypertext help (press F1 at any time)
  20.     o   A sortable scrollable multi-selection list box with the names,
  21.         sizes, and date/time stamps of files in a ZIP file
  22.     o   Push buttons for most commonly used actions
  23.     o   A file search facility to locate selected ZIP files anywhere on a
  24.         disk
  25.     o   Easy installation
  26.     o   Support for the File Manager's drag and drop interface in OS/2
  27.         version 1.20 and later.
  28.     o   All options (including screen size and position) can be saved and
  29.         restored
  30.  
  31.     PMZIP is distributed as Shareware.  This means that users are
  32.     encouraged, subject to restrictions described in the License Agreement,
  33.     to share copies of this program with friends, associates and bulletin
  34.     boards.  Please remember that if you use this software you are required
  35.     to pay the registration fee of $29 as described in the License
  36.     Agreement.
  37.  
  38.     The documentation in this file is available as context sensitive help
  39.     while running PMZIP.  Just press F1 at any time.  Hypertext links make
  40.     it easy to navigate the online information, so give it a try!
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.     CONTENTS
  59.  
  60.     Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  61.  
  62.     PMZIP Overview  . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  63.  
  64.     Copyright/License/Warranty  . . . . . . . . . . . . . . . . . . . . .  5
  65.  
  66.     Support and questions   . . . . . . . . . . . . . . . . . . . . . . .  7
  67.  
  68.     Quick start information   . . . . . . . . . . . . . . . . . . . . . .  8
  69.  
  70.     Drag and Drop interface   . . . . . . . . . . . . . . . . . . . . . .  9
  71.  
  72.     Installation  . . . . . . . . . . . . . . . . . . . . . . . . . . .   10
  73.  
  74.     Program locations   . . . . . . . . . . . . . . . . . . . . . . . .   12
  75.  
  76.     Opening ZIP files   . . . . . . . . . . . . . . . . . . . . . . . .   13
  77.  
  78.     Adding files to a ZIP file  . . . . . . . . . . . . . . . . . . . .   14
  79.  
  80.     Deleting files from a ZIP file  . . . . . . . . . . . . . . . . . .   15
  81.  
  82.     Extracting files from a ZIP file  . . . . . . . . . . . . . . . . .   16
  83.  
  84.     Viewing files in a ZIP file   . . . . . . . . . . . . . . . . . . .   17
  85.  
  86.     File Search Facility  . . . . . . . . . . . . . . . . . . . . . . .   18
  87.  
  88.     Options   . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   19
  89.  
  90.     Error Handling  . . . . . . . . . . . . . . . . . . . . . . . . . .   20
  91.  
  92.     File Manager hints  . . . . . . . . . . . . . . . . . . . . . . . .   21
  93.  
  94.     Keyboard usage  . . . . . . . . . . . . . . . . . . . . . . . . . .   22
  95.  
  96.     Future Enhancements   . . . . . . . . . . . . . . . . . . . . . . .   23
  97.  
  98.     Notes   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   24
  99.  
  100.     INDEX   . . . . . . . . . . . . . . . . . . . . . . . . . . . .  INDEX-1
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.                                                                       page 3
  111.  
  112.     PMZIP OVERVIEW
  113.  
  114.  
  115.  
  116.     ZIP files contain other files.  Typically the files in a ZIP file are
  117.     compressed.  ZIP files make it easy to group files and makes
  118.     transporting and copying these files faster.
  119.  
  120.     PMZIP(TM) is a ZIP file manager for the OS/2 Presentation Manager. It
  121.     provides an easy-to-use SAA/CUA compatible interface for quickly adding,
  122.     deleting, extracting, and viewing members of a ZIP file. The program is
  123.     easy to install, and extensive online help is always available.
  124.  
  125.     The main PMZIP window includes a list of files in the open ZIP file.
  126.     This list can be scrolled and sorted by name, extension, date, or size.
  127.     Files can be added, deleted, extracted, or viewed using pull-down menu
  128.     entries and push buttons.
  129.  
  130.     Other features include a built-in file search facility that makes it
  131.     easy to locate ZIP files anywhere on your disk, support for the File
  132.     Manager's drag and drop interface to conveniently add files to a ZIP
  133.     file, and the ability to save and restore all options, including screen
  134.     size and position.
  135.  
  136.     PMZIP supports the CUA "object-action process sequence" philosophy. This
  137.     allows you to select objects (files you want to add to a ZIP or files
  138.     already in a ZIP) and then specify the action you want to perform.
  139.     Alternately, you can use PMZIP in a more traditional "action-object"
  140.     style of interaction.
  141.  
  142.     The most common ways to start the program are:
  143.  
  144.     o   To open an existing ZIP file from the File Manager, double click on
  145.         the ZIP file.
  146.  
  147.     o   To add files to an existing ZIP file, use the technique described in
  148.         the section titled Drag and Drop Interface.  Briefly, select one or
  149.         more files in the File Manager, hold down mouse button two, drag the
  150.         file(s) over a PMZIP window or icon, and release the mouse button.
  151.         NOTE:  you should drop files over a copy of PMZIP that is running,
  152.         not over an icon in a Desktop Manager Program Group window.
  153.  
  154.     o   To add files to a new ZIP file, use the procedure for adding files
  155.         to an existing ZIP file, but be sure to specify the name of a ZIP
  156.         file in the dialog box displayed when you "drop" files onto a
  157.         running copy of PMZIP.
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.                                                                       page 4
  165.  
  166.     You can also start PMZIP by double clicking on the PMZIP icon in the
  167.     "Group - Main" window.  To start PMZIP from the OS/2 command line type
  168.     PMZIP, optionally specifying the name of a ZIP file as the first and
  169.     only parameter.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.                                                                       page 5
  219.  
  220.     COPYRIGHT/LICENSE/WARRANTY
  221.  
  222.  
  223.  
  224.     PMZIP(TM) Copyright (c) 1991 by Nico Mak - All rights reserved.
  225.  
  226.     License Agreement and Warranty Disclaimer
  227.  
  228.     You should carefully read the following terms and conditions before
  229.     using this software.  Use of this software indicates your acceptance of
  230.     these terms and conditions.  If you do not agree with them, do not use
  231.     the software.
  232.  
  233.     Shareware Version
  234.  
  235.     You are hereby licensed to:  use the Shareware Version of the software
  236.     for a 21 day evaluation period; make as many copies of the Shareware
  237.     version of this software and documentation as you wish; give exact
  238.     copies of the original Shareware version to anyone; and distribute the
  239.     Shareware version of the software and documentation in its unmodified
  240.     form via electronic means.  There is no charge for any of the above.
  241.  
  242.     You are specifically prohibited from charging, or requesting donations,
  243.     for any such copies, however made; and from distributing the software
  244.     and/or documentation with other products (commercial or otherwise)
  245.     without prior written permission.
  246.  
  247.     Unregistered use of PMZIP after the 21-day evaluation period is in
  248.     violation of federal copyright laws.
  249.  
  250.     Evaluation and Registration
  251.  
  252.     This is not free software.  This license allows you to use this software
  253.     for evaluation purposes without charge for a period of 21 days.  If you
  254.     use this software after the 21 day evaluation period a registration fee
  255.     of $29 (plus shipping and handling for orders outside USA) is required.
  256.     Payments must be in US dollars drawn on a US bank, and should be sent to
  257.     Nico Mak, P.O.  Box 919, Bristol, CT 06010.  Credit card ordering and
  258.     quantity discounts are available, as described in the file ORDER.DOC.
  259.  
  260.     One registered copy of PMZIP may be dedicated to a single person who
  261.     uses the software on one or more computers or to a single workstation
  262.     used by multiple people.
  263.  
  264.     You may access the registered version of PMZIP through a network,
  265.     provided that you have obtained individual license for the software
  266.     covering all workstations that will access the software through the
  267.     network.
  268.  
  269.  
  270.  
  271.  
  272.                                                                       page 6
  273.  
  274.     Governing Law
  275.  
  276.     This agreement shall be governed by the laws of the State of
  277.     Connecticut.
  278.  
  279.     Disclaimer of Warrantee
  280.  
  281.     This software and the accompanying files are sold "as is" and without
  282.     warranties as to performance of merchantability or any other warranties
  283.     whether expressed or implied.  Because of the various hardware and
  284.     software environments into which this program may be put, no warranty of
  285.     fitness for a particular purpose is offered.
  286.  
  287.     Good data processing procedure dictates that any program be thoroughly
  288.     tested with non-critical data before relying on it.  The user must
  289.     assume the entire risk of using the program.  Any liability of the
  290.     seller will be limited exclusively to product replacement or refund of
  291.     purchase price.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.                                                                       page 7
  327.  
  328.     SUPPORT AND QUESTIONS
  329.  
  330.  
  331.  
  332.     Technical support is available at no charge by sending electronic mail
  333.     to 70056,241 on CompuServe, to Nico Mak on BIX, or by sending US Mail to
  334.     Nico Mak, P.O. Box 919, Bristol, CT 06010. Registered users have
  335.     priority but I will try to answer all questions.
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.                                                                       page 8
  381.  
  382.     QUICK START INFORMATION
  383.  
  384.  
  385.  
  386.     Many people that have used other Presentation Manager or Windows
  387.     applications will be able to use PMZIP without reading all the
  388.     documentation. However, the following sections should be reviewed before
  389.     running the program:
  390.  
  391.     o   Copyright/License Agreement/Warranty
  392.     o   Installation
  393.     o   Drag and Drop Interface
  394.  
  395.     I also suggest you read the section titled Notes for miscellaneous
  396.     information about the interface philosophy and background, as well as
  397.     technical notes.
  398.  
  399.     For more information about using the help facility, select Help for
  400.     help on the Help pull-down.
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.                                                                       page 9
  435.  
  436.     DRAG AND DROP INTERFACE
  437.  
  438.  
  439.  
  440.     PMZIP supports the File Manager's "Drag and Drop" interface in OS/2
  441.     version 1.20 and later. This interface provides a convenient way to add,
  442.     freshen, or update files in a ZIP file with selected files listed by the
  443.     File Manager. To use the interface
  444.  
  445.     1.  select one or more files in the File Manager
  446.     2.  hold down mouse button two
  447.     3.  drag the file(s) over PMZIP window or icon
  448.     4.  release mouse button two to drop the file(s)
  449.  
  450.     NOTE:  you should drop files over a copy of PMZIP that is running, not
  451.     over an icon in a Desktop Manager Program Group window.
  452.  
  453.     When you drop one or more files on a PMZIP window, the "Drop" dialog box
  454.     is displayed.  The dialog box lets you change the name of ZIP file
  455.     affected by the drop operation, either by typing the name of a ZIP file,
  456.     or by clicking on the Open or New buttons, which activate the standard
  457.     Open and New dialog boxes, respectively. This is a quick way to open a
  458.     different ZIP file without going through the File pull-down menu.
  459.  
  460.     The Drop dialog box provides the following options:
  461.  
  462.     o   The Add, Freshen, and Update radio buttons correspond to the PKZIP
  463.         -a, -f, and -u options
  464.     o   The "delete original after adding" check box corresponds to the
  465.         PKZIP -m option
  466.     o   The Size and Speed radio buttons correspond to the PKZIP -ex and -es
  467.         options
  468.     o   The "Recurse subdirectories" check box corresponds to the PKZIP -r
  469.         option
  470.     o   The "Store recursed pathnames" check box corresponds to the PKZIP -p
  471.         option
  472.     o   The "Store specified pathnames" check box corresponds to the PKZIP
  473.         -P option
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.                                                                      page 10
  489.  
  490.     INSTALLATION
  491.  
  492.  
  493.  
  494.     System Requirements:
  495.  
  496.     o   OS/2 version 1.2 or later.
  497.     o   The OS/2 versions of the PKWARE, Inc. PKZIP(TM) and PKUNZIP(TM)
  498.         programs. These can be obtained from most bulletin board systems or
  499.         ordered directly from PKWARE (phone 414-352-3670).
  500.  
  501.     PMZIP-related files are:
  502.  
  503.     o   README.1ST this file
  504.     o   ORDER.DOC order form
  505.     o   PMZIP.EXE executable
  506.     o   PMZIP.HLP documentation in online hypertext help format
  507.     o   PMZIP.TXT documentation formatted printing
  508.     o   PMZIP.DLL required dynamic link library
  509.  
  510.     Installation:
  511.  
  512.     There are two parts to the installation process.  The first is performed
  513.     manually before running PMZIP. The second part is run from the Install
  514.     dialog. This dialog box is displayed the first time PMZIP is run, and
  515.     can be rerun from the Options pull-down menu.
  516.  
  517.     One time installation procedure:
  518.  
  519.     1) If you already have installed a previous version of PMZIP, delete all
  520.     files in your PMZIP directory.  Otherwise create a directory to hold the
  521.     PMZIP related files.  For example, "C:\PMZIP".
  522.  
  523.     2) Copy all PMZIP-related files to this directory.  At a minimum you
  524.     need the following files:  PMZIP.EXE, PMZIP.HLP, and PMZIP.DLL. Note:
  525.     there is no need to include the directory containing PMZIP related files
  526.     in your LIBPATH= or HELP= paths.
  527.  
  528.     3) Run PMZIP.EXE, either by double clicking on PMZIP.EXE in the File
  529.     Manager or by entering PMZIP at the the OS/2 system prompt.  The first
  530.     time you run PMZIP it will bring up the Install dialog box to complete
  531.     the installation.  If PMZIP cannot find PKZIP or PKUNZIP in your path,
  532.     it will prompt you for the program locations with the Program locations
  533.     dialog box.
  534.  
  535.     Optional steps:
  536.  
  537.     a) Add the directory created in step one to your PATH.  If you don't add
  538.  
  539.  
  540.  
  541.  
  542.                                                                      page 11
  543.  
  544.     the directory to your path, you'll need to type the directory name when
  545.     you start PMZIP from the command line (for example, you'll have to type
  546.     "C:\PMZIP\PMZIP" rather than just "PMZIP").
  547.  
  548.     b) Add the statement PMZIP /ICON to your STARTUP.CMD file. This will
  549.     automatically start PMZIP as an icon whenever you boot OS/2, and
  550.     facilitates use of the File Manager's Drag and Drop Interface.
  551.  
  552.     Install dialog box:
  553.  
  554.     The Install dialog box will add a PMZIP entry to the first Program Group
  555.     in the Desktop Manager (usually "Group - Main"). It will also set a File
  556.     Manager association for *.ZIP files.  This association lets you
  557.     double-click on any ZIP file listed in the File Manager to automatically
  558.     open the ZIP file with PMZIP.
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.                                                                      page 12
  597.  
  598.     PROGRAM LOCATIONS
  599.  
  600.  
  601.  
  602.     The Program Locations dialog box is displayed during PMZIP
  603.     initialization if it can't find the OS/2 versions of the PKZIP or
  604.     PKUNZIP commands.  If this dialog box is displayed, type the name of the
  605.     programs in the appropriate entry fields and click on the OK button.
  606.     Specify either a fully qualified pathname (e.g. C:\PKWARE\PKZIP.EXE),
  607.     or, if you want PMZIP to search your path, just the filename and
  608.     extension (e.g. PKZIP2.EXE).
  609.  
  610.     Note: PKWARE distributes the OS/2 versions of their products with a "2"
  611.     or "F" file name suffix (e.g. PKZIP2).  Since many users rename the
  612.     files to remove these suffixes, PMZIP automatically searches for all
  613.     three file name formats when it is first installed.
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.                                                                      page 13
  651.  
  652.     OPENING ZIP FILES
  653.  
  654.  
  655.  
  656.     You can open ZIP files with the standard "New" or "Open" entries on the
  657.     File pull-down menu. These functions work like those of most other PM
  658.     applications, except that the Open dialog box features a File Search
  659.     Facility that will list all or selected ZIP files in your directory
  660.     tree.
  661.  
  662.     Alternately, you can open a ZIP file while using the File Manager's
  663.     "Drag and Drop" interface to add files to a new or existing ZIP file, as
  664.     described in the section titled Drag and Drop Interface. If you change
  665.     the name of the ZIP file in the Drag and Drop dialog box, then PMZIP
  666.     will continue to work with the specified ZIP file until you again change
  667.     the name.
  668.  
  669.     To save mouse clicks, PMZIP automatically brings up the Open dialog box
  670.     if no ZIP file is specified when the program is started. To disable this
  671.     behavior, click on the "Auto open dialog box" radio button in the
  672.     Configuration dialog box and save the default settings via the Defaults
  673.     dialog box.
  674.  
  675.     You can close the current ZIP file with the "Close" entry on the File
  676.     pull-down menu.  However, this menu entry is included primarily for
  677.     completeness, since the New, Open, and Drag and Drop dialog boxes all
  678.     automatically perform this action.
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.                                                                      page 14
  705.  
  706.     ADDING FILES TO A ZIP FILE
  707.  
  708.  
  709.  
  710.     There are two ways to add files to a ZIP:
  711.  
  712.     1) Object-action interface:  use the File Managers "Drag and Drop"
  713.     interface, as described in the section titled Drag and Drop Interface.
  714.  
  715.     2) Action-object interface:  click on the "Add" push button or select
  716.     the "Add" entry from the "Action" pull-down menu to bring up the Add
  717.     dialog box.  Then specify the file names you want to add (standard OS/2
  718.     wildcards are accepted).
  719.  
  720.     The Add dialog box provides the following options:
  721.  
  722.     o   The Add, Freshen, and Update radio buttons correspond to the PKZIP
  723.         -a, -f, and -u options
  724.     o   The "delete original after adding" check box corresponds to the
  725.         PKZIP -m option
  726.     o   The Size and Speed radio buttons correspond to the PKZIP -ex and -es
  727.         options
  728.     o   The "Recurse subdirectories" check box corresponds to the PKZIP -r
  729.         option
  730.     o   The "Store recursed pathnames" check box
  731.          corresponds to the PKZIP -p option
  732.     o   The "Store specified pathnames" check box corresponds to the PKZIP
  733.         -P option
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.                                                                      page 15
  759.  
  760.     DELETING FILES FROM A ZIP FILE
  761.  
  762.  
  763.  
  764.     There are two ways to delete files from a ZIP:
  765.  
  766.     1) Object-action interface:  first select entries in the list box, then
  767.     click on the "Delete" push button or select the "Delete" entry from the
  768.     "Action" pull-down menu.
  769.  
  770.     2) Action-object interface:  click on the "Delete" push button or select
  771.     the "Delete" entry from the "Action" pull-down to bring up the "Delete"
  772.     dialog box.  You can then specify the file names you want to delete
  773.     (standard OS/2 wildcards are accepted).
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.                                                                      page 16
  813.  
  814.     EXTRACTING FILES FROM A ZIP FILE
  815.  
  816.  
  817.  
  818.     There are two ways to extract files from a ZIP:
  819.  
  820.     1) Object-action interface:  first select entries in the list box, then
  821.     click on the "Extract" push button or select the "Extract" entry from
  822.     the "Action" pull-down menu to bring up the Extract dialog box.
  823.  
  824.     2) Action-object interface:  click on the "Extract" push button or
  825.     select the "Extract" entry from the "Action" pull-down to bring up the
  826.     Extract dialog box.  You can then specify the file names you want to
  827.     extract (standard OS/2 wildcards are accepted) or extract all files in
  828.     the ZIP.
  829.  
  830.     The Extract dialog box lets you specify the directory to contain the
  831.     extracted files (note: the default directory for this prompt can be
  832.     changed by selecting "Extract Directory..." in the "Options" pull-down
  833.     menu).
  834.  
  835.     The Extract dialog box provides the following options:
  836.  
  837.     o   The "Overlay newer files only" check box corresponds to the PKUNZIP
  838.         -n option
  839.     o   The "Use pathnames" check box corresponds to the PKUNZIP -d option
  840.  
  841.     Note: the PKUNZIP -o option is always specified.
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.                                                                      page 17
  867.  
  868.     VIEWING FILES IN A ZIP FILE
  869.  
  870.  
  871.  
  872.     The View dialog box is used to view files in a ZIP file or view the
  873.     results of the last PKZIP or PKUNZIP command issued by PMZIP. Unlike
  874.     most dialog boxes, the View dialog box is sizeable and can be maximized.
  875.  
  876.     There are three ways to view files in a ZIP file:
  877.  
  878.     1) Double click on a file name in the list box listing files in the ZIP
  879.     file.
  880.  
  881.     2) Object-action interface:  first select entries in the list box, then
  882.     click on the View push button or select the "View" entry from the
  883.     "Action" pull-down menu.
  884.  
  885.     3) Action-object interface:  click on the "View" push button or select
  886.     the "View" entry from the "Action" pull-down to bring up the View dialog
  887.     box.  You can then specify the file name you want to view.
  888.  
  889.     Click on the Clipboard Copy push button to copy selected text to the
  890.     system clipboard.  Note: this button is disabled when no text is
  891.     selected.
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.                                                                      page 18
  921.  
  922.     FILE SEARCH FACILITY
  923.  
  924.  
  925.  
  926.     The File Search Facility is invoked by clicking on the Search button in
  927.     the Open dialog box.  Type a file name (standard OS/2 wildcards are
  928.     accepted) in the Pattern entry field of the Search dialog box and click
  929.     on the Search button to search an entire disk for the specified file(s).
  930.     You can then select any file found by this procedure and click on the
  931.     Open button to open the ZIP file.
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.                                                                      page 19
  975.  
  976.     OPTIONS
  977.  
  978.  
  979.  
  980.     The PMZIP option system consists of the following components:
  981.  
  982.     The Option pull-down menu lets you specify whether the list of files in
  983.     the ZIP file is sorted by date, extension, size, name, or whether the
  984.     original ZIP file order should be used. It also lets you bring up the
  985.     following dialog boxes described below.
  986.  
  987.     The Configuration dialog box lets you specify
  988.  
  989.     o   Whether the default directory in the Extract dialog box is the
  990.         current directory or a directory of your choice.
  991.     o   Whether the Open dialog box is automatically displayed when no ZIP
  992.         file is specified when PMZIP is started.
  993.     o   Whether files in the ZIP file are listed in lowercase for the
  994.         possibility of improved legibility.
  995.     o   Whether PMZIP should maintain a log of all error messages and all
  996.         PKZIP and PKUNZIP commands it issues. The log is written to the file
  997.         C:\PMZIP.LOG.
  998.     o   Whether PMZIP automatically changes the current directory when files
  999.         are dropped to the directory containing the files being dropped.
  1000.  
  1001.     The Defaults dialog box lets you save the current defaults for use next
  1002.     time PMZIP is started, or restore the original distribution defaults.
  1003.     Options that are saved and restored by this procedure include all the
  1004.     options in the "Options" pull-down menu, all options in the Add,
  1005.     Configuration, Extract, and Program Locations dialog boxes, and the
  1006.     current screen size.  Note that this information is also saved if PMZIP
  1007.     is running when you select "Save" from the "Desktop" pull-down in the
  1008.     "Desktop Manager" window.
  1009.  
  1010.     The Install dialog box will add a PMZIP entry to the first Program Group
  1011.     in the Desktop Manager (usually "Group - Main").  It will also set a
  1012.     File Manager association for *.ZIP files.  This association lets you
  1013.     double-click on any ZIP file listed in the File Manager to automatically
  1014.     open the ZIP file with PMZIP.
  1015.  
  1016.     The Program Locations dialog box lets you specify the file names used by
  1017.     PMZIP instead of the default PKZIP.EXE and PKUNZIP.EXE.
  1018.  
  1019.     The View last output entry in the Options pull-down displays the results
  1020.     of the last PKZIP or PKUNZIP command issued by PMZIP.
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.                                                                      page 20
  1029.  
  1030.     ERROR HANDLING
  1031.  
  1032.  
  1033.  
  1034.     When a PKZIP or PKUNZIP command issued by PMZIP returns a non-zero error
  1035.     level, a dialog box is displayed listing the error level and error level
  1036.     description.  You can click on the "View command output" button to view
  1037.     all messages issued by the command that caused the error.
  1038.  
  1039.     PMZIP will optionally maintain a log of all error messages and all PKZIP
  1040.     and PKUNZIP commands it issues. The log is written to the file
  1041.     C:\PMZIP.LOG.
  1042.  
  1043.     Note:  When a critical error (e.g. an open drive door) occurs while the
  1044.     PKZIP or PKUNZIP commands are running, you will get the standard OS/2
  1045.     error screen.  This is because the PKZIP and PKUNZIP commands were not
  1046.     coded to handle these errors.  PMZIP cannot control this behavior.
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.                                                                      page 21
  1083.  
  1084.     FILE MANAGER HINTS
  1085.  
  1086.  
  1087.  
  1088.     The OS/2 File Manager isn't the most versatile file management program,
  1089.     but it is the only one available for OS/2 with a Presentation Manager
  1090.     interface. The best way to learn to use it is to experiment and read the
  1091.     online help.  Pull-down all the menus, and if you don't know what an
  1092.     entry does, select it and press the F1 key for context sensitive help
  1093.     (note: if you're using the mouse, be sure to press F1 while holding down
  1094.     the mouse button).
  1095.  
  1096.     Here are two hints for using the File Manager. Your suggestions for
  1097.     additional hints are welcome.
  1098.  
  1099.     1) By default the file manager does not list file sizes and modification
  1100.     dates.  You can change this by selecting "File details" from the "View"
  1101.     pull-down menu.  To automatically list files by date select "Sort by"
  1102.     from the "View" menu and click on "Last modification date" in the "Sort
  1103.     by" dialog box and check the "Set system default" button before closing
  1104.     the dialog box.
  1105.  
  1106.     2) To open directories in the File Manager's tree display, double click
  1107.     on the name, not the icon.  Clicking on the icon can expand or collapse
  1108.     a branch of the tree, depending on whether there is a plus or minus sign
  1109.     in the directory icon.
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.                                                                      page 22
  1137.  
  1138.     KEYBOARD USAGE
  1139.  
  1140.  
  1141.  
  1142.     PMZIP is easier to use with a mouse, but you can also use the standard
  1143.     PM keyboard interface.  The Drag and Drop interface to the File Manager
  1144.     is not available from the keyboard. Keyboard accelerators defined for
  1145.     PMZIP include:
  1146.  
  1147.     Ctrl+N    Open new Zip file.
  1148.  
  1149.     Ctrl+O    Open existing ZIP file.
  1150.  
  1151.     Ctrl+A    Add files to a ZIP file.
  1152.  
  1153.     Ctrl+D    Delete files from a ZIP file.
  1154.  
  1155.     Ctrl+E    Extract files from a ZIP file.
  1156.  
  1157.     Ctrl+V    View files in a ZIP file.
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.                                                                      page 23
  1191.  
  1192.     FUTURE ENHANCEMENTS
  1193.  
  1194.  
  1195.  
  1196.     Ideas for future enhancements include:
  1197.  
  1198.     o   Support for all ZIP options, including passwords and comments
  1199.     o   Ability to run programs in a ZIP file
  1200.     o   Support for other file formats (e.g. ARC)
  1201.     o   Optional hex dump mode when viewing files in a ZIP File
  1202.  
  1203.     Additional suggestions are welcome!
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.                                                                      page 24
  1245.  
  1246.     NOTES
  1247.  
  1248.  
  1249.  
  1250.     o   This version of PMZIP was tested under OS/2 versions 1.20 and 1.30
  1251.         with PKZIP and PKUNZIP versions 1.01.
  1252.  
  1253.     o   PKZIP and PKUNZIP are registered trademarks of PKWARE, Inc.
  1254.  
  1255.     o   PMZIP does not manipulate ZIP files directly.  Instead it runs PKZIP
  1256.         and PKUNZIP for all operations.
  1257.  
  1258.     o   PMZIP displays an hour-glass pointer to indicate that it is busy
  1259.         while the PKZIP and PKUNZIP commands are running.  You can, of
  1260.         course, switch to another OS/2 session during this time.
  1261.  
  1262.     o   PMZIP supports most commonly used PKZIP and PKUNZIP options but the
  1263.         current version does not include special support for comments,
  1264.         passwords, and file attribute masks.
  1265.  
  1266.     o   PMZIP will try to use the "System Monospaced" font (the file
  1267.         SYSMONO.FON) first introduced in the November, 1989 update to OS/2
  1268.         1.2. If this font is not found it will use the standard Courier
  1269.         font.  The Courier font is always used for the text in the View
  1270.         dialog box because of a bug in some versions of OS/2 1.20.
  1271.  
  1272.     o   PMZIP sometimes passes a temporary "list file" to the PKWARE, Inc.
  1273.         programs.  PMZIP uses a unique filename for this file, and
  1274.         automatically erases it when it is no longer needed.  If you have a
  1275.         TMP= environment variable, temporary files are created in the
  1276.         specified directory. Otherwise they are created in the root
  1277.         directory of your C: drive.
  1278.  
  1279.     o   Ideally PMZIP should use the same selection techniques as the File
  1280.         Manager for manipulating files in a ZIP file.  However, that
  1281.         facility is not currently provided by the Presentation Manager, and
  1282.         is quite time consuming to program from scratch.  Since Windows 3.0
  1283.         provides this facility as a "Extended Selection List Box", we can
  1284.         hope it will be provided in the Presentation Manager in the near
  1285.         future, in which case I expect to use it in PMZIP. Meanwhile, the
  1286.         program uses the standard "Multiple Selection List Box", which,
  1287.         while not the ideal solution, should be familiar and easy to use.
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.                                                                      page 25
  1299.  
  1300.     o   PMZIP was written because I wanted a PM interface to ZIP files, and
  1301.         no other programs provided this facility.  The first version was
  1302.         written in Digitalk's Smalltalk V/PM.  The result, like all V/PM
  1303.         programs, required over a megabyte of code to execute, and was
  1304.         rather slow. Favorable response to the first version convinced me to
  1305.         rewrite the program in C and release it as Shareware.
  1306.  
  1307.     o   Special thanks to Steve Queen for his feedback on the PMZIP user
  1308.         interface.
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.     INDEX
  1355.  
  1356.  
  1357.  
  1358.          A                                    L
  1359.  
  1360.     Adding files to a ZIP file  14       License  5
  1361.  
  1362.  
  1363.          C
  1364.  
  1365.     Copyright  5
  1366.                                               O
  1367.  
  1368.          D                               Opening ZIP files  13
  1369.                                          Options  19
  1370.     Deleting files from a ZIP file       Overview  3
  1371.        15
  1372.     Drag and Drop Interface  9
  1373.                                               P
  1374.  
  1375.          E                               PKZIP, PKUNZIP, PKWARE  24
  1376.                                          Program locations  12
  1377.     Error Handling  20
  1378.     Extracting files from a ZIP
  1379.        file  16                               Q
  1380.  
  1381.                                          Quick start information.  8
  1382.          F
  1383.  
  1384.     File Manager hints  21                    S
  1385.     File Search Facility  18
  1386.     Future Enhancements  23              Search Facility  18
  1387.                                          Support and questions  7
  1388.  
  1389.          I
  1390.                                               V
  1391.     Installation  10
  1392.     Introduction  1                      Viewing files in a ZIP file
  1393.                                             17
  1394.  
  1395.          K
  1396.                                               W
  1397.     Keyboard usage  22
  1398.                                          Warranty  5
  1399.                                          WhereIs  18
  1400.  
  1401.  
  1402.                                                                      Index-1
  1403.