home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / pascal / library / dos / tug__002 / dearc.txt < prev    next >
Encoding:
Text File  |  1988-08-08  |  5.6 KB  |  126 lines

  1. TUG PDS CERT 1.01 (Documentation)
  2.  
  3. ==========================================================================
  4.  
  5.                   TUG PUBLIC DOMAIN SOFTWARE CERTIFICATION
  6.  
  7. The Turbo User Group (TUG) is recognized by Borland International as the
  8. official support organization for Turbo languages.  This file has been
  9. verified by the TUG library staff.  We are reasonably certain that the
  10. information contained in this file is public domain material, but
  11. it is also subject to any restrictions applied by its author.
  12.  
  13. This diskette contains information determined to be in the PUBLIC
  14. DOMAIN, provided as a service of TUG for the use of its members.  The
  15. Turbo User Group will not be liable for any damages, including any lost
  16. profits, lost savings or other incidental or consequential damages arising
  17. out of the use of or inability to use the contents, even if TUG has been
  18. advised of the possibility of such damages, or for any claim by any
  19. other party.
  20.  
  21. To the best of our knowledge, the information in this file is accurate.
  22.  
  23. If you discover an error in this file, we would appreciate it if you would
  24. report it to us.  To report bugs, or to request information on membership
  25. in TUG, please contact us at:
  26.  
  27.              Turbo User Group
  28.              PO Box 1510
  29.              Poulsbo, Washington USA  98370
  30.  
  31. --------------------------------------------------------------------------
  32.                        F i l e    I n f o r m a t i o n
  33.  
  34. * DESCRIPTION
  35. Text file for DEARC.PAS.
  36.  
  37. * ASSOCIATED FILES
  38. DEARC.PAS
  39. DEARCABT.PAS
  40. DEARCGLB.PAS
  41. DEARCIO.PAS
  42. DEARCLZW.PAS
  43. DEARCUNP.PAS
  44. DEARCUSQ.PAS
  45. DEARC.TXT
  46.  
  47. * CHECKED BY
  48. DRM - 08/08/88
  49.  
  50. * KEYWORDS
  51. TURBO PASCAL V4.0 DOCUMENTATION
  52.  
  53. ==========================================================================
  54. }
  55.  
  56.  
  57.           A while back, I stumbled across a file called DEARC512.ARC on a
  58.           bbs that I happen to frequent.  Contained in this archive was a
  59.           Turbo Pascal program for extracting files from an ARChive.  While
  60.           not as fast as the more familiar ARC, ARCE, and PKXARC programs,
  61.           the source code provided me with the insights into ARC file
  62.           structure and decompression algorithms that I had been looking
  63.           for (I've always been a bit curious about things of this type). I
  64.           found something lacking in the source code, however, and that was
  65.           support for "squashed" files (as created by Phil Katz's PKARC
  66.           program).
  67.  
  68.           About that time, a file called NARC11.ARC was beginning to appear
  69.           in the upload directories of many bulletin boards. This file,
  70.           created by Gary Conway, contained a program to front-end ARC with
  71.           a mouse driven menu. It also happened to contain the most
  72.           understandable documentation of ARC compression methods I had
  73.           ever encountered (thanks, Gary).  Whether you use Gary's program
  74.           or not, it is well worth the download time just to have a peek at
  75.           his documentation.
  76.  
  77.           With the NARC document in hand, I was able to modify the original
  78.           program (DEARC512.PAS) to include support for extraction of
  79.           "squashed" files.  In doing this, I wanted to avoid, as much as
  80.           possible, changing the "flavor" of the original coding, which
  81.           actually worked quite well.  For this reason, a comparison of
  82.           dearcsq.pas with dearc512.pas will reveal very few changes (e.g.,
  83.           I left the original argc and argv functions in, rather than
  84.           replace them with Turbo's ParamCount and ParamStr functions).
  85.  
  86.           My thanks to Gary Conway, the original author of dearc.pas
  87.           (whoever you are) and also to Roy Collins and David W. Carroll
  88.           who have also made contributions to the upkeep of this program.
  89.  
  90.  
  91.  
  92.                                                                 rpb
  93.                                                                 7/28/87
  94.  
  95.  
  96.           -----------------------------------------------------------------
  97.  
  98.  
  99.           my experience was similar - i ran into both dearc512 and dearcsq
  100.           (richard's un-squashing version).  i thought it might be nice to
  101.           modernize the code (which had been written for cp/m 86 and dos
  102.           compatibility).  i felt relatively secure that eliminating the
  103.           cp/m end of things wouldn't hurt anybody (after all,  there's
  104.           always the old version).  i also added a few 'bells and
  105.           whistles',  such as time/date stamping of extracted files to
  106.           match the dates in the archive,  more descriptive decompression
  107.           messages ('unCrunching', 'unSquashing',  etc),  as well as a few
  108.           bug fixes and general tidying up of the code.  some speed is
  109.           gained by the fact that floating point is no longer used,  along
  110.           with a buffer size of 512 rather than 128 bytes,  more reflective
  111.           of the DOS world.
  112.  
  113.           ditto richard's nod to gary conway's narc docs - i would also
  114.           recommend the ARC source and,  if you can find it,  a completely
  115.           incompatible but very good (and well-documented with source)
  116.           ARC/UNARC utility called DWC (check the Cork Board,
  117.           (201)-463-001).
  118.  
  119.           and of course,  hats off to richard,  roy,  david,  and the tomb
  120.           of the unknown original author.  sorry i didn't add another ARC
  121.           version this time - there aren't any new ones!
  122.  
  123.                                                                  paul
  124.                                                                  7-26-88
  125.  
  126.