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