home *** CD-ROM | disk | FTP | other *** search
/ The People Multimedia CD-Plus / VolumeOne.iso / LHARC / LZHC.TXT < prev    next >
Text File  |  1996-06-02  |  6KB  |  148 lines
  1.  
  2.                              LZHConvert v1.5
  3.               - Converts ARC, PAK, ZIP files to LHARC format -
  4.            Copyright (C)  CollisionWare(tm) Premium SoftWare
  5.                            All Rights Reserved
  6.                          Written by Kito D. Mann
  7. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  8.                          D O C U M E N T A T I O N
  9. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  10.  
  11. The files that should be included in this archive are:
  12.  
  13. LZHC.EXE     -  Executable LHARC Converter Program
  14. LZHC.DAT     -  Configuration file for LZHC.EXE
  15. LZHC.DOC     -  This Documetation
  16. LZHC.NEW     -  On going log of updates to LZHConvert
  17. CWFILES.TXT  -  List of CollisionWare(tm) Premium SoftWare
  18.  
  19. LZHC.EXE is the actual executable file. The format for usage is:
  20.  
  21.   LZHC [D] [T] [S] [L] [filepath]
  22.  
  23.  Where:
  24.         [filepath] = full filepath for file(s) to convert (wildcards excepted)
  25.         [D]        = if the D option is used, the original file WILL NOT be
  26.                      deleted
  27.         [T]        = if the T option is used, the original file date will NOT
  28.                      be changed to the date of the .LZH file
  29.         [S]        = if the S option is used LZHConvert will create self-
  30.                      extracting archives
  31.         [L]        = if the L option is used, LZHConvert WILL NOT create a
  32.                      log file of the converted files
  33.  
  34. Examples of usage:
  35.  
  36.          LZHC C:\FIDO\FILE\*.*
  37.  
  38.    This will convert all files in the C:\FIDO\FILE\ directory with the
  39.    extenstions  .PAK, .ARC, or .ZIP to .LZH. It will also delete each file
  40.    converted and create the log file "LZHC.LOG".
  41.  
  42.          LZHC C:\DOWNLOAD\MYFILE.ARC D
  43.  
  44.    This will convert MYFILE.ARC to MYFILE.LZH (hopefully saving space), but
  45.    will NOT delete the original file MYFILE.ARC. It will still create a log.
  46.  
  47.          LZHC T S FOO.PAK
  48.  
  49.    This requires that LZHC is in the same directory as FOO.PAK. It will
  50.    convert FOO.PAK to FOO.COM (or FOO.EXE), which is a self-extracting LHARC
  51.    file. It will also delete the original file and set the date & time to  
  52.    that of FOO.PAK and create a log file.
  53.  
  54.          LZHC L D A:\ICKY.*
  55.  
  56.    This example will NOT create the standard log file, and will NOT delete
  57.    the original file "ICKY.*". It will convert all files in your root A:\
  58.    directory that have the name "ICKY".
  59.  
  60.  
  61. Some Misc. Notes:
  62.  
  63.     You must edit the text file LZHC.DAT to meet your needs. What must exist
  64.  on EACH line is in the actual file, but you must leave the first few lines,
  65.  or the program will not function correctly. It is all rather simple really.
  66.  
  67.     You also must have the archive programs (PKUNZIP,PAK,PKXARC[or PKUNPAK],
  68.  LHARC) in the paths that must be specified in LZHC.DAT. If the paths are
  69.  incorrect, but that specific program is not used to convert the files you
  70.  have, then you should be ok. Otherwise, the program will not perform
  71.  properly when it comes to a file that needs that archive program.
  72.  
  73.     Also, you should make sure there is more space on your hard drive
  74.  (or floppy disk) than the twice the size of the archive file being converted,
  75.  just to be safe. However, with version 1.4, the program will now read the
  76.  errorlevels of the external programs and act accordingly, so it will exit
  77.  if it runs out of disk space.
  78.  
  79.     If you don't know anything about LHARC, this little bit of info might
  80.  be helpful:
  81.  
  82.     LHARC is a file compression program new to the and US created in Japan.
  83.     It is one of the best ones I have found, and compresses much smaller
  84.     than PKZIP v0.92. However, PKZIP v1.0x compresses about the same, and
  85.     somewhat faster. The C source for LHARC is readily becoming available,
  86.     and the .EXE file is small and easy to use. Hopefully this will provide
  87.     some backround for those with little knowledge of LHARC.
  88.  
  89. NOTE: While LHARC does create smaller archives than PKZIP 0.92, there is one
  90.       slight drawback: LHARC CAN NOT HANDLE SYSTEM AND HIDDEN FILES (I don't
  91.       think), but LZHConvert can, however. Keep in mind that LZHConvert and
  92.       LHARC work fine with read-only files sometimes found in PKZIP files.
  93.  
  94.  
  95. WARRANTY:
  96.  
  97.    There is NO warranty. I have spent a lot of time writing this little
  98.    program, as I do in all my programs, no matter how simple they are.
  99.    However, I make no warranties or guarantees. I will tell you that this
  100.    program DOES work on my computer, but it may NOT work on yours, therfore
  101.    I am not going to say it will because of the fact I would probably get
  102.    sued for it. You USE THIS PROGRAM AT YOUR OWN RISK!
  103.  
  104.  
  105. Distribution:
  106.  
  107.    You are free to give this program to anyone or anything under the sun
  108.    PROVDING that you abide by the following:
  109.  
  110.    1. You distribute ALL of the files listed at the beggining of this
  111.       documentation TOGETHER.
  112.  
  113.    2. You do not modify any of the included files in any way.
  114.  
  115.    3. You do not charge a fee for distribution of these programs totaling
  116.       more than $8 (unless the postage exceeds $8).
  117.  
  118.    4. Mail order organazations that wish to include this program in their
  119.       mail catalogues must obtain written permission in order to do so.
  120.       This is done in order for me to find out who is distributing my
  121.       programs. The address of CollisionWare(tm) Premium SoftWare can be
  122.       found at the end of this documentation.
  123.  
  124.    Othwerwise, LZHConvert is totally free and no fee is required. If you
  125.    feel like you want to send something, please read the section below
  126.    entitled "DONATIONS &  Source Code".
  127.  
  128.  
  129. CollisionWare(tm) SoftWare:
  130.  
  131.    For a list of other CollisionWare(tm) Premium SoftWare, please view
  132.    the file contained entitled "CWFILES.TXT".
  133.  
  134.  
  135. DONATIONS &  Source Code:
  136.  
  137.     If you would like the full Turbo Pascal v5.5 source code to the program, 
  138.     the small fee is $9 (includes donation of $5). Please state so. 
  139.     If you are interested in the source code when you sendin your donation. 
  140.     Please make all checks or money orders payable to Kito D. Mann.
  141.  
  142.       9525 HeathWood CT
  143.          Burke, VA
  144.            22015
  145.  
  146.  
  147. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  148.