home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / utility / archiver / lzh201le / afx_e.doc next >
Text File  |  1991-09-02  |  6KB  |  153 lines
  1. AFX Version 1.1                                                19.08.91 
  2. ------------------------------------------------------------------------ 
  3.  
  4.                         Automatic 
  5.                         File           
  6.                        eXtractor 
  7.  
  8. This program enables any other program to work with compressed files. If
  9. AFX is installed, the program is not able to distinguish between compress
  10. and uncompressed files. The files are decoded at the time they are loaded.
  11. AFX will only decode that part of the files, a programm actually needs, this
  12. means AFX needs only a small amount of memory (in this distribution: 24KB).
  13.  
  14. 1. Installation
  15.  
  16.    Simply copy AFX.PRG into your auto-folder and restart the system.
  17.  
  18. 2. Compression of files
  19.  
  20.    I have planned to use standard lzh-files but this has the disadvanage
  21.    that LHarc will no longer work with AFX installed. This is because it
  22.    is impossible for LHarc to read a compressed lz5-file. For that reason,
  23.    the method is set to -afx-. 
  24.    
  25.    LHarc 2.01d and newer versions have a special command for AFX. The 
  26.    difference is
  27.      - every file is packed into itself, so you don't have to specify an
  28.        archiv.
  29.      - The method is set to -afx- instead of -lz5-
  30.     
  31.    To compress one or more files, simply use the command "c", eg. after
  32.    a double click on LHARC.TTP type:
  33.    
  34.     c filenames
  35.     
  36.    to compress one or more files or
  37.     
  38.     c -r filenames
  39.     
  40.    to recursivly compress one or more files.
  41.    
  42.    For example: If you want to pack ALL .RSC-Files start LHarc from root and
  43.    type
  44.    
  45.      c -r *.rsc
  46.      
  47. 2. How it works
  48.  
  49.    If a program opens a file, AFX will intercept this command and looks if
  50.    this file is stored in compressed form. This means, the file must contain
  51.    a complete LHarc headers with correct checksum and the method must be
  52.    -afx-. If the file is compressed, AFX will rememer this and intercept
  53.    every fread, fseek and fclose-command for this file and translate them
  54.    into several fread and decode-commands.
  55.    
  56.    AFX needs some memory to work, since not all programs like it if the
  57.    amount of available memory is decrese in an open-command, AFX has its
  58.    own memory pool. In this version it contains 20 KB -- enough for 2
  59.    open files. If you have more than 2 files opened at once, AFX will
  60.    start to work with system-memory.
  61.    
  62.    AFX in its present state is not able to decode and start program-files.
  63.    For this we have PFXPAK, since PFXPAK has not that much "housekeeping"
  64.    to do, it works faster than AFX.
  65.    
  66.    It is not possible to write on compressed files. Compression can only
  67.    be done with the whole file. If you change the first byte of a compressed
  68.    file, you will eventually have changes in the whole file. For that
  69.    reason, AFX would have to recompress the whole file every time a byte
  70.    is changed (or it has to recompress it after it is closed). Since 
  71.    comrpession needs much time or much memory, this should be done with
  72.    a seperate program.
  73.    
  74. 3. Speed
  75.  
  76.    All mesurements are made with a Megafile 30 and 4KB Buffersize and
  77.    an 187KB text-file. AFX is faster if the file has a good compression
  78.    rate and slower if it has a bad compression rate.
  79.    
  80.    Short files or short parts of a large file (less than 10KB) are processed
  81.    at a speed of about 55KB per second (depending on the file).
  82.    
  83.    If the file or the part of the file is larger than 10KB only the first 
  84.    4KB and the last some hundred bytes of it are read in low speed. The 
  85.    middle part is read in high speed. The test file is read at a reat
  86.    of about 100KB per second.
  87.    
  88. 4. Future-versions
  89.  
  90.  
  91.    - If a write on a compressed file occures, the whole file should be 
  92.      docoded on disk first.
  93.    - I am thinking of a new format to increase decoding-speed, eventually
  94.      increasing code-size.
  95.    - I am thinking of a special AFX-Packer.
  96.    
  97. 5. History
  98.  
  99.   Version 1.3
  100.    
  101.     - More speed in decoding files.
  102.  
  103.   Version 1.2
  104.  
  105.     - Should make no problems with any programs.
  106.  
  107.   Version 1.1
  108.   
  109.     - 1.0 lookked, if files like CON: or PRN: deliver compressed data. The
  110.       effect was, that it was possible to type in data, or, the program
  111.       simply hangs.
  112.     - Sometimes, AFX will start without delay.
  113.     - More speed.
  114.     
  115.   Version 1.0  
  116.   
  117.     - First working version. Before I delivered this version, I packed all
  118.       my source-codes and texts and worked with tem a few days. 
  119.       
  120. 6. Shareware
  121.  
  122.    This is not free software. If you paied a public-domain vendor for
  123.    this program, you paid for the service of copying and shipping the
  124.    program, not for the program itself. This means that nothing ever
  125.    get to the autors from this sale. 
  126.  
  127.    You are allowed to copy AFX and to give it to your friends or a 
  128.    PD-Library. It is not allowed to sell this program. It is not allowed
  129.    to copy this program without its documentation or without the 
  130.    registration-form.
  131.  
  132.    Your version has the same functions as the registered version, so 
  133.    you are able to evaluate it. The difference it, that fseek is a 
  134.    bit slower, you get a message for 5 seconds at start-time and
  135.    this version does not contain all utilities.
  136.    
  137.    If you register, you get:
  138.      
  139.      - A program to modify the buffersizes. Large buffers make AFX work
  140.        a more speed (if you have the memory).
  141.      - A faster routine for fseek.
  142.      - It will start without delay.
  143.      - A free new version of PFXpak, Fortune and LHarc.
  144.      
  145.   If you like to register, or if you have any questions, please write to
  146.  
  147.     Thomas Quester
  148.     Lampenland 9
  149.     2050 Hamburg 80
  150.     Germany.
  151.  
  152.  
  153.