home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / PKCNVT11.ZIP / PKCNVT.DOC < prev    next >
Encoding:
Text File  |  1990-02-12  |  5.7 KB  |  159 lines
  1.  
  2. Preamble:
  3.  
  4.     There are many Amiga BBS's or BBS's with Amiga files on them
  5.     that are run on MS-DOS hosts.  Moreover, many of these system
  6.     have files in "ay-are-cee", ZOO, or LZH format.  Now that
  7.     PKAZIP for the Amiga is available, it would be beneficial to
  8.     convert these files to the more reliable and efficient .ZIP
  9.     file format used by PKZIP.
  10.  
  11.     However, because many of these Amiga archives contain
  12.     filenames that are illegal under MS-DOS, conversion of these
  13.     files to .ZIP format on an MS-DOS host has not been possible
  14.     until now.
  15.  
  16.     While these programs will also convert native MS-DOS
  17.     "ay-are-cee", LZH, and ZOO files, they are mainly designed to
  18.     convert non MS-DOS created archives.
  19.  
  20. Commands:
  21.  
  22.     PKCNVT
  23.     PKCNVZOO
  24.     PKCNVLZH
  25.  
  26. Purpose:
  27.  
  28.     The purpose of these programs are to convert LZH, ZOO and
  29.     "ay-are-cee" files to .ZIP files, even if they contain
  30.     filenames that are illegal under MS-DOS, without losing or
  31.     truncating the original filenames.
  32.  
  33.     The resulting .ZIP files generated by these programs will save
  34.     all information, including the extact filenames in the
  35.     original archives, in the new .ZIP files.  The new .ZIP file
  36.     will also have the same file date/time as the original
  37.     archive.
  38.  
  39.  
  40. How they work:
  41.  
  42.     PKCNVT and PKCNVZOO basically execute a "zoo v" or "pkunpak
  43.     -v" on each file to read the name, date, etc. for each file
  44.     in the archive, and then extract each file to the console,
  45.     after having redirected stdout to a temporary file with a
  46.     legal MS-DOS name.  PKZIP is then run to compress the files
  47.     with the temporary names, after which PKCNVT programs will
  48.     update the .ZIP file with the original filename and
  49.     information.  At no time do PKCNVT or PKCNVZOO ever open or
  50.     read the archive being converted, particularly files of the
  51.     "ay-are-cee" variety.  Due to limitations of the
  52.     LH"ay-are-cee" program, PKCNVLZH does open and read LZH files
  53.     however.
  54.  
  55.  
  56. Usage:
  57.  
  58.   PKCNVZOO [options] filespec[.ext] [filespec[.ext]...]
  59.   PKCNVLZH [options] filespec[.ext] [filespec[.ext]...]
  60.  
  61.     PKCNVZOO, PKCNVLZH converts ZOO or LZH files respectively to
  62.     .ZIP files.  ZOO 2.00 or later, LH"ay-are-cee" 1.13 or later
  63.     and the latest version of PKZIP should be in the current
  64.     directory or PATH when using this program.
  65.  
  66.     Example:
  67.  
  68.       pkcnvzoo *
  69.  
  70.     will convert all the ZOO files in the current directory to
  71.     .ZIP files.
  72.  
  73.       pkncvlzh a* b* dat*
  74.  
  75.     will convert all the A*.LZH, B*.LZH, and DAT*.LZH files in the
  76.     current directory to .ZIP files.
  77.  
  78.   PKCNVT [options] filespec.ext [filespec.ext...]
  79.  
  80.     PKCNVT converts PKPAK compatible files to .ZIP files.
  81.     PKUNPAK 3.6 or 3.61 and the latest version of PKZIP should
  82.     be in the current directory or PATH when using this program.
  83.  
  84.     For reasons that will go unmentioned, PKCNVT, unlike PKCNVZOO
  85.     or PKCNVLZH, does not default to the "ay-are-cee" extension.
  86.     Therefore, you must specify the extension for these files
  87.     with PKCNVT.
  88.  
  89. The options for these programs are:
  90.  
  91.   -d = delete converted files
  92.       This will delete the original, .ZOO, .LZH, or
  93.       ."ay-are-cee" files after they have been successfully
  94.       converted to a .ZIP file.
  95.  
  96.   -l = log errors and continue
  97.           This will cause the convert program to create a log file
  98.       PKCNV.LOG to record any errors encountered, such as an
  99.       archive which failed to extract properly, and continue
  100.       on with the next file.  By default the software will
  101.       prompt you to abort or continue when an error is detected.
  102.  
  103.   -o = overwrite ZIP file if it exists
  104.       If the same name .ZIP file already exists, the software
  105.       by default will prompt you if you want to overwrite or
  106.       rename the new .ZIP file.  Using this option will cause
  107.       the software to automatically overwrite the existing file.
  108.  
  109.  
  110. License:
  111.  
  112.     PKCNVT  Copyright 1990 PKWARE Inc.  All Rights Reserved.
  113.     PKCNVZOO  Copyright 1990 PKWARE Inc.  All Rights Reserved.
  114.     PKCNVLZH  Copyright 1990 PKWARE Inc.  All Rights Reserved.
  115.  
  116.  
  117.     These programs are free.
  118.  
  119.     You are free to use, copy and distribute these programs providing:
  120.  
  121.           No fee is charged for use, copying or distribution.
  122.       They are not modified in any way.
  123.  
  124.     Clubs, user groups, and ShareWare/PD disk vendors may charge a
  125.     nominal fee, not to exceed ($10), for expenses and handling
  126.     while distributing these programs.
  127.  
  128.  
  129.     If you have any questions about PKCNVT, PKCNVZOO, PKCNVLZH or
  130.     want to find out more about other PKWARE products contact:
  131.  
  132.     PKWARE Inc.
  133.     7545 N. Port Washington Rd.
  134.     Suite 205
  135.     Glendale, WI 53217
  136.     414-352-3670 (voice)    414-352-3815 (fax)
  137.  
  138.     or call the PKWARE Support BBS at 414-352-7176, available 24 hours.
  139.  
  140.  
  141. Disclaimer:
  142.  
  143.     PKWARE hereby disclaims all warranties relating to this
  144.     software, whether express or implied, including without
  145.     limitation any implied warranties of merchantability or fitness
  146.     for a particular purpose.  PKWARE will not be liable for any
  147.     special, incidental, consequential, indirect or similar damages
  148.     due to loss of data or any other reason, even if PKWARE or an
  149.     agent of PKWARE has been advised of the possibility of such
  150.     damages.  In no event shall PKWARE's liability for any damages
  151.     ever exceed the price paid for the license to use software,
  152.     regardless of the form of the claim.  The person using the
  153.     software bears all risk as to the quality and performance of the
  154.     software.
  155.  
  156.     This software was written and manufactured with pride in the
  157.                      United States of America.
  158.  
  159.