home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / packer / zipcontr / readme.doc < prev    next >
Encoding:
Text File  |  1994-02-23  |  19.2 KB  |  416 lines
  1.  RPF Zip Control(TM) Copyright 1993, 1994 RPF Software ALL RIGHTS RESERVED
  2.  
  3.  Abstract
  4.  --------
  5.  Zip Control is an OS/2 program which uses a PM interface to access
  6.  the freeware programs UNZIP.EXE and ZIP.EXE.  UnZip and Zip are 
  7.  command line programs which are compatible with versions 1 & 2 of the 
  8.  DOS PkZIP program.  UnZip and Zip are available as freeware on many 
  9.  BBS's which have OS/2 libraries, on the IBM NSC BBS, and on 
  10.  CompuServe (OS2USER forum, Library 4 for UNZ501.EXE, Library 1 for
  11.  ZIP201.ZIP).  Zip and UnZip are freeware products of Info-ZIP.
  12.  Zip Control is a shareware product of RPF Software.  Info-ZIP and
  13.  RPF Software are independent organizations.
  14.  
  15.  Zip Control is available on CompuServe (OS2BVEND Forum, Library 1, &
  16.  OS2USER Forum, Library 4), Pete Norloff's OS/2 Shareware BBS 
  17.  (703.385.4325), Fernwood BBS (203.483.0348), Pandora's Box
  18.  (619.291.9716), Prodigy OS/2 Club, America On Line, and other BBS's
  19.  which carry OS/2 software.  Primary support is via email and in
  20.  CompuServe's OS2BVEND Forum, Section One (OS/2 Shareware).
  21.  
  22.  Zip Control is copyrighted shareware, it is NOT PUBLIC DOMAIN, it is
  23.  NOT FREE.  You are encouraged to use it for a reasonable evaluation
  24.  period (21 days) to see if it is software which is helpful to you
  25.  and which you wish to continue using.  If you do decide to continue
  26.  using Zip Control, you MUST register your copy of Zip Control by
  27.  filling out the form in ORDER.DOC and sending it along with the
  28.  registration fee to RPF Software.
  29.  
  30.  Alternatively, and perhaps easier, you may register using the
  31.  CompuServe online registration service.  The registration fee will
  32.  be added to your CompuServe bill.  To use this method, GO SWREG.
  33.  The registration number is 1373 or search for "RPF Zip Control."
  34.  
  35.  The registration fee is currently US$22.00.
  36.  
  37.  Features of this Version
  38.  ------------------------
  39.  **Do not use this version of Zip Control with password encrypted
  40.    zip files.  See note below.
  41.  
  42.  - PM interface for the freeware UNZIP.EXE and ZIP.EXE programs.
  43.  
  44.  - "Open" provides standard OS/2 file open dialog box for the user 
  45.    to select which ZIP file to open and then displays the contents
  46.    of the ZIP file in a list box.
  47.  
  48.    "AutoOpen", when checked, will cause the file open dialog box to
  49.    appear at the beginning of each Zip Control session.  The AutoOpen
  50.    setting is remembered from session to session.
  51.  
  52.  - "Settings" - This notebook of settings includes settings for 
  53.    Options, Paths, and Programs.
  54.  
  55.    + "Options" saves user-specified default options:
  56.  
  57.      * "Respect" the stored path(s) in the ZIP file (or not)
  58.    
  59.        "Respect" (the default and recommended), when checked, will 
  60.        unzip the files in the .ZIP file to the target directory, 
  61.        create (if necessary) the relative paths (directories) as 
  62.        subdirectories to the target directory, and properly place 
  63.        the unzipped files in the correct subdirectories.
  64.  
  65.        When "Respect" is NOT checked, the files in the .ZIP file 
  66.        will be placed in the target directory . . . even if the
  67.        intended file paths had been stored in the .ZIP file.
  68.    
  69.      * "Update" existing files and create new ones as needed
  70.      
  71.        "Update" will, during the unzip process, replace existing 
  72.        files of the same name in the target directory IF and ONLY IF
  73.        the files in the .ZIP file have a later creation date than
  74.        the same-named files in the target directory.
  75.  
  76.        "Update" will also, during the unzip process, unzip any files 
  77.        in the .ZIP file which are not in the target directory.
  78.  
  79.      * "Freshen" existing files, but do not create new files
  80.  
  81.        "Freshen" will perform as "Update" (above) does but WILL NOT unzip 
  82.        any files in the .ZIP file which are not in the target directory.
  83.  
  84.        "Freshen" is not compatible with the "Never overwrite" option, 
  85.        since "never overwriting" existing files and not unzipping files
  86.        which do not exist in the target directory leaves nothing for 
  87.        UNZIP.EXE to do.
  88.  
  89.      * "Update" and "Freshen" are mutually exclusive selections.
  90.  
  91.      * With neither "Update" nor "Freshen" selected (the default and 
  92.        recommended), the files ("Selected" or "All") in the .ZIP 
  93.        file will be unzipped to the target directory, REPLACING any
  94.        existing files of the same name, regardless of file creation 
  95.        date, and also unzipping files which do not currently exist in
  96.        the target directory . . . subject to the "Never overwrite" 
  97.        option.
  98.  
  99.      * "Never overwrite" existing files
  100.  
  101.        "Never overwrite" will prevent UNZIP.EXE from unzipping files 
  102.        from the .ZIP file which already exist in the target directory.
  103.  
  104.    + "Paths" saves user-specified default paths
  105.    
  106.      * Directory where ZIP files usually are.  Set this path (drive
  107.        and directory) to where you normally download ZIP files.
  108.  
  109.      * Directory where ZIP files are usually unzipped into.  Set this
  110.        path (drive and directory) to where you usually want ZIP files
  111.        unzipped.
  112.  
  113.      * The option to, by default, unzip files into the same directory
  114.        in which each ZIP file is located (rather than using the 
  115.        default output directory).
  116.        
  117.    + "Programs" saves user-specified default programs
  118.    
  119.      * The name, and optionally path, of the ZIP program
  120.  
  121.      * The name, and optionally path, of the UNZIP program
  122.  
  123.      * The name(s) and optionally, path(s) of the program(s) with 
  124.        which you wish to view files stored within the ZIP file.
  125.  
  126.        A default viewer can be defined.  Additionally, specific 
  127.        viewers can be associated with files of user defined file
  128.        extensions.  For example, the viewers E.EXE, EPM.EXE,
  129.        VIEW.EXE, LIST.EXE, and GALLERIA.EXE could be associated with
  130.        <default>, .DOC, .INF, .TXT, and .BMP files respectively.
  131.        ICONEDIT.EXE could be associated with both .ICO and .PTR files.
  132.  
  133.        For ZIP files with embedded ZIP files, you could associate 
  134.        ZIPCNTRL.EXE with the .ZIP files, so that you could "view"
  135.        the contents of embedded ZIP files . . . and so on to 
  136.        multiple depths of viewing.
  137.  
  138.        With due caution, you could associate CMD.EXE /C or START /WIN
  139.        with .EXE files to run the .EXE programs.  Also, 
  140.        START /WIN xxxx.exe (e.g., WinWord.exe for WinWord .doc files)
  141.        will start a DOS or Windows application in a seamless window,
  142.        rather than running, in Windows' case, full screen Win-OS2.
  143.  
  144.        NOTE:  With the release of version 1.65, you may wish to forego
  145.        setting these "associations."  Version 1.65 introduced, as the
  146.        default, the use of the OS/2 System "associations."  These System
  147.        associations are initially set during OS/2 installation, but are
  148.        often added to or enhanced by the user over time.  By using the
  149.        system "associations", you can maintain only one set of associations.
  150.  
  151.  - "UnZip" acts on highlighted files in the list box (from the ZIP
  152.    file) or ALL files.  You first have an opportunity to override 
  153.    the defaults listed in "Settings - Options & Paths" above and 
  154.    to override the target directory.  The target directory will 
  155.    be created if it does not exist.  A progress indicator is 
  156.    provided.
  157.  
  158.    Also, the output path may be temporarily "for this session only"
  159.    changed to either the default output path, the last output path,
  160.    or the path where the .ZIP file is located.
  161.  
  162.    For ease in selecting previous target paths, a menu item "Output
  163.    path history" stores the last ten target paths.  This menu item
  164.    is also accessible as a window popup menu.
  165.  
  166.  - "View" passes ALL highlighted files in the list box to the
  167.    VIEW program(s) (E.EXE, LIST.EXE, etc.) defined in the 
  168.    Programs page of the Settings notebook.  This means several
  169.    files can be viewed at the same time.
  170.  
  171.    If the "SmartView" box is checked, each file viewed will be
  172.    viewed using the defined viewer for that type of file.  If the
  173.    box is not checked, the <default> viewer will be used.  The
  174.    default viewer may be helpful for viewing files which, as an 
  175.    example, have an .INF file extension, but are actually plain 
  176.    text files.  The "defined viewer for that type file" will be
  177.    determined by the "association" set via the Work Place Shell or
  178.    via the Zip Control Settings Notebook, as determined by the
  179.    menu bar Window Settings, SmartView Association.
  180.  
  181.  - "Print" presents a listing of the files which have been 
  182.    highlighted.  These files can be left selected (for printing)
  183.    or not (will not be printed).  Then the files will be printed
  184.    to the printer which is selected from one of the installed 
  185.    printers.
  186.  
  187.    Simple LaserJet 2-up printing is an option.
  188.  
  189.  - "Comments" displays the embedded ZIP file comments, if present.
  190.  
  191.    If the "AutoComments" box is checked, comments (if any) stored 
  192.    in the ZIP file will automatically be displayed.
  193.  
  194.  - "Product Information" shows contact information for RPF Software
  195.    and provides a method to enter user name and registration 
  196.    number (received after registration via ORDER.DOC or GO SWREG).
  197.  
  198.  - "Search" is used to build a list of all .ZIP files on one or 
  199.    more disk drives.  The list of files is sorted by name+date+
  200.    path, path+name+date, or date+name+path.  This sort order can 
  201.    be changed at any time, without necessitating a re-search of
  202.    the disk drives.  If "Ascending" is checked, then the sort
  203.    will be in ascending order, otherwise it will be in descending
  204.    order.
  205.  
  206.    Individual files in the list may be selected for either 
  207.    deletion (perhaps duplicates) or opening (unzipping).  
  208.  
  209.    All the other Zip Control capabilities are available for ZIP
  210.    files opened from the Search window.
  211.  
  212.  - "New" - Zip Control opens in "New" mode.  The file name is
  213.    "<Untitled>".  Choose "Add" to add files to the, as yet,
  214.    unnamed zip file.  If you choose "New" without having saved
  215.    a previous Untitled zip file, you will be given the opportunity
  216.    to save it.
  217.  
  218.  - "Add" - An entire directory or selected files may be added to 
  219.    the "Selected" list.  As you add each selection to the list,
  220.    the "Store path", "Subdirectories", "Freshen", "Update", "System/
  221.    Hidden", "ZIP date", and compression speed choices will be applied
  222.    to the selected files and directories.  Additions may be made to a 
  223.    new "<Untitled>" .ZIP file or to an existing named .ZIP file.
  224.  
  225.    See above for "Freshen" and "Update".
  226.  
  227.    "Zip all subdirectories too" zips all files in the selected 
  228.    directory plus all the files in its subdirectories.  In most
  229.    cases you should also select "Store path relative . . ." so
  230.    that Zip can resolve zipping two files with the same file
  231.    name.  If you are certain that no two file names in the
  232.    highlighted directory and its subdirectories have the same
  233.    name, "Store path relative . . ." is optional.
  234.  
  235.    "Store path relative . . ." will store the proper path (directory)
  236.    names in the zip file, relative to the highlighted directory.  If
  237.    you have selected several files from the "File" list, those 
  238.    files will be zipped, stored with the beginning path being the
  239.    highlighted path in the "Directory" list.  If you have selected
  240.    (highlighted) a directory with the "Select Directory" button, all
  241.    the files in the directory will be zipped, if All Files is checked;
  242.    otherwise, just the directory name will be stored.  If All Files is
  243.    checked and Store Path is checked, then the directory name along
  244.    with all its files will be stored.
  245.  
  246.    "System/Hidden" - Files with the system and/or hidden file attribute
  247.    are displayed in the file list, but are not stored in the zip file
  248.    unless this item is checked.
  249.  
  250.    "ZIP date = latest file date" - The file date of the .ZIP file
  251.    will be changed to match the date of the newest file in the
  252.    .ZIP file.
  253.  
  254.    Compression can be adjusted, by dragging the slider button, 
  255.    from 1 (the fastest compression mode--larger .zip files) to
  256.    9 (the slowest compression mode--smallest .zip files).  The
  257.    default is 6.
  258.  
  259.    Once files have been added to the "Selected" list, they may be
  260.    highlighted.  Files selected (highlighted) when the "Delete"
  261.    button is pressed will be removed from the "Selected" list.
  262.  
  263.    Files are not actually zipped and added to the .ZIP file until
  264.    the "OK" button is pressed.
  265.  
  266.    "Comments" - This selection allows you to add comments to the
  267.    .ZIP file.  After this selection is made, any current comments
  268.    for the file will be displayed.  These may be changed or deleted
  269.    or additional comments added.
  270.  
  271.    "Cancel" - All proposed additions to the .ZIP file and comment
  272.    changes are cancelled.
  273.  
  274.  - "Delete" - Use this selection to delete selected files from an
  275.    existing .ZIP file.  A confirmation is required.
  276.  
  277.  - "Save As" - An existing .ZIP file, either "<Untitled>" or named,
  278.    will be saved to a name you select.  Save As will not replace or
  279.    rename an existing file, but will create a copy of the existing
  280.    file with the new file name.  As an example, if the current file
  281.    is "Backup.zip", Save As may create a new file "110393.zip" (a
  282.    copy of Backup.zip), but leave Backup.zip as it was.  This will
  283.    allow you to safely delete and add files to the new .ZIP file
  284.    without harming the original .ZIP file.  The Save As has to be 
  285.    done prior to the deletion and addition since those choices
  286.    perform immediate deletion and addition to the current .zip file.
  287.  
  288.  Known Problems
  289.  --------------
  290.  - Password protected zip files are not currently supported.  
  291.    Attempts to unzip such files will stall Zip Control, and
  292.    you will have to use the window task list to close Zip
  293.    Control.  You may then also have to do Ctl-Esc and then
  294.    press Enter (when prompted) to complete the closure of
  295.    Zip Control.
  296.  
  297.    The cause for this is our current inability to intercept
  298.    UNZIP.EXE's request for the password.
  299.  
  300.  Zip Control Error Messages
  301.  --------------------------
  302.  - Most users find Zip Control easy to use and register the software
  303.    without reporting any problems.  However, other users may have a
  304.    different operating environment or may use Zip Control with .zip
  305.    files where ZIP.EXE or UNZIP.EXE send Zip Control error messages
  306.    which we have not seen before.  In those cases, the ZC users will
  307.    see a general error message from ZC which displays the error number
  308.    and additional information and is asked to report the circumstances
  309.    to RPF Software.
  310.  
  311.    At that point RPF Software duplicates the problem and, if the
  312.    problem is caused by Zip Control, makes the necessary software
  313.    repairs to properly handle the problem.  A new version of ZC is
  314.    then made available.
  315.  
  316.  - The error message may offer to display the specific error message
  317.    as reported by zip.exe or unzip.exe.  This may alert you to a
  318.    problem with the .zip file with which you are working.
  319.  
  320.  Futures
  321.  -------
  322.  Use of threads.
  323.  Help buttons/system.
  324.  Right mouse button support.
  325.  More use of drag-and-drop within Zip Control.
  326.  PkUnZip, PkZIP, LHArc support.
  327.  Performance improvements.
  328.  User suggestions will be incorporated, as appropriate.
  329.  
  330.  Files Included
  331.  --------------
  332.  ReadMe.doc
  333.  History.doc
  334.  Order.doc
  335.  Warranty.doc
  336.  SysOp.doc
  337.  ZipCntrl.exe
  338.  
  339.  Installation Instructions
  340.  -------------------------
  341.  Unzip the delivery files to a new directory, such as \ZipCntrl.
  342.  Create a workplace shell object which references ZipCntrl.exe
  343.  (with full path) as the program name and enter the same path as
  344.  the working directory.
  345.  
  346.  Run Zip Control by either double clicking on the Zip Control
  347.  object on the desktop OR by dragging one or more .ZIP files
  348.  to the Zip Control desktop object (using the right mouse
  349.  button).  If multiple .ZIP files are dragged to the Zip Control 
  350.  object, multiple versions of Zip Control will be started, each 
  351.  displayed on top of the other.  You can then use these to perform 
  352.  simultaneous unzips or to investigate the various .ZIP files, 
  353.  comparing dates of zipped files, and viewing zipped files.
  354.  
  355.  If an "association" is established for *.zip files (to the Zip
  356.  Control desktop object), Zip Control can be started by double
  357.  clicking .zip files displayed using the Drives object.  To
  358.  establish the association, open the Settings window for the
  359.  Zip Control desktop object and select the "Association" page
  360.  (tab).  In the lower section of the page, enter "*.zip" 
  361.  (without the quotes) in the "New Name" field.  Then select "Add."
  362.  
  363.  If there had been a previous association established with another
  364.  program, that association should be removed from either the other
  365.  program's desktop object OR from the other program's .EXE file (via
  366.  the Drives object), before establishing a new association with Zip
  367.  Control.  To determine whether a previous association is in effect
  368.  and to what program or object, do a right mouse button click on a
  369.  Drives listing of a .zip file, then select the arrow to the right
  370.  of "Open."  Any current associations will be listed below the word
  371.  "Settings."
  372.  
  373.  Use the "Paths" page of the "Settings" notebook in Zip Control 
  374.  to define the path where .ZIP files will usually be found, 
  375.  such as C:\DOWNLOAD.  Also, define a default output directory, 
  376.  such as C:\SCRATCH and a work location directory.  If you do not
  377.  define a Work Location, the default work location directory will 
  378.  be set to the directory in which zipcntrl.exe resides.  A change
  379.  in Work Location does not take effect until restarting Zip Control.
  380.  
  381.  Note:  A subdirectory, ~ZIPWork, of the work location directory 
  382.  is used for Zip Control temporary files created when using "View",  
  383.  "Print", "New", "Add", and "Delete".  The temporary files should be 
  384.  automatically cleaned up.  However, if they are not automatically 
  385.  deleted, you may delete them at any time.  The temporary files 
  386.  should all be located in the ~ZIPWork subdirectory.
  387.  
  388.  You may wish to create a "shadow" of your default output 
  389.  directory (e.g., C:\SCRATCH) on your desktop and have it open
  390.  when using Zip Control.  As you unzip each .ZIP file, the 
  391.  unzipped files will appear in the output directory on your
  392.  desktop where you can either test run the unzipped application
  393.  or otherwise evaluate the files.  Then, when you no longer
  394.  want those unzipped files, you can graphically "select" all
  395.  (or some) of the unzipped files and delete them.
  396.  
  397.  Advanced users may wish to create a Zip Control work area (folder)
  398.  on the desktop, containing open shadows of Zip Control, the 
  399.  default .ZIP directory, and the default output directory.  Rather
  400.  than closing Zip Control, close the Zip Control work area while
  401.  the application is still running.  Thereafter, when you open
  402.  the Zip Control work area, Zip Control will start automatically,
  403.  and the two working directory folders will reopen where you last 
  404.  left them.
  405.  
  406.  ------------------ Contact Information for Support -------------------
  407.  Attn:  Richard Fortson        FAX:  404.250.0282
  408.  RPF Software                  CompuServe:  71660,535
  409.  P.O. Box 420457               INTERNET:71660.535@compuserve.com
  410.  Atlanta, GA  30342            (use above for Prodigy, AOL, MCIMAIL, Internet)
  411.  
  412.  --------------------------
  413.  "Support OS/2 development"
  414.  --------------------------
  415.  
  416.