home *** CD-ROM | disk | FTP | other *** search
/ For Beginners & Professional Hackers / cd.iso / software / arc / limit.arj / LIMIT.DOC next >
Encoding:
Text File  |  1993-07-20  |  6.3 KB  |  228 lines
  1.                                 20 July 93
  2.  
  3. LIMIT version 1.0
  4.  
  5. Data Compression Archive utility
  6. -------------------------------------------------------------------------------
  7.  
  8. LIMIT is a fast and compact data compressor/archiver. The compression &
  9. decompression routines have been written entirely in 80286 assembly, so it
  10. runs faster than many other archivers. LIMIT also compresses better than
  11. other archivers; it uses a compression method based on 32K sliding window
  12. dictionary plus huffman encoding, similar to LHA/PKZIP/ARJ, but with some
  13. improvments.
  14.  
  15. LIMIT is free! You may distribute freely, as long as the program is not
  16. modified in any way. You are encouraged to contribute $20/- to the
  17. programmer if you like this archiver.
  18.  
  19.  
  20.  
  21. 1.  Files included in LIMIT 1.0
  22. ===============================
  23.  
  24.     LIMIT.EXE    the executable file
  25.     LIMIT.DOC    LIMIT documentation
  26.  
  27.  
  28. 2.  System requirements
  29. ===============================
  30.  
  31.     80286 (PC/AT) and above
  32.     Minimum conventional memory:
  33.       270k for updating/creating archives
  34.       170k for extracting/testing archives
  35.  
  36.  
  37. 3.  How to use LIMIT
  38. ===============================
  39.  
  40. Usage:
  41. LIMIT command [options] archive[.LIM] [files] [@listfile] [#commentfile]
  42.  
  43. The special prefix '#'  specifies a comment file to be added/deleted to/from
  44. archive. Prefix '@' species a list file to be included.
  45.  
  46. A list file is a text file consisting of file specfications separating by
  47. space/tab/newline.
  48.  
  49.  
  50. 4.  Commands
  51. ===============================
  52.  
  53.     a[dd]        add files to archive, create one if necessary
  54.  
  55.     c[reate]    create new archive
  56.             (delete previous archive of the    same name)
  57.  
  58.     del        delete files (or comment) in archive+
  59.  
  60.     e[xtract]    extract files in archive
  61.  
  62.     h[elp]        display help information
  63.  
  64.     i[nfo]        archive info
  65.             shows summary of archive
  66.  
  67.     l[ist]        list specified files in archive
  68.  
  69.     rd        remove directories
  70.             (directories must be empty.)
  71.  
  72.     t[est]        test files in archive by perform CRC checks
  73.  
  74.  
  75.  
  76. 5.  options: (use - or / prefix)
  77. ===============================
  78.  
  79.     -x<files>    exclude files from the file list
  80.             a list file may be specified: -x@listfile
  81.  
  82.             [commands: a,c,del,e,rd,t]
  83.  
  84.     -d<dir>        add/extract directory
  85.             adding files: specifies the path to add files to
  86.             extracting files: specifies the path to extract to
  87.  
  88.             [commands: a,c,e]
  89.  
  90.     -n        add/extract new files only
  91.  
  92.             [commands: a,c,e]
  93.  
  94.     -r        recurse sub-directories
  95.  
  96.             [commands: a,c]
  97.  
  98.     -s        recurse and store/extract partial paths
  99.             files are added/extracted to their partial paths
  100.  
  101.             default: all files are added to root directory,
  102.             and extracted to the current directory
  103.  
  104.             [commands: a,c,e]
  105.  
  106.     -p        store/extract full original paths
  107.             files are added/extracted to their original paths
  108.  
  109.             default: all files are added to root directory,
  110.             and extracted to the current directory
  111.  
  112.             [commands: a,c,e]
  113.  
  114.     -w[h|s]        include hidden or system files
  115.             default: hidden/system files are not added to archive
  116.  
  117.             [commands: a,c]
  118.  
  119.     -es        extract to screen
  120.             default: extract to file
  121.  
  122.             [command: e]
  123.  
  124.     -y        yes to all queries:
  125.             1) del command: "delete all files?"
  126.             2) e command: "overwrite file?"
  127.  
  128.     -m[0|1|s|x]    compression methods:
  129.             -m0: store only
  130.             -m1: normal compression  (default)
  131.             -ms: fast compression
  132.             -mx: maximum compression
  133.  
  134.             [commands: a,c]
  135.  
  136. 6.  Examples
  137. ===============================
  138.  
  139. LIMIT a test *.c     add all *.c files to test.lim archive
  140.  
  141. LIMIT a test /dabc    add all (default) files to directory "abc" in test.lim
  142.  
  143. LIMIT t test        test (using CRC checks) the archive test.lim
  144.  
  145. LIMIT l test *.asm    list all *.asm files in test.lim
  146.  
  147. LIMIT l test \abc\*    list all files in \abc directory in test.lim
  148.  
  149. LIMIT e test        extract all files in test.lim to current directory
  150.  
  151. LIMIT e test /n        extract all new files in test.lim to current directory
  152.  
  153. LIMIT e test /y        extract all files (overwrite, no query) to current dir
  154.  
  155. LIMIT e test *.c /dc:\    extract all *.c files to C:\
  156.  
  157. LIMIT del test *.h    delete all *.h files
  158.  
  159. LIMIT rd test \temp    remove \temp directory in archive test.lim
  160.  
  161. LIMIT i *        shows information of all archives in the current dir
  162.  
  163. LIMIT a -mx test    add all files to test.lim, with maximum compression
  164.  
  165. LIMIT a test /whs    add all files (including hidden & system) to test.lim
  166.  
  167. LIMIT a test \abc\*.* /r /p    add files, recurse sub-dirs and store full
  168.                 paths, i.e. include directory \abc
  169. LIMIT a test \abc\*.* /s    add files, recurse sub-dirs and store new
  170.                 paths (excluding directory \abc)
  171. LIMTI a test \abc\*.* /r    add files, recurse sub-dirs, store all files
  172.                 in root directory
  173. LIMIT a test \abc\*.* /p    add files, store full paths
  174.  
  175. LIMTI e test /p            extract all files and subdirectories into
  176.                 original paths
  177.  
  178. 7.  Setting the environment string LIMIT
  179. ========================================
  180. Options that are included in the environment string LIMIT are automatically
  181. included whenver LIMIT is run. To set the environment string, type
  182.  
  183. > set LIMIT = /mx /n
  184.  
  185. This tells LIMIT to use maximum compression and add/extract newer files only.
  186. However, options specified in the command line override those options in
  187. the LIMIT environment string.
  188.  
  189.  
  190. 8.  Compression method
  191. ===============================
  192. LIMIT employs a LHA/PKZIP/ARJ-similar kind of sliding dictionary plus huffman
  193. encoding, with some minor enhancements.
  194.  
  195. A compression index controls the extent to which strings are searched in the
  196. dictionary. The index for each compression option is as follows:
  197.  
  198.     /ms (fastest) compression: 30
  199.     /m1 (default) compression: 300
  200.     /mx (maximum) compression: 3000
  201.  
  202. However, there are files where a smaller index yields better compression.
  203. You may fine-tune the compression by controlling the index, using option
  204. /c<index>.
  205.     e.g. LIMIT a /c1000 archive *.*
  206.  
  207.  
  208. 9.  Bugs/Comments
  209. ===============================
  210. No program is free of bugs, so report any bugs or comments or suggestions to
  211. the programmer.
  212.  
  213.  
  214. 10. Contributions, please!
  215. ===============================
  216. LIMIT is the product of thousands of programming hours. If you like this
  217. program, please contribute some money ($20 would be great!) to the programmer
  218. as a token of encouragement.
  219.  
  220.  
  221. -------------------------------------------------------------------------------
  222.  
  223. J Y LIM
  224. jlim@sunlab.cit.cornell.edu
  225. 226, Linden Ave. Apt 1.
  226. Ithaca, NY 14850
  227. USA
  228.