home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / ENTERPRS / CPM / UTILS / S / UNARC14.ARC / UNARC.HIS < prev    next >
Text File  |  1993-03-28  |  8KB  |  175 lines
  1. File:     UNARC.HIS
  2. Subject:  Modification History of UNARC Program
  3. Version:  1.4
  4. Date:     November 21, 1986
  5.  
  6. The following provides a detailed history, in reverse chronological
  7. order, of the modifications made in each release of the UNARC program
  8. (as extracted from the source program file for the current version 1.4
  9. release).
  10.  
  11. ------------------------------------------------------------------------
  12.  
  13. 1.4    21 Nov 86  (RAF)
  14.  
  15. We had hoped NOT to release another update of this program, but to
  16. replace it entirely by three new programs with enhanced functionality
  17. (UNARK, ADIR, and ATYPE), in conjunction with the upcoming release of
  18. the CP/M archive file builder (NOAH).  However, (sigh).....
  19.  
  20. Corrects bug (exhibited with .ARC's created by version 1.1 or later of
  21. Phil Katz' PKARC program for MS-DOS) which caused files to be extracted
  22. incorrectly (with output file length and CRC warnings) due to string
  23. table reset codes appearing early in crunched files (i.e. before the
  24. output code length reaches 12 bits).  Thanks to Keith Petersen for
  25. identifying and notifying us of this problem.
  26.  
  27. And, while we're at it.....
  28.  
  29. Adds paging of all displayed output, controlled by non-zero patch byte
  30. specifying screen lines between pauses (TYLPS, default value = 23).
  31. This is essentially the feature added by 'Larry Smith' (see version 1.3
  32. below), but we've been able to do it (with enhancements) and still keep
  33. the (Z80 version) .COM file below 4K (just!).  Causes '[more]' message
  34. to appear at bottom of screen.  Space bar scrolls one more line, ^C
  35. aborts, anything else scrolls one more screenful.  (LINE FEED may be
  36. used to avoid overprinting the '[more]' line.)  May be defeated for
  37. continuous typeout by trailing 'N' (after a blank) on command line.
  38.  
  39. Also:
  40.  
  41. - If archive filetype omitted, and the default .ARC filetype not found,
  42.   tries .ARK as an alternate default.  (Anticipates NOAH, and compatible
  43.   with Irv Hoff's KMD22.)
  44.  
  45. - Incorporates option to bypass BDOS function 31 call (Get DPB Address),
  46.   for non-std CP/M clones such as Cromemco CDOS and CP/M-68K emulator
  47.   for 8080 CP/M 2.2.  (Eliminates UNARC12 patch notice, UNARC-P1.NOT.)
  48.  
  49. - Allows program name to be patched (at start of USAGE message).
  50.   Affects all help screen references and abort message.  (E.g., RCP/M
  51.   sysops may prefer 'ADIR' to 'UNARC'.)
  52.  
  53. - Corrects count of bytes skipped due to invalid header when processing
  54.   'self-unpacking' archives with more than 3 preliminary bytes.
  55.  
  56. - Enhances recovery processing for invalid archive headers, and merges
  57.   'invalid format' and 'unexpected eof' errors.  This change tends to
  58.   cause display of a garbage directory entry (before abort) for non-ARC
  59.   files, but it does allow processing of certain new self-unpacking
  60.   archives, such as Phil Katz' PKX32A11.COM.
  61.  
  62. - Changes the replacement for an invalid filename char from '_' to '$'
  63.   (since underline is not allowed as a filename char by CP/M CCP, and
  64.   '$' usually carries a 'temporary' significance in CP/M).
  65.  
  66. - Reduces directory listing width by one column (78 now), to allow
  67.   one more char without extra blank line on terminals which autowrap
  68.   after column 80 (e.g. allows leading semicolon generated by MDM7 and
  69.   IMP during disk file capture of terminal output).
  70.  
  71. - Adds a few bells to warning and fatal messages, along with a patch
  72.   byte to disable these (for those who prefer solitude).
  73.  
  74. - Allows ^K in addition to ^C for program abort requests.  (For certain
  75.   ancient RCP/M systems which never pass ^C back to user programs.)
  76.  
  77. - Adds .ARK and .?Z? (CP/M CRUNCH or MS-DOS ZOO 'Z format' files) to
  78.   list of excluded typeout extensions, and eliminates .CMD (since that
  79.   might be a readable dBASE command file instead of CP/M-86 binary).
  80.  
  81. - Simplifies the Z80 CPU check and removes the 'Z80 Version' message
  82.   in the help display, to save a few bytes in that version.  (Alternate
  83.   version, UNARCA.COM, now displays '8080 Version'.)
  84.  
  85. - Adds 8080 version message recommending Z80 version, when run on a Z80.
  86.  
  87.  
  88. 1.3    --none--   (RAF)
  89.  
  90. This version bypassed due to appearance of several unauthorized updates
  91. with the name UNARC13 (and not because of superstition).  Most notably,
  92. these include Steve Sanders' unnecessary addition of ^S and ^C checking
  93. during file typeout (because TurboDOS does not properly emulate CP/M's
  94. handling of these in BDOS function 2 calls), and the addition of paged
  95. typeout by 'Larry Smith' (whoever he is; a worthwhile enhancement, but
  96. the release was deficient in several other respects).  WHY CAN'T THESE
  97. 'CONTRIBUTORS' SIMPLY CONTACT THE AUTHOR BEFORE RELEASING THEIR CHANGES
  98. TO THE PUBLIC?!
  99.  
  100.  
  101. 1.2    24 Jun 86  (RAF)
  102.  
  103. Modified to allow assembly of a version which will execute on 8080/8085
  104. CPU's.  (We resisted this initially but have been made to realize that
  105. this is necessary to achieve true acceptance of UNARC by the full CP/M
  106. user community.  Non-Z80 users, particularly RCP/M sysops, still exert
  107. considerable influence in the world of public domain software.  This,
  108. we believe, is out of proportion to their numbers, since almost all
  109. CP/M systems sold in the last five years are Z80-based.  Nevertheless,
  110. we've accommodated the needs of these users by extensive use of macros
  111. which serve to emulate Z80 instructions on non-Z80 machines.)  However,
  112. no attempt has been made to optimize for either size or speed in the
  113. non-Z80 version (which is 1K larger and 50% or more slower than its
  114. Z80-only counterpart).
  115.  
  116. Also:
  117.  
  118. - Implements a "wheel" byte to simplify use and installation on RCP/M's.
  119. - Lines up file types in directory listing.
  120. - Permits processing of "self-unpacking" archives such as the MS-DOS
  121.   ARC512.COM file (anticipates a future scheme for distributing UNARC).
  122. - Attempts to recover from bad archive headers by skipping extra bytes.
  123. - Eliminates archaic "T:" syntax completely for file typeout.
  124.  
  125.  
  126. 1.1    24 May 86  (RAF)
  127.  
  128. Minor change to allow file typeout without the "T:" syntax (which
  129. didn't work with almost ANY CCP replacement)...  File will be typed if
  130. it:  (1) has no disk drive name, (2) is a single (UNambiguous) file,
  131. and (3) is not an excluded filetype.  (Else, file will simply be listed
  132. with no error message.)  This change was suggested by Irv Hoff's mod to
  133. UNARC10, which he called ADIR.  (Previous "T:" method can still be
  134. enabled, but it is now undocumented since we will probably drop it
  135. altogether in future.)
  136.  
  137. Also shortened on-line help message, so that COM file size is now
  138. reduced to 4K.  (For RCP/M systems, if HODRV = 0 and/or TYFLG = 0, the
  139. help information relating to disk extraction and/or file typeout,
  140. respectively, is automatically removed.)
  141.  
  142.  
  143. 1.0    03 May 86  (RAF)
  144.  
  145. First public release.  Supports file formats generated by all versions
  146. of MS-DOS ARC through (at least) version 5.12 dated February 7, 1986.
  147.  
  148.  
  149. 0.0    01 Mar 86  (RAF)
  150.  
  151. I undertook writing this program to satisfy my curiosity about software
  152. developments in the MS-DOS/PC-DOS world.  The ARC "freeware" program
  153. (copyright by System Enhancement Associates) has been around for over a
  154. year now and has achieved enormous popularity in the 16-bit community.
  155. Unfortunately, the lack of a compatible equivalent for CP/M systems
  156. renders a large amount of public domain software inaccessible to 8-bit
  157. users such as myself.  (Note that 16-bit software can indeed be usable
  158. on 8-bit systems, e.g. Pascal and C language programs.)  Also, an
  159. increasing number of RCP/M systems are catering to both 8-bit and
  160. 16-bit users, and it is my hope that UNARC may find a welcome home on
  161. such systems.
  162.  
  163. Note that I was not (initially) a fan of the sequential .ARC file
  164. format, which is less flexible and slower to process (though certainly
  165. more compact) than the random-access format which Novosielski .LBR
  166. libraries have provided for years.  Therefore, I stopped short of
  167. producing a complete ARC program equivalent which includes creation of
  168. .ARC files.  The LZW "crunching" algorithm is impressive though (see my
  169. editorial comments preceeding the UCR routine), and I now believe there
  170. is a place for .ARC files in the CP/M world (particularly on RCP/M's,
  171. where the name of the game is reducing upload/download time).  But
  172. that's the domain of another program (i.e. my next project: NARC).
  173.  
  174.                     - Bob Freed
  175.