home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / ZIPQ050.ZIP / ZIPQ.DOC next >
Text File  |  1991-05-26  |  11KB  |  350 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                   ZipQ For OS/2 PM
  30.  
  31.                                     Version 0.50
  32.  
  33.                                          By
  34.  
  35.                                     Chris Barker
  36.  
  37.                               Compuserve ID: 72261,2312
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                                     Contents
  51.  
  52.  
  53.                   1  QUICK START . . . . . . . . . . . . . . . . . . 2
  54.                   2  CUSTOMIZING   . . . . . . . . . . . . . . . . . 3
  55.                   3  HISTORY . . . . . . . . . . . . . . . . . . . . 4
  56.                   4  FUTURE PLANS  . . . . . . . . . . . . . . . . . 4
  57.                   5  PROGRAMMING NOTES . . . . . . . . . . . . . . . 4
  58.                   6  KNOWN BUGS  . . . . . . . . . . . . . . . . . . 5
  59.                   7  DISTRIBUTION AND USE OF PROGRAM . . . . . . . . 5
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.                                           i
  102.  
  103.           ZipQ for OS/2 PM Documentation           5/25/91           Page 2
  104.  
  105.  
  106.  
  107.           ZipQ  is  an  OS/2  Presentation  Manager  program   designed  to
  108.           facilitate access to files compressed using  the  PKZIP utilities
  109.           developed by Phil Katz.
  110.  
  111.           ZipQ  allows you to view a list of files compressed in a Zip file
  112.           and to selectively  extract  and  perform  various  operations on
  113.           these files.
  114.  
  115.           To make complete use of ZipQ,  you  should have a copy of PKUNZIP
  116.           for OS/2 located somewhere along your PATH statement.  If  you do
  117.           not  have PKUNZIP you will only be able to view the contents of a
  118.           zipped file with ZipQ.
  119.  
  120.           =================================================================
  121.  
  122.  
  123.           1  QUICK START
  124.  
  125.  
  126.           To run ZipQ from an OS/2 window prompt you would type:
  127.  
  128.                zipq [file name] <ENTER>
  129.  
  130.           The filename parameter is optional.  If a valid zipped  file name
  131.           is passed to ZipQ it will automatically read the file's directory
  132.           structure and display its contents in a scrollable  listbox.   If
  133.           no  name is passed, then ZipQ will install  itself  on  the  OS/2
  134.           Desktop as an icon.
  135.  
  136.           You  may also use the PM File Manager  and  form  an  association
  137.           between '*.ZIP' files and ZipQ.  Doing so, will allow  you double
  138.           click  on  a  Zip  file  in  the  File  Manager  and   have  ZipQ
  139.           automatically invoked with the listing of the file chosen.
  140.  
  141.           Once  a file has been listed by ZipQ,  you  may  perform  several
  142.           actions to perform.
  143.  
  144.           The most direct action is to double click with the  mouse pointer
  145.           on a file name displayed in the list box. This action  will cause
  146.           ZipQ  to  unzip  that file from the zipped file and then invoke a
  147.           file  viewing  utility  to view the contents of the just unzipped
  148.           file.
  149.  
  150.  
  151.           ZipQ for OS/2 PM Documentation           5/25/91           Page 3
  152.  
  153.  
  154.  
  155.           =================================================================
  156.  
  157.  
  158.           2  CUSTOMIZING
  159.  
  160.  
  161.           You may specify your own choices for file viewers and  editors by
  162.           accessing the Options|Settings menu and typing  in  your favorite
  163.           editor and viewer. If your program is already in your search path
  164.           you can just enter the program name and  its  extension (usually,
  165.           .EXE).  The program must be an OS/2 program but  can  be either a
  166.           text or PM  application.  Alternately, you may specify a complete
  167.           file name  including it's path. While we are discussing settings,
  168.           you  may  specify the directory you wish  ZipQ  to  use  when  it
  169.           extracts files. This should be  a directory that does not contain
  170.           files you mind getting overwritten since ZipQ invokes the -O (for
  171.           overwrite file if found) option  for all of its extract routines.
  172.           The default values for the settings are as follows:
  173.  
  174.                Extract Directory       C:\TEMP
  175.  
  176.                Default Editor          E.EXE
  177.  
  178.                Default Viewer          PMVIEW.EXE
  179.  
  180.           After making your changes, you may save them to disk  by checking
  181.           the  Save  Changes  checkbox, which is checked  by  default,  and
  182.           clicking the Ok button. The changes will then be  saved  to  your
  183.           OS2.INI file. Each time ZipQ is started it  will  consult OS2.INI
  184.           for  the  settings that have been saved.  If  you  wish  to  make
  185.           temporary changes, just uncheck  the  Save  Options check box and
  186.           click on Ok. Any changes made in this mode will only last for the
  187.           current ZipQ session.
  188.  
  189.           ZipQ  makes use of the threading capabilities  of  OS/2  when  it
  190.           reads the contents of a Zip file. You will notice that control is
  191.           immediately returned to you as soon as you select a file from the
  192.           File|Open dialog box. Ordinarily,  because  many  Zip  files only
  193.           contain  a  few  files,  the  list  box  will  be  filled  almost
  194.           instantaneously. But,  when you access Zip files with hundreds of
  195.           files  or  Zip  files  on  a  floppy  disk, you  will  appreciate
  196.           regaining control of the desktop  while  the  ZipQ  worker thread
  197.           quietly works in the  background.  This  allows  you to work with
  198.           other programs while  ZipQ  reads the zipped file. Currently, you
  199.           can only access one Zip file at a time, since ZipQ is only an SDI
  200.           (single document interface) application. With a little luck, this
  201.           will  change  in  future releases as I learn how to create an MDI
  202.           (multiple document interface) application.
  203.  
  204.  
  205.           ZipQ for OS/2 PM Documentation           5/25/91           Page 4
  206.  
  207.  
  208.  
  209.           =================================================================
  210.  
  211.  
  212.           3  HISTORY
  213.  
  214.  
  215.           05-25-91        Premier edition of ZipQ version 0.50 released.
  216.  
  217.           =================================================================
  218.  
  219.  
  220.           4  FUTURE PLANS
  221.  
  222.  
  223.           It should be apparent that this is just a skeleton of what I hope
  224.           to achieve in the future. Some ideas I  am  working  on  for ZipQ
  225.           include:
  226.  
  227.              1.  Turning ZipQ into an  MDI  application  with OS/2 1.3 drag
  228.                  and   drop  capabilities   between   windows   and   other
  229.                  applications.
  230.  
  231.              2.  Better  incorporation of PKUNZIP processing and  detaching
  232.                  of extraction processes.
  233.  
  234.              3.  Automatic  invocation  of  OS/2  applications   upon  file
  235.                  extraction based on association settings in user's OS2.INI
  236.                  file.
  237.  
  238.              4.  Zip file disk search utility.
  239.  
  240.              5.  Display all information about  zipped  files  (e.g. dates,
  241.                  size, etc.)
  242.  
  243.              6.  Possible accommodation of other file  compression formats.
  244.                  Most likely LHARC.
  245.  
  246.              7.  Addition of on-line Help.
  247.  
  248.           =================================================================
  249.  
  250.  
  251.           5  PROGRAMMING NOTES
  252.  
  253.  
  254.           ZipQ was written entirely  in  Modula-2  using JPI's Modula-2 for
  255.           OS/2 version 2  release  1.06. Those interested in examining code
  256.           for OS/2 PM written with Modula-2, should look for my  archive of
  257.           source code examples called PM-M2x.ZIP on your favorite BBS or on
  258.           Compuserve.
  259.  
  260.  
  261.           ZipQ for OS/2 PM Documentation           5/25/91           Page 5
  262.  
  263.  
  264.  
  265.           =================================================================
  266.  
  267.  
  268.           6  KNOWN BUGS
  269.  
  270.  
  271.              1.  When the client window is  resized and the number of files
  272.                  in  the  directory  of  a  zip  file  are  not  enough  to
  273.                  completely  fill  the  list  box,  the  scrollbar  is  not
  274.                  redrawn.  Resizing or clicking where the  scrollbar should
  275.                  be will reinstate the scrollbar. I'm probably not handling
  276.                  a paint message correctly?
  277.  
  278.              2.  No error checking is done by ZipQ if  you  do  not  have a
  279.                  disk in a floppy  drive.  Put a disk in the selected drive
  280.                  and select retry when you get an error message.
  281.  
  282.           =================================================================
  283.  
  284.  
  285.           7  DISTRIBUTION AND USE OF PROGRAM
  286.  
  287.  
  288.           In the interest of promoting the use and popularity of OS/2  I am
  289.           asking people to copy  this  program freely. Even so, this is not
  290.           public domain software and I own the copyrights to this material.
  291.           In the spirit of the  free exchange of computing information, and
  292.           as  a tribute to such  "freeware" pioneers  as  Vernon  Buerg,  I
  293.           simply ask that you abide by the following guidelines:
  294.  
  295.           This  document    and    the    ZIPQ.EXE   file comprise the ZIPQ
  296.           program ("software").   This  software  is  copyrighted  material
  297.           and is  subject to limitations by the copyright holder ("author")
  298.           as to its use and distribution.
  299.  
  300.           You may  use the   software; make  copies of  the software;  give
  301.           copies to anyone; and distribute  it via electronic means.  There
  302.           is no charge  for this software,  but you must include a copy  of
  303.           this document with any copies that you make.
  304.  
  305.           You  are  specifically  prohibited  from  charging  or requesting
  306.           donations   for  any  copies;  from  modifying the software; from
  307.           distributing the software  with commercial products without prior
  308.           written permission; and from distributing this software,   either
  309.           alone  or with other material,  and charging any fee.  There  are
  310.           no exceptions.
  311.  
  312.           There  is  no  warranty  of  any   kind given.  The author is not
  313.           liable for damages   of any kind.   By using this  free software,
  314.           you agree to this.
  315.  
  316.           If you  are using  ZIPQ and  find it  of value,  your gift in any
  317.           amount ($15  suggested) will be greatly appreciated.  Please make
  318.           checks payable in U.S. dollars to Christopher T. Barker.
  319.  
  320.  
  321.           ZipQ for OS/2 PM Documentation           5/25/91           Page 6
  322.  
  323.  
  324.  
  325.           The software and documentation are:
  326.  
  327.                Copyright (C) 1991 by Christopher T. Barker
  328.  
  329.                10809 Melvin Grove Ct.
  330.                Kensington, MD 20895
  331.                U.S.A.
  332.  
  333.           I may also be reached electronically at the following locations:
  334.  
  335.                Compuserve ID: 72261,2312
  336.  
  337.                The Fidonet OS/2 conference
  338.  
  339.                Pete Norloff's OS/2 Shareware BBS - (703) 385-4325
  340.  
  341.                Programmer's Corner - (301) 596-1180
  342.  
  343.                CPCUG Mix (OS/2 - Window Sig) BBS - (301) 738-9060
  344.  
  345.           Comments and suggestions are always welcome.
  346.  
  347.           Enjoy!
  348.  
  349.  
  350.