home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 496.lha / APE_v1.0 / APE.TXT.pp / APE.TXT
Encoding:
Text File  |  1991-04-07  |  6.0 KB  |  210 lines
  1. APE - Amiga's Packing Enhancement V1.0
  2.  
  3. Author: Jim Geuther
  4.     Graanzolder 29
  5.     3262 CR  Oud-Beijerland
  6.     Netherlands (Europe)
  7.  
  8. This archive contains APE V1.0, Ape V1.0 is a pre-release beta-version of a
  9. new (yet another) packing (compression) program for the Amiga. In contrast to 
  10. other Amiga compression programs, this program is bug free!
  11.  
  12. APE was designed to:
  13.  
  14. o    Amiga Only, no shitty MS-DOS features
  15.  
  16. o    Be bug free (no undocumented features either)
  17.  
  18. o    Have a good compression ratio
  19.  
  20. o    Be fast
  21.  
  22. o    Easy to install.
  23.  
  24. Syntax:
  25.  
  26. APE command archive_name file_specification
  27.  
  28. Command can be one of the following characters:
  29.  
  30. a    Add new files to the archive. The archive will be updated with the
  31.     files specified in file-specification. Only files which don't 
  32.     exist in the archive will be archived.
  33.  
  34. d    Deletes the files specified in the file-specification from the
  35.     archive.
  36.  
  37. f    Freshen, the archive will be updated with the files in the file-
  38.     specification when they're already in the archive and have a more
  39.     recent date.
  40.  
  41. i    IFF-display, displays IFF files (not yet implemented)
  42.  
  43. m    Move, same as u but files will be deleted!!!
  44.  
  45. u    Updates the archive with the files specified in the file-specification.
  46.     If the file doesn't exist in the archive or when the file has a more
  47.     recent date it will be archived.
  48.  
  49. x    Extracts file from the archive.
  50.  
  51. v    Verbose, lists all the files in the archive.
  52.  
  53. Highlights:
  54.  
  55.     Better compression ratios than any other compression program.
  56.         
  57.     During encoding the original protections bits, date, filename and
  58. comment will be stored into the archive. During decode the protection
  59. bits, original filename and comment will be restored.
  60.  
  61.     Supports empty files.
  62.  
  63.     Written entirely in C.
  64.  
  65. Requirements:
  66.  
  67.     An Amiga which is not running any games currently.
  68.     Arp.Library V33
  69.     Req.Library
  70.     512K RAM (or more)
  71.  
  72. Future enhancements:
  73.  
  74. o    Intuition support
  75.  
  76. o    Workbench support
  77.  
  78. o    A command language like AmigaDOS commands, 
  79.     Add commands from archive handling, like comparing files with files
  80.     in archive, merging archives, etc...
  81.  
  82.     Search text of data within archives.
  83.  
  84. o    ARexx interface
  85.  
  86. o    Display IFF-Graphics files
  87.  
  88. o    Self extracting archives.
  89.  
  90. o    Adding sorting options during listing options.
  91.  
  92. o    Implement dynamic hufman encoding for faster compression.
  93.  
  94. o    Restoring file under a different name.
  95.  
  96. o    As soon as a version has been implemented with all of above options
  97.     The source of this program will be put in Public Domain.
  98.  
  99. Recovery:
  100.  
  101.     When an accident occurs there are several files left.
  102.  
  103.     filename.ape
  104.     filename.ap$
  105.     T:APE.timestamp
  106.  
  107.     Depending on the type of error one can do the following:
  108.  
  109.     1.    Delete the filename.ape and rename filename.ap$ to
  110.         filename.ape then delete T:APE.timestamp
  111.  
  112.     2.    Delete filename.ap$ and T:APE.timestamp
  113.  
  114. Restrictions:
  115.  
  116.     No more than one task should access an archive.
  117.  
  118.     When using wildcards in the file-specification, case must match.
  119.  
  120.     The program can be interrupted using CTRL-C, remember when using
  121.     this option, the results might be unpredictable.
  122.  
  123. Status:
  124.  
  125.     This program is in public domain and may be copied freely, any
  126.     commercial use is forbidden. BBS which have this program in there
  127.     file area(s), must give author of this program full download access
  128.     to the file area containing this program.
  129.  
  130.     This program has been put in BBS's to have it evaluated. Comments
  131.     remarks can be electronically sent to: Jim Geuther, QBBS Hoekse Waard
  132.     0031-1866-1491.
  133.  
  134.     No part of this program or it's source may be
  135.     copied or used in any commercial program witouth a written
  136.     permission of the author.
  137.  
  138.     This program has met a basis set of programming and documentation    
  139.     standards, but may not have been program tested in any formal
  140.     fashion by Jim Geuther. The user is expected to make the final
  141.     evaluation as to usefullness in his own environment.
  142.     
  143.     Jim Geuther makes no warranty, expressed or implied, including but
  144.     not limited to, the implied warranty or merchantability, and
  145.     fitness for a particular purpose as to the documentation, function
  146.     or performance of this program.
  147.     
  148.     Jim Geuther will not be liable for any special, incidental, 
  149.     consequential, indirect or similar damages due to loss of data or
  150.     any other reason. 
  151.     
  152.     Acceptance and use of this program constitutes a release from 
  153.     liability of Jim Geuther, for any problems use of the program may
  154.     cause at the user's site.
  155.     
  156.     Users are invited to submit suggestions or error documentation to
  157.     Jim Geuther. However no promise can be made that such suggestions will
  158.     be implemented or errors corrected. Comments and contributions can
  159.     be submitted to above address.
  160.     
  161.     The name of the author and his address must not be removed
  162.     from the documentation or program (may the virusses strike you).
  163.  
  164.     People interested in C source program swapping should contact
  165.     the author at the above address or send an electronic
  166.     message to Jim Geuther at the QBBS Hoekse Waard.
  167.     
  168. Installation
  169.  
  170.     Copy program and doc's to a sub-directory available via the PATH commands.
  171.     Copy arp.library and req.library to the LIBS: directory.
  172.     Reset Amiga and go ahead.
  173.  
  174.  
  175. Question & Answers:
  176.  
  177. Q.    Why is the size of the control information in the archive so
  178.     big?
  179. A.    Because control information is stored in fullwords (4 bytes), to
  180.     have no limititations on size, etc...
  181.  
  182. Q.    Why are the filenames and comments in the archive not compressed?
  183. A.    To save execution speed.
  184.  
  185.  
  186.  
  187. Credits:
  188.  
  189. Thanks to:
  190.  
  191. ARP.Library        For making the programming job easier.
  192. Req.library        To simplify the use of requesters.
  193.  
  194. Kenjirou Okubo        For putting the C Sources files in public domain.
  195. Haruhiko Okomura    For explaining the algorithms
  196.  
  197. Commodore        For making the Amiga so hard to program.
  198. Lattice            For making a nice development compiler.
  199. Aztec            For making that excellent optimizing 5.0 compiler.
  200. WordPerfect        For not making WP 5.0 for the Amiga.
  201. Rahul Desi        For inventing ZOO
  202. Brian Waters        For making ZOO so slow.
  203. Raymond S.Brand        For not using a better compression algorithm.
  204. Paolo Zibetti        For making duplicate files in his .lzh archives.
  205. Phil Katz        For not giving a Command Line Interface to PKazip.
  206. Jack Lems        For borrowing me, his Supra Modem.
  207. Steve Jobs        For make the first PC.
  208.  
  209.  
  210.