home *** CD-ROM | disk | FTP | other *** search
/ Joystick Magazine 1994 December / CdJoystickNo1.iso / fissa / hap / hap300.doc < prev    next >
Text File  |  1994-03-13  |  9KB  |  211 lines
  1.           Hamarsoft (R) Hap & Pah 3.00, November 15, 1992, 0700 GMT.
  2.                 = Re-Release of January 7th 1994 12:00 GMT =
  3.     You will need an Intel 80286, NEC V20 or higher to run these programs.
  4.  
  5.  
  6.           DISCLAIMER : You are using this software at your own risk !
  7.  ---------------------------------------------------------------------------
  8.   Harald Feldmann will in no way be liable for any damages, loss of business
  9.   profits, business interruption or loss of business-, private-, public- or 
  10.   other information, arising out of the use or inability to use the Hap and/or
  11.   Pah programs or data processed by the Hap and/or Pah programs, whether 
  12.   direct or consequential, regardless of the fact that Harald Feldmann may
  13.   have been advised of the possibilities of such damages.
  14.  ===========================================================================
  15.             This software is provided to you under the terms of the 
  16.  Hamarsoft License Agreement. By using the software you agree to be bound by
  17.  those terms. You are assumed to have taken knowledge of those terms prior to
  18.                               using the software.
  19.  
  20.  
  21.   Hamarsoft (R) is a registered trademark and a registered servicemark owned
  22.                               by Harald Feldmann.
  23.  
  24.              Hap TM and Pah TM are trademarks of Harald Feldmann.
  25.  
  26.                    Other mentioned products' trademarks and 
  27.                     registered trademarks are acknowledged.
  28.  
  29.     These programs were completely designed and written by Harald Feldmann
  30.                                throughout 1992.
  31.  
  32.  
  33.  
  34. Send all mail to our NEW address:
  35.  
  36. Hamarsoft
  37. Harald Feldmann
  38. P.O. Box 451
  39. 6400 AL  Heerlen
  40. The Netherlands.
  41.  
  42.  
  43.  
  44. WHY HAP ?
  45.         I introduced something new early 1992 by distributing HAP&PAH 2.10.
  46.         The 3.00 release was a major improvement in compression speed and
  47.         archive size. Also: 3.00 handles multiple files of any length < 4Gb.
  48.         The latest release, available to registered HAP 3.00 users only,
  49.         gives much improved compression speed; typicaly two to five times
  50.         as fast as 3.00. In a multiple file environment with many small text
  51.         files the improvement may yield twentyfold.
  52.  
  53.  
  54. HANDS-DOWN ?
  55.         Hap usually compresses better than ARJ 2.41P from Robert Jung 
  56.         and also better than PKWARE's PKZIP 2.04g.
  57.         Both are very good programs.
  58.  
  59.  
  60. SPEED
  61.         Hap was deliberately kept small so virtually all of its code would
  62.         fit into the 80486's internal on-chip cache (which is 8Kb).
  63.         Almost all of Hap's DATA fits into the second-level cache of a 
  64.         486 board. Both these facts should enable Hap to run as efficiently
  65.         as possible on an 80486 equipped machine with 256Kb cache.
  66.         Hap was designed for Intel 80286, NEC V20 and higher CPUs.
  67.  
  68.  
  69. BUGS !
  70.         This SHAREWARE version was released for tactical reasons.
  71.         So it still contains a few known 'bugs' related to screen-output and
  72.         aborted files.
  73.         Note that this SHAREWARE version has a file handling bug which prevents 
  74.         you from deleting files which differ only in the last character of
  75.         the file extension (thus the filenames must be identical)
  76.  
  77.         Example: HAPTESTA.BAK
  78.         and      HAPTESTA.BAT
  79.  
  80.         These two will be processed simultaneously during a 'd' or 'e' command.
  81.         So both will be deleted or extracted when specifying either one.
  82.         The registered version does not have this bug. The SHAREWARE version 
  83.         is sufficiently operating to let you decide whether to register or not.
  84.  
  85.         The compression and decompression algorithm work FINE, no bugs to the
  86.         best of my knowledge. I compressed a lot of files and all came back 
  87.         without a single bit changed.
  88.         You may compare (renamed) original and uncompressed files by using
  89.         fc.com which you may find on your DOS disks. Remember to add
  90.         the /b switch, see your DOS manual for more information.
  91.  
  92.         If you find anything weird that does not relate to screen-output
  93.         send me a message.
  94.         Note that the file format of Hap 2.10 was rudimentary, the revised
  95.         format Hap 3.00 uses should be stable, I have made provisions for 
  96.         expansion features in the future. Yes, it means 2.10 files are
  97.         incompatible with Hap 3.00 and vice versa (the internal structure
  98.         differs as well due to an algorithm improvement).
  99.  
  100.  
  101. CONTACTING THE AUTHOR:
  102.  
  103.         Ilink   : HARALD FELDMANN in the COMPRESS conference
  104.         Internet: harald.feldmann@almac.co.uk
  105.  
  106.         Mail    : Hamarsoft
  107.                   Harald Feldmann
  108.                   P.O. Box 451
  109.                   6400 AL  Heerlen
  110.                   The Netherlands
  111.  
  112.         over ilink, send your message in the international COMPRESS echo,
  113.         I should be able to pick it up there. Do NOT make your message private
  114.         since Ilink does not echo private messages !
  115.  
  116.  
  117. RAMCRAM ?
  118.         Not anymore ! You should now be able to run Hap and Pah with 376 Kb
  119.         free memory. Hap and Pah should accept files of any size and compress
  120.         and decompress them successfully.
  121.  
  122.  
  123. MONEY ?
  124.         Hamarsoft HAP and PAH is a SHAREWARE package, hence you are strongly
  125.     URGED to register and send USD 20,- if you use it longer than 30 days.
  126.         Registration entitles you to one free upgrade to HAP and PAH 3.14e,
  127.         which is currently available to registered users only.
  128.         HAP 3.14e will NOT be released as shareware. You will receive a 
  129.         personalised copy (it contains your name in the screen) on 3.5" disk.
  130.         Note that in addition to greater speed, HAP 3.14e also provides new
  131.         features such as incremental backups and a move command.
  132.         HAP 3.14e detects and supports advanced features of 80386 and higher
  133.         processors.
  134.  
  135.         You are encouraged to support me by returning the registration form
  136.         and an amount of USD $20,- to the P.O. box address to stimulate
  137.         further development of Hap and Pah. Please do not take the text on the 
  138.         registration form as offensive, I just don't like to get into any
  139.         legal trouble.
  140.         Just for the record: the HAP 2.10 discount offer hereby expires.
  141.  
  142.  
  143. SYNTAX
  144.  
  145. ADDING FILES TO AN ARCHIVE
  146.  
  147.         <must-supply text> [additional filespecs]
  148.         do not type the <> or [].
  149.  
  150.         <HAP> <a> <haparch> [drive:][\path\]<filespec1> [filespec2 filespec3 ..]
  151.  
  152.         adds the files on drive:\path\filespec to haparch. You may specify any
  153.         filename for haparch even with extensions. Hap will cut off the 
  154.         extension, if any, and add .HAP itself.
  155.         Hap 3.00 does not store subdirectories and does not search any within
  156.         another. Note that the <a>, <haparch> AND <filespec1> MUST be supplied.
  157.         Meaning 'add all files in the current directory to HAPPY.HAP' is done 
  158.         by:
  159.  
  160.         HAP a HAPPY *.*
  161.  
  162.         Aborting compression leaving the already compressed files intact in 
  163.         the archive is done by pressing ESC or CTRL-C.
  164.  
  165. EXTRACTING FILES FROM AN ARCHIVE
  166.  
  167.         <PAH> <e> <haparch> <filespec> [filespec2 filespec3 ...]
  168.  
  169.         extracts filespec and additional filespecs from haparch to the current
  170.         directory. Note that filespec MUST be supplied, meaning 'recall all 
  171.         files in HAPPY.HAP' is done by:
  172.  
  173.         PAH e HAPPY *.*
  174.  
  175.         In order to get your files extracted to a specific directory, move to
  176.         that directory,(make that directory your current directory) and run 
  177.         the Pah program from there.Your files will always be extracted to your
  178.         current directory.
  179.  
  180.         .....................................................................
  181.         Example:
  182.         PAH is in C:\UTIL\PAH.EXE
  183.         HAPARCH is in D:\HEY\MORE\ME\HAPARCH.HAP
  184.         you want your *.exe and *.com files to be extracted to E:\NEXT\MORE\
  185.  
  186.         you would: move to E:\NEXT\MORE
  187.         then type: C:\UTIL\PAH e D:\HEY\MORE\ME\HAPARCH *.exe *.com
  188.         in either upper or lower case.
  189.         .....................................................................
  190.         To date, PAH extracts to the current 'working' directory, a future
  191.         version may incorporate redirection.
  192.  
  193.  
  194. LISTING FILES IN AN ARCHIVE
  195.  
  196.         <HAP> or <PAH> <l> <haparch> <filespec> [filespec2 filespec3 ...]
  197.  
  198.         Lists filespec and additional filespecs within haparch. Use the
  199.         'Pause' key or CTRL-S on the AT keyboard to pause the scrolling. 
  200.  
  201.  
  202. DELETING FILES IN AN ARCHIVE
  203.  
  204.         <HAP> or <PAH> <d> <haparch> <filespec> [filespec2 filespec3 ...]
  205.  
  206. WARNING
  207. !       Deletes filespec and additional filespecs from haparch without a 
  208. !       second chance. Be sure to know what you're doing, Hap and pah do NOT
  209. !       create a second copy of your original archive ! So PCTOOLS et al
  210. !       won't work to get anything back... Make BACKUPS !
  211.