home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / 2ZIP25.ZIP / 2ZIP.TXT < prev    next >
Encoding:
Text File  |  1989-12-08  |  17.4 KB  |  485 lines
  1.  
  2.  
  3.  
  4. 2ZIP: .ARC/.LZH/.PAK/.ZOO to .ZIP Conversion Utility        Version 2.5\89.12.08
  5.  
  6.  
  7.  
  8.         1. Your Documentation is TOO LONG!  Gimme a Quick Start!!!
  9.         1. Your Documentation is TOO LONG!  Gimme a Quick Start!!!
  10.  
  11.              Ok, ok...  All you _really_ need to do to use 2ZIP is to copy the
  12.              2ZIP.EXE file into one of the directories in your DOS path (or in
  13.              the directory that contains your archives), and go to Section 8 to
  14.              see how to use it.  If you encounter a problem, please read the
  15.              rest of the documentation and (if that doesn't work) give me a
  16.              call.
  17.  
  18.         2. 2ZIP What does it do?
  19.         2. 2ZIP What does it do?
  20.  
  21.              2ZIP allows you to convert files archived in several other
  22.              compression methods to the new PKZIP format.  Formats currently
  23.              supported are ARC, PAK, DWC, LHARC, and ZOO.
  24.  
  25.         3. 2ZIP Disclaimer
  26.         3. 2ZIP Disclaimer
  27.  
  28.              2ZIP is provided "as-is".  I make no claim that it is suitable for
  29.              any particular purpose.  It may, in fact, not work at all.  I've
  30.              had some pretty good luck with it, but you might not.
  31.  
  32.              2ZIP is written in Microsoft C 5.1 (and developed using Quick C
  33.              2.0).  I've tried to limit my usage of special MS-DOS tricks (like
  34.              version-dependent features, etc.) to ensure that this version of
  35.              2ZIP will work on all MS-DOS compatible computers (Version 3.1 and
  36.              above).
  37.  
  38.         4. 2ZIP Credits
  39.         4. 2ZIP Credits
  40.  
  41.              Many and big thanks to the folks who helped me test 2ZIP.  Among
  42.              them:  Paul Waldinger @ Sound of Music PCBoard, Phil Brushaber @
  43.              The Ad Game BBS, John Souvestre, and Mark Stein @ The Laguna Hills
  44.              BBS.  Many thanks to these folks.
  45.  
  46.         5. 2ZIP Payment
  47.         5. 2ZIP Payment
  48.  
  49.              2ZIP is free for non-commercial use.  If you're a private citizen
  50.              and you've downloaded 2ZIP, enjoy!  I've written this program for
  51.              you.  It should make your archive conversion as painless as
  52.              possible.
  53.  
  54.              For commercial use, though, (or use in a business setting) I
  55.              require a small fee of $10/site, or $100 for unlimited usage within
  56.              your organization for 2ZIP.  Contact me at the address or phone
  57.              number listed at the bottom of this document for more information.
  58.  
  59.              For non-commerical users, I'm offering this program as a service to
  60.              promote what I believe is a superior compression program
  61.              (PKZIP/PKUNZIP).  I would certainly appreciate your comments on
  62.              2ZIP, and I would probably be willing to add an enhancement or two
  63.              if it's needed, (and if you say I'm a nice guy for doing it).
  64.  
  65.  
  66. 2ZIP: .ARC/.LZH/.PAK/.ZOO to .ZIP Conversion Utility        Version 2.5\89.12.08
  67.  
  68.  
  69.  
  70.              In any case, drop me a line!  I try to return all mail (I've really
  71.              gotten a kick out of previous letters!).
  72.  
  73.              If you've got tons and tons of money, I would recommend registering
  74.              the shareware programs you use, like PKZIP/PKUNZIP, DSZ, GT Power,
  75.              4DOS, AGT, Qmodem, LIST, Etc.  THESE authors depend on your
  76.              support, I don't.
  77.  
  78.         6. 2ZIP Minimum Requirements
  79.         6. 2ZIP Minimum Requirements
  80.  
  81.              MS/PC DOS 3.1 or higher
  82.              256k of AVAILABLE RAM (2ZIP might work with less:  I make no
  83.              guarantees)
  84.              Enough disk space to hold two copies of the archive being
  85.              processed, and all of the files it contains.
  86.  
  87.              NOTE:
  88.  
  89.              Versions of 2ZIP prior to 2.0 may create incomplete ZIP files if
  90.              sufficient disk space is not available.  2ZIP v2.0 and later will
  91.              detect disk space problems and will not remove any archives that
  92.              can't be fully processed.  Any failed conversion will appear in the
  93.              2ZIP_BAD.LOG file, explained in depth below.
  94.  
  95.              Son of NOTE:
  96.  
  97.              Make sure you have a relatively large FILES= setting in your
  98.              CONFIG.SYS file.  FILES=20 is probably good enough.  Archive -> ZIP
  99.              convertors can take a lot of file handles because they create child
  100.              processes.
  101.  
  102.         7. 2ZIP Installation
  103.         7. 2ZIP Installation
  104.  
  105.              First, you must have a copy of each de-compression program you are
  106.              currently using on your system in one of your DOS search
  107.              directories.  This is probably already the case, but if you want to
  108.              be extra sure 2ZIP will work in all cases (at least all cases it
  109.              was designed for), copy PKUNPAK.EXE (v3.61), PAK.EXE (v2.01),
  110.              ZOO.EXE (v2.01), DWC (v5.01), LHARC 1.13, and PKZIP.EXE (1.02) in
  111.              your DOS search directory.  I'm using my \UTIL directory for this
  112.              purpose, but you could use any valid directory.
  113.  
  114.              NOTE:  If you are converting DWC archives, you MUST use DWC version
  115.              5.0 or greater!
  116.  
  117.              If you currently use PKXARC (or some other unarchiving program),
  118.              you must rename or copy it to PKUNPAK.EXE for 2ZIP to work
  119.              correctly.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                          - 2 -
  127.  
  128.  
  129. 2ZIP: .ARC/.LZH/.PAK/.ZOO to .ZIP Conversion Utility        Version 2.5\89.12.08
  130.  
  131.  
  132.  
  133.              Next, you should set up a WORK/LOG directory using the 2ZIP
  134.              environment variable.  Place a line in your AUTOEXEC.BAT file which
  135.              reads (for example):
  136.  
  137.                             SET 2ZIP=C:\UTIL
  138.  
  139.              (or whatever you want your WORK/LOG directory to be).  This
  140.              directory _must_ exist.  If it doesn't, 2ZIP won't work correctly.
  141.  
  142.              If you do not specify a 2ZIP work directory (and I recommend that
  143.              you do), 2ZIP will create a directory called "$KMS" in the current
  144.              directory and do all of it's stuff from there.  This directory is
  145.              removed after 2ZIP finishes.
  146.  
  147.              You may also want to set up a default compression variable using
  148.              the 2ZIP_C environment variable.  Compression defaults to "-ex" you
  149.              may wish to change it to some other setting, for instance.  To do
  150.              this, include a line in your AUTOEXEC.BAT file which might read:
  151.  
  152.                             SET 2ZIP_C=-eb4 -ea2
  153.  
  154.              Make sure not to enter blanks before or after the '=' sign (i.e.
  155.              SET 2ZIP_C = -eb4 is NOT correct).  If you don't know what this
  156.              means, don't worry--2ZIP will work just fine if you don't set this
  157.              variable.
  158.  
  159.         8. 2ZIP Usage
  160.         8. 2ZIP Usage
  161.  
  162.              2ZIP is fairly easy to use (once you've performed the above
  163.              installation steps).  To convert a single archive to the ZIP format
  164.              you would type:
  165.  
  166.                             2ZIP file.arc
  167.                             2ZIP TEST.ARC  (to convert TEST.ARC to TEST.ZIP)
  168.  
  169.              Wildcards are allowed, so to convert all .ARCs to ZIP format:
  170.  
  171.                             2ZIP *.ARC
  172.  
  173.              And multiple command-line files are allowed, so to convert all ARC
  174.              files, all PAK files, and FOO.ZOO you would type:
  175.  
  176.                             2ZIP *.ARC *.PAK FOO.ZOO
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.                                          - 3 -
  189.  
  190.  
  191. 2ZIP: .ARC/.LZH/.PAK/.ZOO to .ZIP Conversion Utility        Version 2.5\89.12.08
  192.  
  193.  
  194.  
  195.              Pretty straightforward, huh?  While 2ZIP is processing you'll see
  196.              something like this:
  197.  
  198.  
  199.  
  200.              2ZIP Many Archive to .ZIP conversion utility!   Version 2.5
  201.              Copyright (c) 1989, Kelly Stanonik      All Rights Reserved.
  202.  
  203.              TEST1.ARC  Un-archiving. ZIPing.  Setting Date and Time.  Done.
  204.              TEST3.ARC  Un-archiving. ZIPing.  Setting Date and Time.  Done.
  205.              TEST5.PAK  Un-PAKing.    ZIPing.  Setting Date and Time.  Done.
  206.              TEST6.ZOO  Un-ZOOing.    ZIPing.  Setting Date and Time.  Done.
  207.              BOB.LZH    Un-LHARCing.  ZIPing.  Setting Date and Time.  Done.
  208.  
  209.              Finished!    5 files converted.
  210.  
  211.  
  212.  
  213.              Note that 2ZIP sets the date and time of the resulting .ZIP file to
  214.              the original date and time of the .ARC, .PAK, .MD, .DWC, .LZH or
  215.              .ZOO file.  This should make you sysops out there happy.
  216.  
  217.              2ZIP automatically selects PKZIP's highest compression ratio for
  218.              both ASCII and Binary files unless it is overridden with the 2ZIP_C
  219.              environment variable.  This can result in a longer compression
  220.              time, but decompression will be faster and file sizes will be
  221.              smaller.
  222.  
  223.         9. 2ZIP Batch File Usage
  224.         9. 2ZIP Batch File Usage
  225.  
  226.              2ZIP can be used quite easily from a batch file.  In addition to
  227.              the fact that the output from 2ZIP can be redirected using the
  228.              standard DOS ">" redirection symbol, it will also return a DOS
  229.              error level if a fatal error occurs.
  230.  
  231.              If you specify the -b switch (described below), 2ZIP will set the
  232.              DOS error level if any conversion fails.  Otherwise, 2ZIP will only
  233.              return an error level with fatal errors.
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.                                          - 4 -
  251.  
  252.  
  253. 2ZIP: .ARC/.LZH/.PAK/.ZOO to .ZIP Conversion Utility        Version 2.5\89.12.08
  254.  
  255.  
  256.  
  257.         10. 2ZIP Switches
  258.         10. 2ZIP Switches
  259.  
  260.              2ZIP supports the following switches (case IS significant).
  261.              Switches can be placed anywhere on the command line (i.e. 2ZIP -l
  262.              *.* _or_ 2ZIP *.* -l):
  263.  
  264.  
  265.  
  266.              -b
  267.  
  268.              Batch file support.  This switch causes 2ZIP to set the DOS
  269.              errorlevel to 1 if any conversion specified fails.  For instance,
  270.              take the following batch file:
  271.  
  272.              2ZIP -b %1
  273.              IF ERRORLEVEL 1 GOTO ITWASBAD
  274.              GOTO ITWASOKAY
  275.              :ITWASBAD
  276.              ECHO You Lose!
  277.              GOTO END
  278.              :ITWASOKAY
  279.              ECHO Alright!
  280.              :END
  281.  
  282.              If the -b parameter is not specified, 2ZIP will only return an
  283.              errorlevel if it encounters a fatal error (like not being able to
  284.              create the temporary directory).
  285.  
  286.              -l
  287.  
  288.              Full logging enabled.  This switch causes 2ZIP to place a log entry
  289.              in the 2ZIP.LOG file (located in the directory pointed to by the
  290.              2ZIP environment variable) for each file it processes.  Note that
  291.              the 2ZIP_BAD.LOG file will still be maintained regardless of the
  292.              status of the -l switch.
  293.  
  294.  
  295.  
  296.              -z
  297.  
  298.              Causes the contents of the COMMENT.TXT file (COMMENT.ZIP was used
  299.              in version 2.3, but I realized that this was a pretty dumb thing to
  300.              call a text file so I renamed it to .TXT.  If you used comment
  301.              support in version 2.3 of 2ZIP, rename COMMENT.ZIP to COMMENT.TXT).
  302.              This file should be located in the directory pointed to by the 2ZIP
  303.              environment variable to be used as a ZIP comment for each file that
  304.              2ZIP processes.  If you haven't set the 2ZIP environment variable
  305.              this file should be in the current directory.
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.                                          - 5 -
  313.  
  314.  
  315. 2ZIP: .ARC/.LZH/.PAK/.ZOO to .ZIP Conversion Utility        Version 2.5\89.12.08
  316.  
  317.  
  318.  
  319.              For instance, if you place the following line in your COMMENT.ZIP
  320.              file:
  321.  
  322.              * A product of the KMS BBS! *
  323.  
  324.              and 2ZIP a bunch of files (2ZIP C:\UPLOAD\*.* -z) with the zip
  325.              comment switch, 2ZIP will place "* A product of the KMS BBS! *" in
  326.              each file processed.
  327.  
  328.              If you try to use the -z switch, and the COMMENT.TXT file doesn't
  329.              exist, 2ZIP will abort with a fatal error.
  330.  
  331.         11. 2ZIP Error Log
  332.         11. 2ZIP Error Log
  333.  
  334.              If, for some reason, 2ZIP is unable to create a .ZIP file, the word
  335.              "Error." will replace "Done." in 2ZIP's output, and a line will be
  336.              added to the 2ZIP_BAD.LOG file (located in whatever directory you
  337.              set the 2ZIP environment variable).
  338.  
  339.              This log file contains the name of the original file and the target
  340.              .ZIP file, and the date and time of the attempt.
  341.  
  342.              2ZIP uses a special directory notation which allows it to specify
  343.              when an error occurred in an archive within another archive.  If
  344.              2ZIP encountered an error in an archive within an archive, the log
  345.              entry might look like this:
  346.  
  347.              C:\UP\(THISARC.ARC)\FRED.ARC       failed  Sun Mar 05 00:21:37
  348.  
  349.              This means that in the C:\UP directory, there is a file called
  350.              THISARC.ARC.  _Within_ THISARC.ARC there is an archive called
  351.              FRED.ARC which 2ZIP had some trouble processing.
  352.  
  353.              2ZIP does not delete the original file if an error occurs.
  354.  
  355.         12. 2ZIP Bugs & Comments
  356.         12. 2ZIP Bugs & Comments
  357.  
  358.              Kelly Stanonik (KMS)                    Bix:     kms
  359.              4469 Ventura Canyon Ave. #E107   CompuServe:     74730,77
  360.              Sherman Oaks, CA  91423
  361.  
  362.              Home:           (818) 783-8013
  363.              Work:           (213) 826-1000 x.412
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.                                          - 6 -
  376.  
  377.  
  378. 2ZIP: .ARC/.LZH/.PAK/.ZOO to .ZIP Conversion Utility        Version 2.5\89.12.08
  379.  
  380.  
  381.  
  382.         13. 2ZIP Versions
  383.         13. 2ZIP Versions
  384.  
  385.              What program would be complete without a list of versions?  A new
  386.              one perhaps?  Well--I'd imagine so.  2ZIP is pretty new, but I've
  387.              already got a couple.
  388.  
  389.              Version 1.1
  390.  
  391.              This was the first release version of 2ZIP.
  392.  
  393.              Version 1.2
  394.  
  395.              2ZIP now converts .ARC files located within archives.  Sorry, but
  396.              1.2 only converts one level deep (if you 2ZIP FRED.ARC, and
  397.              FRED.ARC contains BOB.ARC and SALLY.ARC, these files will be Zipped
  398.              too.  If BOB.ARC contains SAMMY.ARC, though, SAMMY.ARC will remain
  399.              SAMMY.ARC).
  400.  
  401.              I guess my personal opinion is that if someone puts eight levels of
  402.              archives within an archive they deserve to convert it themselves.
  403.              My mind may be changed if folks think multiple level archive
  404.              conversion would be useful.
  405.  
  406.              Version 1.3
  407.  
  408.              2ZIP now recognizes the 2ZIP_C environment variable to specify the
  409.              default PKZIP compression.  If this variable doesn't exist, 2ZIP
  410.              defaults to "-eb4 -ea4" otherwise, YOU be the judge.  A sample
  411.              setting might be
  412.  
  413.              SET 2ZIP_C=-eb4
  414.  
  415.              I've had pretty good luck with this, in fact.  (This turns on full-
  416.              reducing compression for binary files, and uses shrinking
  417.              exclusively for ASCII files)
  418.  
  419.              Version 2.0
  420.  
  421.              This version turned out to be mainly a big beta test.
  422.  
  423.              Version 2.1 (!)
  424.  
  425.              This is a pretty hefty revision (hence the major number increase).
  426.              2ZIP has been ported to Microsoft C 5.1 from Microsoft QuickBASIC.
  427.              Error checking has been beefed up, two switches (-l and -z) have
  428.              been added, and the log file format has been expanded and enhanced.
  429.  
  430.              Version 2.3
  431.  
  432.              The -b paramter was added, along with DWC archive support.  In
  433.              addition, 2ZIP was optimized a little, and some problems with
  434.              386^max were corrected.
  435.  
  436.  
  437.                                          - 7 -
  438.  
  439.  
  440. 2ZIP: .ARC/.LZH/.PAK/.ZOO to .ZIP Conversion Utility        Version 2.5\89.12.08
  441.  
  442.  
  443.  
  444.              If you're using version 0.92 of PKZIP, you'll probably want to set
  445.              the 2ZIP_C environment variable to -ex for maximum PKZIP
  446.              compression.
  447.  
  448.              Version 2.5
  449.  
  450.              This is the LHARC release (yeah, pretty late huh?).  My main
  451.              problem with LHARC is that it likes to write not only to standard
  452.              output, but also to standard error.  It's actually pretty easy to
  453.              redirect standard error, but if it weren't for 2ZIP I would
  454.              probably never have had to do it.
  455.  
  456.              Also with this version I've dropped MDCD support.  It appears to be
  457.              a dead compression format, and I don't see a good reason to clutter
  458.              2ZIP with support for it.
  459.  
  460.              COMMENT.TXT is now used for a ZIP comment holder instead of
  461.              COMMENT.ZIP for clarity's sake.
  462.  
  463.              Just a reminder:  The current version of PKZIP is 1.02 -- if you
  464.              don't have it you should get it!  It's a lot better than 0.?? (!)
  465.  
  466.              The next (3.0 -- I'm working on it) release of 2ZIP will include
  467.              some dandy new features which YOU'VE requested.  Keep requesting
  468.              them.  My goal is to make your archive conversions painless.
  469.  
  470.              - Kelly
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.                                          - 8 -