home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / CSAP400.ZIP / READ.ME < prev    next >
Text File  |  1992-09-25  |  6KB  |  122 lines
  1. CSAP - Sort And Pack Directories [C source]
  2.  
  3. Author:  Don A. Williams
  4.  
  5. Version: 3.2.1   Date:    September 25, 1992
  6.  
  7. This  version reinstates the "truncate"  option that was destroyed by  version
  8. 3.2.0.   It also fixes a long standing error it writing the second copy of the
  9. FAT  when  a  directory has been truncated.   The  version/date  printout  are
  10. corrected in this version too!
  11.  
  12. Version: 3.2.0   Date:    February 20, 1992
  13.  
  14. A total reimplementation of the handling of erased entries that eliminates the
  15. "cross linked files"  problem.  Evidently,  some of the disk organizers pay no
  16. attention to the "end of directory"  sentinel unless it occurs at the physical
  17. end  of  the  directory.   CSAP now zero-sets all entries at the  end  of  the
  18. directory.   The truncate directory option is,  temporarily,  crippled in this
  19. version.
  20.  
  21. Version: 3.1.2   Date:    February 19, 1992
  22.  
  23. Minor  change in the handling of erased entries in an attempt,  only partially
  24. successful,   to eliminate the "cross linked files"  problem that occurs  when
  25. CSAP  is  used  in conjunction with some of the  "disk  organizer"   programs,
  26. notably Central Point Software'a COMPRESS and the Shareware DOG.
  27.  
  28. Version: 3.1.1   Date:    February 14, 1991
  29.  
  30. Made a very minor change to allow CSAP to run under  MS-DOS  5.0.  The  change
  31. amounted  to nothing more than allowing "5" as a DOS version number.
  32.  
  33. Version: 3.1.0   Date:    July 11, 1990
  34.  
  35. Repaired  a  rather  major  problem  with  the   '-t',   Truncate Directories,
  36. option   and  empty  directories.   If  there  was  a directory consisting  of
  37. nothing  but erased  files  and  CSAP  was executed  WITHOUT the '-t'   option
  38. and,    later,    CSAP  was executed WITH the '-t'  option,  many  bad  things
  39. including  corruption  of the disk could occur!  Also corrected the  count  of
  40. freed  clusters which was one too high and added a count of the freed bytes to
  41. the message.
  42.  
  43.  
  44. Version: 3.0.2   Date:    June 20, 1990
  45.  
  46. Since  the  absread()  and  abswrite()   functions  provided  with version 1.0
  47. of  Borland  International's  Turbo C++  support the  long  sector   addresses
  48. required by partitions larger than 32 meg,   the special routines used by CSAP
  49. are  no  longer  needed and have  been removed.   The GetDPB()   function  was
  50. recoded  to  eliminate assembly language at the same time.  Added  a   message
  51. showing  the  number  of clusters freed by the "Truncate Directories"  option,
  52. '-t', and fixed a small bug in the truncation routine.
  53.  
  54. Version: 3.0.1   Date:    June 18, 1990
  55.  
  56. Version 3.0.1  of CSAP is nothing more  than  a  recompilation  of CSAP  using
  57. Turbo  C++ 1.0.  It is slightly smaller and slightly faster than CSAP 3.0.0.
  58.  
  59. Version: 3.0.0   Date:    May 11, 1990
  60.  
  61. Version  3.0.0   of  CSAP can handle MS-DOS  4.xx  and  DR   DOS   3.xx  large
  62. partitions.     It   also   introduces   the  optional  ability  to   truncate
  63. directories,    i.e.   release unused directory disk  space back to  the  free
  64. space pool.  CSAP now uses Chris Blum's Absolute Disk  I/O  modifications  but
  65. only  the OBJ file for the Compact model in  included  in  the  CSAP  ZIP. The
  66. entire   package   is available  on  CompuServ  in  IBMPRO  Library   #3    as
  67. ABRD40.ARC.  Version 3.0.0 of CSAP MUST be regarded as a "beta test" version -
  68. there  are now many different possible configurations and  I  have  not   been
  69. able  to  test  them all.   It has been tested with MS-DOS 3.3  on  the  small
  70. partitions  that 3.3  can handle and  with  MS-DOS 4.01   and DR DOS 3.41   on
  71. small  partitions  and on large partitions up to 70  meg.    I   would  highly
  72. recommend  that you take a full save of your hard disk before using CSAP 3.0.0
  73. until you are sure that it works with your particular setup.
  74.  
  75. Version  2.1.1   of CSAP corrects the incorrect sorting on Date/Time that  was
  76. reintroduced in CSAP 2.0.9 and  later  versions.   Thanks to David Klatzco for
  77. reporting it.
  78.  
  79. Version 2.1.0  of CSAP corrects the handling of the '.'   and  '..'  directory
  80. specifiers  and  adds  the  documentation  of the '-V' option to CSAP.DOC (the
  81. '-V' has been operative in  the  program for some time but was left out of the
  82. documentation.)
  83.  
  84. CSAP  is  composed of 5 modules;   CSAP.C,  SORTDIR.C,   ISDEV.C.C,  GETDPB.C,
  85. and ABSREAD.OBJ.   The current version  of  CSAP,   CSAP 3.0.0ß,    has   been
  86. designed   for  compilation  with  Borland International's  Turbo  C  2.0. The
  87. module  ISDEV.C  could  be replaced by  Turbo  C's supplied function isatty(),
  88. however,  I plan to extend ISDEV.C to distinguish among files,  CON, AUX,  and
  89. the printer.   The function isatty() just distinguishes between  files and the
  90. others.
  91.  
  92. GETDPB.C cannot be compiled in Turbo C's interactive  environment (TC).  It is
  93. primarily  inline  ASM   code  and  requires the more conventional environment
  94. provided by  Turbo C's TCC command.   As a  result,    CSAP was designed to be
  95. compiled through the  use  of  a MAKEFILE and the MAKE facility of Turbo C.
  96.  
  97. CSAP  currently  compiles  and  executes correctly  in   any   of   Turbo  C's
  98. supported   memory   models  except HUGE.   The memory model is defined  as  a
  99. macro in the MAKEFILE and is supplied  on  the  MAKE command line, i.e.:
  100.  
  101. MAKE -DMDL=s
  102.  
  103. to make a SMALL memory model version of CSAP  (the  "s"   must  be lower  case
  104. since   it   is   a   parameter   to  TCC and TCC is  case  sensitive  on  its
  105. parameters).  The resultant  EXE  file  will  be named  CSAPx.EXE where 'x' is
  106. C,  S,  M,  or L depending upon the memory model selected.  The default memory
  107. model  (if -DMDL is not specified on the MAKE command)  is the COMPACT  model.
  108. The current MAKEFILE will NOT work properly for the TINY  memory  model,   the
  109. library   specifications in the MAKEFILE would have to be modified to use  the
  110. SMALL libraries for the TINY model and the  effort  is probably not worth  it.
  111. The command:
  112.  
  113. TCC -mt -G csap sortdir isdevice getdpb
  114.  
  115. would   have   to be used to produce a TINY memory model version of  CSAP  and
  116. would produce an EXE file with the name CSAP.EXE.
  117.  
  118. The   EXE  and OBJ files in the CSAPxxx ZIP have been produced for the COMPACT
  119. model which is probably the most general.
  120.  
  121.  
  122.