home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / sap50.lbr / SAP50.HZS / SAP50.HIS
Encoding:
Text File  |  1993-10-25  |  5.3 KB  |  111 lines
  1. ;=======================================================================
  2. ;
  3. ; THIS PROGRAM READS THE DISK DIRECTORY TRACKS, SORTS THEM ALPHABETICALLY
  4. ; THEN REPLACES THEM ON THE DISK.  ALL UNUSED OR ERASED AREAS ON THE DI-
  5. ; RECTORY TRACK ARE REFORMATTED WITH CONTINUOUS 'E5' CHARACTERS.  (THIS
  6. ; ERASES PREVIOUS FILE NAMES WHICH HAVE BEEN DEACTIVATED.)  SORTING THE
  7. ; DIRECTORY IN THIS MANNER OFFERS MANY ADVANTAGES.  SOME OF THEM ARE:
  8. ;
  9. ;    1)  ALLOWS 'DIR' TO SHOW AN ALPHABETIZED LISTING
  10. ;    2)  ELIMINATES POTENTIAL PROBLEMS WITH "UNERASE" PROGRAMS
  11. ;    3)  SPEEDS UP ACCESS VIA 'SD' AND OTHER SPECIAL PROGRAMS
  12. ;    4)  ASSISTS ON WORKING DIRECTLY ON THE DISK WITH 'DU', ETC.
  13. ;    5)  REMOVES FILES FROM THE DISK SOMEBODY ELSE COULD RECOVER
  14. ;    6)  OPTIONALLY ERASES ALL FILES OF ZERO LENGTH (EXCEPT THOSE
  15. ;        STARTING WITH '-' FOR CATALOG USE WITH MAST.CAT)
  16. ;
  17. ;                - Notes by Irv Hoff W6FFC
  18. ;
  19. ;=======================================================================
  20. ;
  21. ; 08/07/86  I looked into the other SAP 44.  The original SAP 44 was put
  22. ;        into the public domain 7/25/85 by Bob Clyne.  His fix is the
  23. ;        one that I incorporated into SAP 50.
  24. ;                    - Richard Huff
  25. ;
  26. ; 08/05/86  I saw someone else's comments on their version 44 and imple-
  27. ;   v50     mented their bug fix into my version.  This now prevents SAP
  28. ;        from making partial switches that could mess up the high or-
  29. ;        der bits of the file names or types.  A very small window of
  30. ;        vulnerability, but now fixed.
  31. ;                    - Richard Huff
  32. ;
  33. ; 08/03/86  I've finally rewritten the mainline to not do useless CALLs.
  34. ;   v49     Instead I've coded each routine to fall into the next one.
  35. ;        Has anyone every tried SAP 43 with CP/M 1.4 to see if it
  36. ;        really works?  SAP 49 will work the same as SAP 43 in this
  37. ;        respect, but I don't see how it could possibly work!  In
  38. ;        case anyone is interested in making SAP 49 compatible with
  39. ;        8080 code and all assemblers, I've included SAP 45 as a
  40. ;        start.  Oh yeah, versions 46 through 49 assemble with the
  41. ;        Z80MR public domain assembler.  I have no idea if any other
  42. ;        assemblers are compatible.    - Richard Huff
  43. ;
  44. ; 08/03/86  The CLEAN routine has been completely rewritten to automati-
  45. ;   v48     cally put all empty entries at the end of the buffer.  This
  46. ;        speeds up the subsequent SORT and PACK.
  47. ;                    - Richard Huff
  48. ;
  49. ; 08/01/86  The sort is completely rewritten for OPTIMUM speed.
  50. ;   v47                 - Richard Huff
  51. ;
  52. ; 07/31/86  Converted to Z80-only mnemonics using XLATE5, dropped the
  53. ;   v46     8080 compatibility concept and further optimized instructions
  54. ;        for the Z80 CPU.  Also fixed a bug in the sort which only
  55. ;        shows up on large sorts (such as on a hard disk).
  56. ;                    - Richard Huff
  57. ;
  58. ; 06/28/86  I've now modified even more of the program to be efficient
  59. ;   v45     and to take advantage of the Z80 opcodes where possible.  I
  60. ;        added a new conditional assembly option.  It lets me delete
  61. ;        all 0-length files, regardless of file name, while still
  62. ;        having the capability to do everything v44 did.
  63. ;                    - Richard Huff
  64. ;
  65. ; 06/07/86  Organized locations of subroutines to give sanity to the
  66. ;   v44     program.  Also added code to prevent overwriting of CCP when
  67. ;        reading the directory; instead, it now only processes as
  68. ;        many directory sectors as will fit in available memory.  As
  69. ;        a finishing touch some Z80 opcodes are used as a conditional
  70. ;        assembly option, and the sort algorithm was made faster.
  71. ;                    - Richard Huff
  72. ;
  73. ; 03/20/85  Inserted my name where it belonged under the v42 release
  74. ;   v43     notice, added conditional assembly option for verbose mode
  75. ;        which will, if selected, permit the program to assemble in
  76. ;        under 1k.  Added conditional assembly option for CP/M-only
  77. ;        mode which suppresses check for MP/M and CP/M+.
  78. ;                    - Dennis Quinn
  79. ;
  80. ; 03/06/85  Removed "trash directory" feature to make program more user-
  81. ;   v42     friendly, made "delete zero-length files" an assembly-time
  82. ;        option, as there are more programs than MCAT which make use
  83. ;        of zero-length files.    - Dennis Quinn    (added in v43)
  84. ;
  85. ; 02/28/85  Minor cleanup, made compatible with all assemblers.
  86. ;   v41                 - Irv Hoff
  87. ;
  88. ; 09/17/84  Added 'Previously sorted' statement that was included in v37
  89. ;   v40     but got dropped from v38 when the Shell-Metnzer sort was put
  90. ;        in.  It still rewrites the directory even if previously
  91. ;        sorted, to insure erased programs at end of directory are
  92. ;        properly cleared.        - Irv Hoff
  93. ;
  94. ; 07/27/84  Corrected sorting of last directory entry.
  95. ;   v39                 - Bill Duerr
  96. ;
  97. ; 10/16/83  Now using a Shell-Metzner sort which speeds the sorting time
  98. ;   v38     considerably, especially on large directories.
  99. ;                    - Sigi Kluger
  100. ;
  101. ; 07/27/83  Shows an error flag for MP/M and CP/M+ both.  Rewrites the
  102. ;   v37     directory even if previously sorted, to insure erased pro-
  103. ;        grams at end of directory are properly cleared.
  104. ;                    - Irv Hoff
  105. ;
  106. ; 1977    Written by L. E. Hughes.  Modified extensively since by Bruce
  107. ;    Ratoff, Keith Petersen, James Prest, Ron Fowler, Frank Gaude,
  108. ;    Sigi Kluger, Irv Hoff and likely others.
  109. ;
  110. ;=======================================================================
  111.