home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1995 November / PCWK1195.iso / inne / podstawy / dos / 4dos / 4uzytki / 4zip201.exe / 4ZIP.TXT < prev    next >
Text File  |  1991-12-14  |  21KB  |  653 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                              4ZIP/4UNZIP USER'S GUIDE
  12.  
  13.                                     DECEMBER 1991
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                                     _______
  25.                                                ____|__     |               (tm)
  26.                                             --|       |    |-------------------
  27.                                               |   ____|__  |  Association of
  28.                                               |  |       |_|  Shareware
  29.                                               |__|   o   |    Professionals
  30.                                             -----|   |   |---------------------
  31.                                                  |___|___|    MEMBER
  32.  
  33.                                                           Iram J. Weinstein
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                                       XD SYSTEMS
  57.                                     1014 SHIPMAN LANE
  58.                                     MCLEAN, VA 22101
  59.  
  60.  
  61.  
  62.  
  63.                                CONTENTS
  64.  
  65.  
  66.  
  67.              Limited Warranty                                      1
  68.  
  69.              Background                                            2
  70.  
  71.              4ZIP Usage                                            2
  72.  
  73.              4UNZIP Usage                                          5
  74.  
  75.              Extended Descriptions                                 5
  76.  
  77.              Regarding Registration                                6
  78.  
  79.              4ZIP/4UNZIP Version History                           7
  80.  
  81.              4EDIT                                                 8
  82.  
  83.              Software Registration Form and Order                  9
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.                            LIMITED WARRANTY
  124.  
  125.  
  126.  
  127.         XD Systems warrants the physical diskette enclosed herein to
  128. be free of defects in materials and workmanship for a period of 60
  129. days from the date of purchase.  In the event of notification within
  130. the warranty period of defects in material or workmanship,  XD
  131. Systems will replace the defective diskette.
  132.  
  133.         XD Systems specifically disclaims all other warranties,
  134. express or implied, including but not limited to implied warranties
  135. of merchantability and fitness for a particular purpose.  In no event
  136. shall XD Systems be liable for any loss of profit or any  other
  137. commercial damage, including but not limited to special,  incidental,
  138. consequential or other damages arising out of the use,  the result of
  139. use, or inability to use this product.
  140.  
  141.         This program is produced by a member of the Association of
  142. Shareware Professionals (ASP).  ASP wants to make sure that the
  143. shareware principle works for you.  If you are unable to resolve a
  144. shareware-related problem with an ASP member by contacting the member
  145. directly, ASP may be able to help.  The ASP Ombudsman can help you
  146. resolve a dispute or problem with an ASP member, but does not provide
  147. technical support for members' products. Please write to the ASP
  148. Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 or send a
  149. Compuserve message via easyplex to ASP Ombudsman, 70007,3536.  The
  150. ombudsman may also be contacted by FAX by sending to the ASP FAX
  151. number: (616) 788-2765.  In communication with the Ombudsman, please
  152. include a telephone number and/or FAX if possible.
  153.  
  154.         4DOS is a trademark of J.P. Software.  PKZip and PKUnzip are
  155. trademarks of PKWare.  4ZIP, 4UNZIP and all the files and documentation
  156. distributed with them are copyright 1990,1991 by Iram J. Weinstein.  All
  157. rights reserved.
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.                                  -1-
  180.  
  181.  
  182.  
  183.  
  184.                        4ZIP/4UNZIP User's Guide
  185.  
  186.                        Copyright (C) 1990, 1991
  187.                            I. J. Weinstein
  188.  
  189.         A.BACKGROUND
  190.  
  191.              4DOS provides a way of attaching descriptions to files
  192.         on your disk that is apparently seamless.  The descriptions
  193.         appear on directory displays and automatically are copied
  194.         when you COPY or MOVE a file to another disk or directory.
  195.  
  196.             But this seamless property fails as soon as you use other
  197.         programs on your files.  For example, if you archive the files
  198.         with the PKware programs PKZIP or PKUNZIP, the descriptions
  199.         stay behind.  4ZIP and 4UNZIP address this problem, providing
  200.         an automatic method to store descriptions in ZIPFiles and to
  201.         restore them when you extract a file.
  202.  
  203.             You should know that the DESCRIPT.ION file is a hidden file.
  204.         You will not see it in the DOS directory unless you change the
  205.         file attribute or use the 4DOS DIR /h option.
  206.  
  207.             You must have copies of the PKware utilities located on the
  208.         DOS Path, or in the current directory.  These shareware programs
  209.         are not supplied with 4ZIP/4UNZIP.  You can obtain them from many
  210.         Shareware distributors, BBS's or from PKware directly at:
  211.  
  212.                         PKware Inc.
  213.                         7545 North Port Washington Road
  214.                         Glendale, WI 53217
  215.  
  216.         XD Systems is not affiliated with PKware in any way.
  217.  
  218.  
  219.         B. 4ZIP USAGE
  220.  
  221.              4ZIP Usage is:
  222.  
  223.         4ZIP ZIPFILE [Options] [d:][path][filespec] [filespec] [..]
  224.  
  225.                                ***OPTIONS***
  226.    /a            ZIP all files matching filespecs without query
  227.    /m            Move selected files from source  directory to the ZIPFILE
  228.    /odeinsu      Order by Date created Ext descrIption Name Size Unsorted
  229.    {-bekoqs!3$}  Pass these commands on to PKZIP
  230.  
  231.  
  232.                 A directory display similar to that of SELECT will appear
  233.         showing all of the files meeting any of the filespecs. This use of
  234.         include lists is like the 4DOS DIR and SELECT usage. Filespecs can
  235.         freely use the wildcard characters '*' and '?'. For example the
  236.         filespecs c:\wp\*smith*.*; *. xyz would display all the files in the
  237.         c:\wp directory that either have the letters smith in the name part
  238.         or have xyz as the extension. Note that only the first argument in an
  239.         include list can have a pathname; subsequent arguments default to the
  240.  
  241.                                        2
  242.  
  243.  
  244.         same path.  Filespecs in an include list can be separated by ';',
  245.         as in 4DOS, or, for convenience, '+' or  ' '.
  246.  
  247.              You can mark files to be ZIPped into ZipFile in several
  248.         ways, using the keyboard or mouse, similar to the 4DOS SELECT
  249.         command, as follows:
  250.  
  251.                    Mark         <+> <INS>
  252.                    UnMark       <-> <DEL>
  253.                    Toggle       <SPACE> <Left Click>
  254.                    Toggle All   <*> <CTRL ENTER>
  255.                    Begin Block  <F7> <CTRL K B>
  256.                    End Block  <F8> <CTRL K K>
  257.  
  258.  
  259.                 To move the selection bar around the list of files, use
  260.         the cursor, the mouse, or the following keys:
  261.  
  262.                    <UP>    Up one line
  263.                    <DOWN>  Down one line
  264.                    <PGUP>  Up one full screen
  265.                    <PGDN>  Down one full screen
  266.                    <HOME>  To top of list
  267.                    <END>   To bottom of list
  268.  
  269.                 Additional functions are:
  270.  
  271.         <F1>                   Display Help screens
  272.         <ENTER>                ZIP marked files into ZIPFILE
  273.         <ESC> <Right Click>    Quit 4ZIP without doing anything
  274.  
  275.  
  276.        1.Options
  277.  
  278.          a. Sorting
  279.                 4ZIP will allow you to control the order in which files are
  280.         displayed and zipped. The syntax is:
  281.  
  282.       /o[deinsu] Order by Date created Ext descrIption Name Size Unsorted
  283.  
  284.  
  285.          b.International Date and Time
  286.                 4ZIP/4UNZIP now is consistent with your country=xxx
  287.         command in config.sys.  Commandline overrides for the time format
  288.         are provided. They are:
  289.  
  290.         /24  Use 24 hour time
  291.         /12  Use 12 hour time (e.g., 10:35p)
  292.  
  293.  
  294.              4ZIP has two options which can be used singly or
  295.         together, e.g., /a /m, or /am.
  296.  
  297.  
  298.  
  299.  
  300.  
  301.                                        3
  302.  
  303.  
  304.         /a  ZIP all files matching filespecs without query.
  305.  
  306.                 4ZIP Junk /a  C:\SOURCE\*.Pas + *MATH*.INC
  307.  
  308.             would ZIP into JUNK.ZIP all files from the C:\SOURCE
  309.             directory that either had the extension PAS or the
  310.             extension INC and MATH anywhere in the filename.
  311.  
  312.         /m  Move selected files from source directory to the ZIPFile.
  313.  
  314.             This works by deleting the files from the source
  315.             directory after ZIPping.
  316.  
  317.          c. PKZIP Command Options
  318.                 4ZIP will accept the following subset of the PKZIP
  319.         commands and will pass them on to PKZIP: 'b', 'e', 'k', 'o', 'q',
  320.         's','!','3','$'.  You'll have to read the PKZIP documentation to
  321.         learn the meaning of these options.
  322.  
  323.                 To pass commands to PKZIP, just enclose them in curly
  324.         brackets anywhere on the 4ZIP command line.
  325.  
  326.         For example:
  327.  
  328.                     4ZIP myfiles {-o -es -!} *.txt
  329.         or
  330.                   4ZIP myfiles {-o}  *.txt { -es -!}
  331.  
  332.         would both pass the commands -o -es -! to PKZIP.
  333.  
  334.                 Some of the other PKZIP commands (e.g., '@', or 'f') are
  335.         not compatible with 4ZIP and would mess up the tracking between files
  336.         and their descriptions.  4ZIP will ignore these options if you try to
  337.         use them.
  338.  
  339.                 IF you use a PKZIP configuration file, make sure that
  340.         you do not try to pass commands that would not be acceptable
  341.         on the 4ZIP command line, as unpredictable results will occur,
  342.         mainly mismatching descriptions with the files.
  343.  
  344.  
  345.          d. Help Key F1
  346.  
  347.                 The help screens are displayed anytime F1 is pressed.
  348.         Running 4ZIP with an error on the command line automatically
  349.         invokes the help display.
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.                                        4
  362.  
  363.  
  364.         C. 4UNZIP USAGE
  365.  
  366.              4UNZIP Usage is:
  367.  
  368.   4UNZIP ZIPFILE [Options] [outpath] [d:][path][filespec] [..]
  369.  
  370.              The display is similar to the 4ZIP display, showing
  371.         all the files in the ZipFile that meet any of the filespecs.
  372.         Marking of the files to be extracted and cursor movement
  373.         around the screen is identical to 4ZIP.
  374.  
  375.              4UNZIP has several options.  The first two are similar to
  376.         the ones provided for 4ZIP.
  377.  
  378.         /a  UNZIP all files matching filespecs without query.
  379.         /m  Move selected files from the ZIPFile to the outpath
  380.             directory (Current directory is default).
  381.  
  382.         /d  Delete selected files from the ZIPFile without extracting.
  383.  
  384.         This provides a convenient tool for ZipFile management,
  385.         allowing you to select files to be removed using any
  386.         combination of filespecs with wild cards and the SELECT screen.
  387.         The combination /ad will delete all the specified files
  388.         without presenting the SELECT screen.  The combination /md
  389.         is interpreted the same as /m alone.
  390.  
  391.         Outpath, if supplied, determines the directory in which the
  392.         extracted files are to be placed.  So for example
  393.  
  394.                  4UNZIP C:\SOURCE\JUNK A:\ /am *.doc
  395.  
  396.         would extract all of the files with extension doc from the
  397.         file  C:\SOURCE\JUNK.ZIP and place them in the root directory
  398.         of the A: drive.  Then it would delete all of these files
  399.         from JUNK.ZIP.
  400.  
  401.                 4UNZIP also accepts a subset of the PKUNZIP commands,
  402.         using the same syntax as 4ZIP.  The commands that 4UNZIP will
  403.         recognize are: 'c', 'p', 'q', 's'.
  404.  
  405.  
  406.         D. EXTENDED DESCRIPTIONS
  407.  
  408.                 4DOS 4.0 has capacity for descriptions up to 80 characters
  409.         in length, and has a system for developers to extend the des-
  410.         criptions to even greater lengths or to store other file-
  411.         related information.  However, the PKZIP comment format
  412.         has room for only 59 characters.  4ZIP and 4UNZIP are designed to
  413.         save and restore file descriptions up to the full length of 80
  414.         characters, and will also capture and restore any extended
  415.         description fields if present.  This all happens automatically.
  416.  
  417.         How it's done -- The PKZIP directory structure allows for file
  418.         descriptions of only 59 characters.  If all the Zipped files have
  419.         descriptions that will fit and there are no extended fields  in their
  420.  
  421.                                   5
  422.  
  423.         descript.ion entries, then the descriptions are stored in the PKZIP
  424.         file directory, as in previous versions of 4ZIP. Otherwise, truncated
  425.         descriptions are stored in the PKZIP directory, so they can be seen
  426.         without 4UNZIP, and a special file with name 4ZIP_xxx.xxx (where the
  427.         x'es are random letters) is added to the ZipFile, containing the full
  428.         descript.ion entries.  If the ZipFile is added to, more than one of
  429.         these files may be present.
  430.  
  431.         You will see these files listed on the screen by PKZIP, but otherwise
  432.         you should ignore them.
  433.  
  434.  
  435.         E. REGARDING REGISTRATION
  436.  
  437.              4ZIP/4UNZIP is ShareWare. The law requires that if you use
  438.         this program, you must register and obtain a license for it. The
  439.         registration fee is $15.  A registration form is included at the
  440.         end of this manual.
  441.  
  442.              Registered users will be notified of upgrades to 4ZIP/4UNZIP as
  443.         they are released, and will receive the latest version of the
  444.         program.  Online help is available through CompuServe, by
  445.         EasyPlex.  Help is also available by mail. I will try to answer
  446.         all letters within 48 hours. Non-registered users must include
  447.         a SASE for a reply. The degree of help available to non-registered
  448.         users is purely discretionary. Registrations and inquiries should
  449.         be sent to:
  450.  
  451.                                  Iram J. Weinstein
  452.                                  XD Systems
  453.                                  1014 Shipman Lane
  454.                                  McLean, VA 22101
  455.                                    Voice (703) 821-3215
  456.                                    CIS 70741,3711
  457.  
  458.  
  459.              Commercial use of 4ZIP/4UNZIP without payment of the reg-
  460.         istration fee is prohibited. Site licenses are available for users
  461.         with multiple machines. Please contact me for information.
  462.  
  463.              The program and its associated documentation are the
  464.         copyrighted property of the author. Non-commercial users
  465.         are granted the right to use copy and share 4ZIP/4UNZIP with the
  466.         following conditions:
  467.  
  468.             Shareware distributors and Users Groups may charge a
  469.         nominal fee for copying and distributing this program
  470.         and Bulletin Board Systems may likewise carry it. Any
  471.         distribution of 4ZIP/4UNZIP must include without alteration
  472.         only the files listed: 4ZIP.EXE, 4UNZIP.EXE and 4ZIP.TXT, unchanged.
  473.         Permission is also given for electronic distribution of
  474.         archived versions of these files on electronic bulletin boards.
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.                                   6
  482.  
  483.  
  484.         F. 4ZIP/4UNZIP VERSION HISTORY
  485.  
  486.   Ver 0.90 (Beta Test) 12/01/89
  487.     This is the original release.  It used batch files to drive
  488.     4ZIP and 4UNZIP and could only run under 4DOS.
  489.  
  490.   Ver 0.91 (Beta Test) 12/20/89
  491.     4ZIP and 4UNZIP now stand alone, and can be run under DOS.  4UNZIP
  492.     accesses the ZipFile Directory itself without using PKZIP -v. This is
  493.     much faster.
  494.  
  495.   Ver 0.92 (Beta Test) 1/21/90
  496.     Improved exception handling for DOS errors.
  497.     Added /d and /m options to 4UNZIP
  498.     Allow specification of destination path for the extracted files in 4UNZIP
  499.  
  500.   Ver 0.93 (Beta Test) 2/04/90
  501.   1. Changed mark/unmark in 4ZIP and 4UNZIP to be more like the latest
  502.   SELECT.  Space bar toggles mark and * marks all.
  503.   2. 4ZIP lost descriptions on some files in big directories. Now
  504.   fixed.
  505.   3. Ver 0.92 of 4ZIP tried to correct command line parser so that
  506.   C: ==> C:*.* and ABC ==> ABC\*.* if ABC is a directory but
  507.   ABC.* otherwise. Got it right this time!
  508.  
  509.   Version 1.0  3/11/90
  510.   First public release
  511.  
  512.   Version 1.01  3/21/90
  513.   1. Corrected error (shame on me) in 4UNZIP that included  marker
  514.      in filename.
  515.   2. Corrected 4UNZIP error when destination path is not source path.
  516.   3. Minor changes in documentation.
  517.  
  518.   Version 1.02  3/23/90
  519.   Corrected error in 4ZIP and 4UNZIP - not properly recognizing
  520.   include lists.
  521.  
  522.   Version 1.03  4/01/90
  523.   Changed file access to run on networks reliably.
  524.   Added name and serial number on registered copies.
  525.  
  526.   Version 1.04  6/10/90
  527.   Modified to correct for 4DOS 3.0 quirk. Entries in DESCRIPT.ION
  528.   are sometimes delimited by LF instead of CRLF.  Earlier versions of
  529.   4ZIP/4UNZIP misread these lines.
  530.   Corrected 4ZIP/4UNZIP to properly access ZIPfiles smaller than
  531.   150 bytes.
  532.  
  533.   Version 1.05  7/15/90
  534.   Corrected error that caused -a option of 4UNZIP to lose
  535.   descriptions.
  536.  
  537.  
  538.  
  539.  
  540.  
  541.                                   7
  542.  
  543.   Version 1.06 8/03/90
  544.   Added Error Messages for Drive unready and Disk write-protected.
  545.   4ZIP JUNK a: is now equivalent to 4ZIP JUNK a:*.*
  546.  
  547.   Version 1.07 9/16/90
  548.   4UNZIP choked on the long ZipFile comments now being added by some
  549.   BBS operators. Modified to correct this.
  550.  
  551.  
  552.   Version 1.08 10/18/90
  553.   4UNZIP occasionally dropped file descriptions if the file had an 8 character
  554.   name and a 3 character extension. This is corrected. A problem with include
  555.   lists that caused the same file to be selected more than once has been
  556.   corrected for both programs. For example, 4ZIP test *.txt+4*.txt would show
  557.   the file 4zip.txt twice.
  558.  
  559.   Version 1.09  6/22/91
  560.   4ZIP would prevent PKZIP from updating an existing ZIPFile if the DOS SHARE
  561.   program was loaded.  This is corrected.
  562.  
  563.   Version 2.0  10/13/91
  564.   This is an extensive revision, including Help key, mouse compatibility,
  565.   Passthrough of PKZIP and PKUNZIP options, sorting of the display in
  566.   4ZIP, and International dates and time.
  567.  
  568.   Version 2.01  12/14/91
  569.  
  570.   Both 4ZIP and 4UNZIP set the display blinking attribute off and did not
  571.   restore it.  This is now fixed.
  572.  
  573.   4UNZIP occasionally lost descriptions existing in a directory.  Also fixed.
  574.  
  575.  
  576.  
  577.  
  578.        G. 4EDIT
  579.  
  580.                 In 1988, I wrote and distributed a shareware program, XDIR,
  581.         which was one of the first DOS directory programs to attach a comment
  582.         to each file.  When I first saw 4DOS, I loved it, but  I wanted to
  583.         have the same sort of full-screen editor for directory comments (or,
  584.         in 4DOS terms, Descriptions) that I had in XDIR.
  585.  
  586.                 4EDIT provides this feature.  I think you will find it very
  587.         useful.  Its good practice to comment your files, and often it is
  588.         handy to see the descriptions attached to other files, while you  are
  589.         writing a new one.
  590.  
  591.              The 4EDIT package is shareware, available on Bulletin
  592.         Boards, CompuServe, and from shareware distributors.
  593.         Registration is $15.  See the order form at the end of this manual.
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.                                   8
  601.  
  602.  
  603.                  SOFTWARE REGISTRATION FORM AND ORDER
  604.  
  605.  
  606.  
  607. Check all that apply:
  608.  
  609.    [ ] 4ZIP/4UNZIP registration           _____ @ $15.00
  610.  
  611.    [ ] 4EDIT registration                 _____ @ $15.00
  612.  
  613.  
  614.         Postage and Handling      $3.00
  615.  
  616.                TOTAL ENCLOSED:    $______
  617.  
  618.  
  619. If you already have copies of the programs you are ordering ,
  620. where were they obtained?
  621.  
  622.     [ ]CompuServe [ ]Friend [ ]Employer [ ]BBS ______________________
  623.  
  624.     [ ]ShareWare Distributor________________________________________
  625.  
  626.  
  627. Payment is by check [ ] or money order [ ] (Sorry - no COD or
  628. charges)
  629.  
  630. Foreign Customers - Use $US check drawn on US Bank or Postal Money
  631. Order.
  632.  
  633.  
  634.         NAME    ___________________________________________
  635.  
  636.         COMPANY ___________________________________________
  637.  
  638.         ADDRESS ___________________________________________
  639.  
  640.         CITY    ___________________________________________
  641.  
  642.         STATE   __________________________ZIP _____________
  643.  
  644.  
  645.         Send your registration form and payment to:
  646.  
  647.                        XD Systems
  648.                        1014 Shipman Lane
  649.                        McLean, VA 22101
  650.  
  651.  
  652.  
  653.