home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 392.lha / CompDisk / CompDisk.doc < prev    next >
Encoding:
Text File  |  1990-07-03  |  5.8 KB  |  124 lines
  1. ======================= CompDisk & DecompDisk ========================
  2. ======================================================================
  3. CompDisk  &  DecompDisk  ©  Copyright  1990  by  MXM,  written by Olaf
  4. Barthel.    We  make  no  guarantees  that  the  programs  CompDisk  &
  5. DecompDisk  are  fully  reliable and your data will be 100% safe.  Use
  6. use these programs on your own risk!
  7.  
  8. ============================ Hintergrund =============================
  9. ======================================================================
  10. At  present,  more  than  enough  programs  exist  which  compress the
  11. contents  of  entire  disks.  The resulting files are either amazingly
  12. short  or  take  ages  to create (so not all that glitters seems to be
  13. gold).   Here's another program of this kind that's waiting to be used
  14. by you.
  15.  
  16.                   This program does not try to:
  17.  
  18. - Work  three  hours  on  a  single  disk to produce an output file of
  19.   thirteen bytes in size.
  20.  
  21. - Reproduce  long  tracks,  exotic synchronizing formats or other copy
  22.   protections 1:1.
  23.  
  24. - To force the user to get along with a complex user interface.
  25.  
  26. If  you  expect  this program to have these features, you will have to
  27. rewrite  parts  of  the  accompanying  source  code  or  to delete the
  28. programs.
  29.  
  30. ============================ Features ================================
  31. ======================================================================
  32. Both  programs  will  operate  from  Shell,  as  well  from Workbench.
  33. Unfortunately  the  Lattice  Arp  support  code  cannot  create 'pure'
  34. programs;  'ARes'  will still make them resident, but a second call to
  35. one of them will report a checksum error.  Both programs use functions
  36. to be found in arp.library and req.library, they need to be present in
  37. your current LIBS:  directory.
  38.     CompDisk  and DecompDisk use the Lempel-Ziv algorithm for data
  39. compression/decompression.   Disks  are  read  and compressed track by
  40. track  (0-79) to usually about 50% of their original size.  If a track
  41. doesn't become smaller during the compression, it is stored 'as is'.
  42.     A  16-bit  CRC checksum is calculated over each track.  During
  43. decompression  the  checksum  is  verified.   If  it doesn't match the
  44. original value, an error message will be displayed.
  45.     To  speed  up compression, unused blocks will be zeroed (note:
  46. this can be turned off).
  47.     In  worst  cases  disk  compression  takes  about six minutes,
  48. decompression  four  minutes.   Standard  values  for  compression are
  49. between three and four minutes.
  50.     Note:   Files  created  by CompDisk aren't compatible with any
  51. other disk compression utilities.  DecompDisk will not be able to read
  52. the output files of other utilities either.
  53.  
  54. =============================== Usage ================================
  55. ======================================================================
  56. If  called  from  Shell,  CompDisk  and  DecompDisk  will  accept  the
  57. following parameters:
  58.  
  59. FILE ..........    The name of the file to be created/decompressed.
  60.  
  61. DRIVE .........    The  disk  drive  (DF0:   - DF3:  or RAD:) to read the
  62.         data  to  be compressed/to write the decompressed data
  63.         to.   At  present only the four drives mentioned above
  64.         are supported.
  65.  
  66. NOCLEAR .......    Only  the  program  CompDisk supports this switch.  If
  67.         selected, unused disk blocks will not be cleared.
  68.  
  69. If started from Shell, both programs will not open req.library.
  70.  
  71. Double-clicking  the  icon  of  either  program will bring up a window
  72. containing six gadgets:
  73.  
  74. Stringgadget...    The  name  of  the  path to create the output files at
  75.         (e.g.  RAM:, DH0:, etc.).  DecompDisk will display the
  76.         name of the file currently decompressed in the gadget.
  77.  
  78. Drives.........    Here  the  disk  drive  to  be read is to be selected.
  79.         CompDisk  will wait for you to select the drive before
  80.         you  insert  the disk.  DecompDisk wants you to insert
  81.         the  disk first before you click on the drive in which
  82.         you have inserted it.
  83.  
  84. If possible, CompDisk will create an icon for each disk it compresses.
  85. To decompress the resulting file from Workbench, this icon must not be
  86. deleted.
  87.     A  file  is decompressed from Workbench by double-clicking its
  88. icon   or   holding   down  the  shift-key,  selecting  its  icon  and
  89. double-clicking the icon of DecompDisk.
  90.  
  91. We   strongly  recommend  to  run  both  programs  on  an  Amiga  with
  92. accelerator-board.   On an A2000B with 33 MHz GVP-68030 board CompDisk
  93. will  take  about  1.07  minutes to compress a whole disk (which takes
  94. about as much time as 'DiskCopy DF0:  to RAD:'.
  95.  
  96. ================== Author's request, copy fee, etc. ==================
  97. ======================================================================
  98. It  took more blood, sweat and tears to develop these programs than we
  99. had  expected.  If you like them and use them frequently send at least
  100. US$ 10 or DM 15,- to
  101.                           Olaf Barthel, MXM
  102.                            Brabeckstraße 35
  103.                           D-3000 Hannover 71
  104.  
  105. CompDisk & DecompDisk are SHAREWARE and must not be sold commercially.
  106. A  small copy fee is still allowed.  Inclusion of one or both programs
  107. in a Public-Domain software selection (which seems to be quite popular
  108. in  Germany -> you usually pay too much for a lot of old junk) must be
  109. arranged with us.
  110.  
  111. ============================== Credits ===============================
  112. ======================================================================
  113. Credits  go  to  Arp Programmers for Arp 1.3, Stephen Satchell & Chuck
  114. Forsberg  for  the  16-Bit  CRC-routines, Bruce Dawson & Colin Fox for
  115. req.library   and   last  but  not  least  to  the  author(s)  of  the
  116. compression/decompression  routines whose name I could not discover in
  117. the source code.
  118.  
  119. ============= Program history (most recent change first) =============
  120. ======================================================================
  121. V1.6    First international release.
  122.  
  123. V1.0    Before written history.
  124.