home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / 2ZIP21.ZIP / 2ZIP.TXT < prev    next >
Encoding:
Text File  |  1989-03-09  |  12.0 KB  |  331 lines
  1.  
  2. 2ZIP: .ARC/.MD/.PAK/.ZOO to .ZIP Conversion Utility         Version 2.1\89.03.09
  3.  
  4.  1. 2ZIP What does it do?
  5.  
  6.       2ZIP allows you to convert files archived in several other compression
  7.       methods to the new PKZIP format.
  8.  
  9.  2. 2ZIP Disclaimer
  10.  
  11.       2ZIP is provided "as-is".  I make no claim that it is suitable for any
  12.       particular purpose.  It may, in fact, not work at all.  I've had some
  13.       pretty good luck with it, but you might not.
  14.  
  15.       2ZIP is written in Microsoft C 5.1.  It doesn't use any special
  16.       interrupts or MS-DOS features to perform the task at hand.  The source
  17.       code for 2ZIP is available for a fee (and a non-disclosure agreement must
  18.       be signed).
  19.  
  20.  3. 2ZIP Credits
  21.  
  22.       2ZIP 2.1 was written in Microsoft C 5.1.
  23.  
  24.       2ZIP was inspired in some small way by a program called ZIPPER.  ZIPPER
  25.       does basically what 2ZIP does, but only for .ARC and .PAK files.  ZIPPER
  26.       would also like you to pay a shareware fee.
  27.  
  28.       2ZIP payment is a little different.  See the "2ZIP payment" section of
  29.       this document (coming right up).
  30.  
  31.       If you've used ZIPPER, you may also think it is annoying (whistling
  32.       windows, etc.).  As Chuck Forsberg likes to say, "...if you're looking
  33.       for a modem video game, Pro-YAM is not for you..."  Likewise, if you're
  34.       looking for a PKZIP conversion video game you should probably look
  35.       elsewhere.
  36.  
  37.       This is NOT meant to imply that I have anything against the person (or
  38.       persons) who wrote ZIPPER.  I simply dislike their program.
  39.  
  40.       Many and big thanks to the folks who helped me test 2ZIP.  Among them:
  41.       Paul Waldinger @ Sound of Music PCBoard, Phil Brushaber @ The Ad Game
  42.       BBS, John Souvestre, and Mark Stein @ The Laguna Hills BBS.  Many thanks
  43.       to these folks.
  44.  
  45.  4. 2ZIP Payment
  46.  
  47.       2ZIP is free.  I'm offering it as a service to promote what I believe is
  48.       a superior compression program (PKZIP/PKUNZIP).  I would certainly
  49.       appreciate your comments on 2ZIP, and I would probably be willing to add
  50.       an enhancement or two if it's needed, (and if you say I'm a nice guy for
  51.       doing it).
  52.  
  53.       If you use 2ZIP a lot and really feel like you owe me cash, send a
  54.       donation to my address in the $2 to $5 range.  Please do not send more
  55.       than five dollars in any event.  Any money collected will be used to
  56.       expand my toolbox for other public enhancement utilities like 2ZIP.
  57.  
  58.       If you've got tons and tons of money, I would recommend registering the
  59.       shareware programs you use, like PKZIP/PKUNZIP, DSZ, GT Power, Etc.
  60.       THESE authors depend on your support, I don't.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. 2ZIP: .ARC/.MD/.PAK/.ZOO to .ZIP Conversion Utility         Version 2.1\89.03.09
  69.  
  70.  5. 2ZIP Minimum Requirements
  71.  
  72.       MS/PC DOS 3.1 or higher
  73.       512k RAM (2ZIP might work with less:  I make no guarantees)
  74.       Enough disk space to hold two copies of the archive being processed, and
  75.       all of the files it contains.
  76.  
  77.       NOTE:
  78.  
  79.       Versions of 2ZIP prior to 2.0 may create incomplete ZIP files if
  80.       sufficient disk space is not available.  2ZIP v2.0 will detect disk space
  81.       problems and will not remove any archives that can't be fully processed.
  82.       Any failed conversion will appear in the 2ZIP_BAD.LOG file, explained in
  83.       depth below.
  84.  
  85.       Son of NOTE:
  86.  
  87.       Make sure you have a relatively large FILES= setting in your CONFIG.SYS
  88.       file.  FILES=20 is probably good enough.  Archive -> ZIP convertors can
  89.       take a lot of file handles because they create child processes.
  90.  
  91.  6. 2ZIP Installation
  92.  
  93.       First, you must have a copy of each de-compression program you are
  94.       currently using on your system in one of your DOS search directories.
  95.       This is probably already the case, but if you want to be extra sure 2ZIP
  96.       will work in all cases (at least all cases it was designed for), copy
  97.       PKUNPAK.EXE (v3.61), PAK.EXE (v1.60), ZOO.EXE (v1.41), MDCD.EXE and
  98.       PKZIP.EXE (Current version) in your DOS search directory.  I'm using my
  99.       \UTIL directory for this purpose.
  100.  
  101.       If you currently use PKXARC (or some other unarchiving program), you must
  102.       rename or copy it to PKUNPAK.EXE for 2ZIP to work correctly.
  103.  
  104.       Next, you should set up a WORK/LOG directory using the 2ZIP environment
  105.       variable.  Place a line in your AUTOEXEC.BAT file which reads
  106.  
  107.                      SET 2ZIP=C:\UTIL
  108.  
  109.       (or whatever you want your WORK/LOG directory to be).  This directory
  110.       _must_ exist.  If it doesn't, 2ZIP won't work correctly.
  111.  
  112.       A subdirectory will be created under this WORK/LOG directory called
  113.       TMP$KMS, so it is perfectly O.K. to have other files in this directory.
  114.       The TMP$KMS subdirectory will be removed after each 2ZIP session.
  115.  
  116.       You may also want to set up a default compression variable using the
  117.       2ZIP_C environment variable.  Compression defaults to "-eb4 -ea4" you may
  118.       wish to change it to -eb4 -ea2, for instance.  To do this, include a line
  119.       in your AUTOEXEC.BAT file which reads:
  120.  
  121.                      SET 2ZIP_C=-eb4 -ea2
  122.  
  123.       Make sure not to enter blanks before or after the '=' sign (i.e. SET
  124.       2ZIP_C = -eb4 is NOT correct).  If you don't know what this means, don't
  125.       worry--2ZIP will work just fine if you don't set this variable.
  126.  
  127.  
  128.  
  129.  
  130.                                      - 2 -
  131.  
  132.  
  133.  
  134. 2ZIP: .ARC/.MD/.PAK/.ZOO to .ZIP Conversion Utility         Version 2.1\89.03.09
  135.  
  136.  7. 2ZIP Usage
  137.  
  138.       2ZIP is fairly easy to use (once you've performed the above installation
  139.       steps).  To convert a single archive to the ZIP format you would type:
  140.  
  141.                      2ZIP file.arc
  142.                      2ZIP TEST.ARC       (to convert TEST.ARC to TEST.ZIP)
  143.  
  144.       Wildcards are allowed, so to convert all .ARCs to ZIP format:
  145.  
  146.                      2ZIP *.ARC
  147.  
  148.       And multiple command-line files are allowed, so to convert all archives,
  149.       all PAK files, and FOO.ZOO you would type:
  150.  
  151.                      2ZIP *.ARC *.PAK FOO.ZOO
  152.  
  153.       Pretty straightforward, huh?  While 2ZIP is processing you'll see
  154.       something like this:
  155.  
  156.       
  157.  
  158.       2ZIP    .ARC/.MD/.PAK/.ZOO to .ZIP conversion utility!   Version 2.1
  159.       Copyright (c) 1989, Kelly Stanonik                   All Rights Reserved.
  160.       
  161.       TEST1.ARC      Un-archiving.  ZIPing.  Setting Date and Time.  Done.
  162.       TEST3.ARC      Un-archiving.  ZIPing.  Setting Date and Time.  Done.
  163.       TEST5.PAK      Un-PAKing.     ZIPing.  Setting Date and Time.  Done.
  164.       TEST6.ZOO      Un-ZOOing.     ZIPing.  Setting Date and Time.  Done.
  165.       LZ.MD          Un-MDCDing.    ZIPing.  Setting Date and Time.  Done.
  166.       TEST7.MD       Un-MDCDing.    ZIPing.  Setting Date and Time.  Done.
  167.       
  168.       Finished!    6 files converted.
  169.  
  170.       
  171.  
  172.       Note that 2ZIP sets the date and time of the resulting .ZIP file to the
  173.       original date and time of the .ARC, .PAK, .MD, or .ZOO file.  This should
  174.       make you sysops out there happy.
  175.  
  176.       2ZIP automatically selects PKZIP's highest compression ratio for both
  177.       ASCII and Binary files unless it is overridden with the 2ZIP_C
  178.       environment variable.  This can result in a longer compression time, but
  179.       decompression will be faster and file sizes will be smaller.
  180.  
  181.  8. 2ZIP Batch File Usage
  182.  
  183.       2ZIP can be used quite easily from a batch file.  In addition to the fact
  184.       that the output from 2ZIP can be redirected using the standard DOS ">"
  185.       redirection symbol, it will also return a DOS error level if a fatal
  186.       error occurs.
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                      - 3 -
  197.  
  198.  
  199.  
  200. 2ZIP: .ARC/.MD/.PAK/.ZOO to .ZIP Conversion Utility         Version 2.1\89.03.09
  201.  
  202.  9. 2ZIP Switches
  203.  
  204.       2ZIP supports the following switches (case IS significant).  Switches can
  205.       be placed anywhere on the command line (i.e. 2ZIP -l *.* _or_ 2ZIP *.* -
  206.       l):
  207.  
  208.       
  209.  
  210.       -l
  211.  
  212.       Full logging enabled.  This switch causes 2ZIP to place a log entry in
  213.       the 2ZIP.LOG file (located in the directory pointed to by the 2ZIP
  214.       environment variable) for each file it processes.  Note that the
  215.       2ZIP_BAD.LOG file will still be maintained regardless of the status of
  216.       the -l switch.
  217.  
  218.       
  219.  
  220.       -z
  221.  
  222.       Causes the contents of the COMMENT.ZIP file (located in the directory
  223.       pointed to by the 2ZIP environment variable) to be used as a ZIP comment
  224.       for each file that 2ZIP processes.  For instance, if you place the
  225.       following line in your COMMENT.ZIP file:
  226.  
  227.       * A product of the KMS BBS! *
  228.  
  229.       and 2ZIP a bunch of files (2ZIP C:\UPLOAD\*.* -z) with the zip comment
  230.       switch, 2ZIP will place "* A product of the KMS BBS! *" in each file
  231.       processed.
  232.  
  233.       If you try to use the -z switch, and the COMMENT.ZIP file doesn't exist,
  234.       2ZIP will abort with a fatal error.
  235.  
  236.  10. 2ZIP Error Log
  237.  
  238.       If, for some reason, 2ZIP is unable to create a .ZIP file, the word
  239.       "Error." will replace "Done." in 2ZIP's output, and a line will be added
  240.       to the 2ZIP_BAD.LOG file (located in whatever directory you set the 2ZIP
  241.       environment variable).
  242.  
  243.       This log file contains the name of the original file and the target .ZIP
  244.       file, and the date and time of the attempt.
  245.  
  246.       2ZIP uses a special directory notation which allows it to specify when an
  247.       error occurred in an archive within another archive.  If 2ZIP encountered
  248.       an error in an archive within an archive, the log entry might look like
  249.       this:
  250.  
  251.       C:\UP\(THISARC.ARC)\FRED.ARC       failed  Sun Mar 05 00:21:37
  252.  
  253.       This means that in the C:\UP directory, there is a file called
  254.       THISARC.ARC.  _Within_ THISARC.ARC there is an archive called FRED.ARC
  255.       which 2ZIP had some trouble processing.
  256.  
  257.       2ZIP does not delete the original file if an error occurs.
  258.  
  259.  
  260.  
  261.  
  262.                                      - 4 -
  263.  
  264.  
  265.  
  266. 2ZIP: .ARC/.MD/.PAK/.ZOO to .ZIP Conversion Utility         Version 2.1\89.03.09
  267.  
  268.  11. 2ZIP Bugs & Comments
  269.  
  270.       Kelly Stanonik (KMS)                    Bix:            kms
  271.       15737 Bluffside Ct. #155                CompuServe:     74730,77
  272.       Chino Hills, CA  91709                  Home:           (714) 597 5666
  273.  
  274.  12. 2ZIP Versions
  275.  
  276.       What program would be complete without a list of versions?  A new one
  277.       perhaps?  Well--I'd imagine so.  2ZIP is pretty new, but I've already got
  278.       a couple.
  279.  
  280.       Version 1.1
  281.  
  282.       This was the first release version of 2ZIP.
  283.  
  284.       Version 1.2
  285.  
  286.       2ZIP now converts .ARC files located within archives.  Sorry, but 1.2
  287.       only converts one level deep (if you 2ZIP FRED.ARC, and FRED.ARC contains
  288.       BOB.ARC and SALLY.ARC, these files will be Zipped too.  If BOB.ARC
  289.       contains SAMMY.ARC, though, SAMMY.ARC will remain SAMMY.ARC).
  290.  
  291.       I guess my personal opinion is that if someone puts eight levels of
  292.       archives within an archive they deserve to convert it themselves.  My
  293.       mind may be changed if folks think multiple level archive conversion
  294.       would be useful.
  295.  
  296.       Version 1.3
  297.  
  298.       2ZIP now recognizes the 2ZIP_C environment variable to specify the
  299.       default PKZIP compression.  If this variable doesn't exist, 2ZIP defaults
  300.       to "-eb4 -ea4" otherwise, YOU be the judge.  A sample setting might be
  301.  
  302.       SET 2ZIP_C=-eb4
  303.  
  304.       I've had pretty good luck with this, in fact.  (This turns on full-
  305.       reducing compression for binary files, and uses shrinking exclusively for
  306.       ASCII files)
  307.  
  308.       Version 2.0
  309.  
  310.       This version turned out to be mainly a big beta test.
  311.  
  312.       Version 2.1 (!)
  313.  
  314.       This is a pretty hefty revision (hence the major number increase).  2ZIP
  315.       has been ported to Microsoft C 5.1 from Microsoft QuickBASIC.  Error
  316.       checking has been beefed up, two switches (-l and -z) have been added,
  317.       and the log file format has been expanded and enhanced.
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                      - 5 -
  329.  
  330.  
  331.