home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / DIR / CSAP302.ZIP / READ.ME < prev    next >
Encoding:
Text File  |  1990-06-20  |  4.3 KB  |  91 lines
  1.            CSAP - Sort And Pack Directories [C source]
  2.  
  3. Author:  Don A. Williams
  4.  
  5. Version: 3.0.2   Date:    June 20, 1990
  6.  
  7. Since  the  absread()  and  abswrite()  functions  provided  with 
  8. version 1.0 of Borland International's Turbo C++ support the long 
  9. sector  addresses required by partitions larger than 32 meg,  the 
  10. special routines used by CSAP are no longer needed and have  been 
  11. removed.  The GetDPB() function was recoded to eliminate assembly 
  12. language at the same time.
  13. Added  a  message  showing  the  number  of clusters freed by the 
  14. "Truncate Directories" option, '-t', and fixed a small bug in the 
  15. truncation routine.  
  16.  
  17. Version: 3.0.1   Date:    June 18, 1990
  18.  
  19. Version 3.0.1 of CSAP is nothing more  than  a  recompilation  of 
  20. CSAP  using  Turbo  C++ 1.0.  It is slightly smaller and slightly 
  21. faster than CSAP 3.0.0.  
  22.  
  23. Version: 3.0.0   Date:    May 11, 1990
  24.  
  25. Version 3.0.0 of CSAP can handle MS-DOS  4.xx  and  DR  DOS  3.xx 
  26. large  partitions.  It  also  introduces  the optional ability to 
  27. truncate directories,  i.e.  release unused directory disk  space 
  28. back to the free space pool.  CSAP now uses Chris Blum's Absolute 
  29. Disk  I/O  modifications  but  only  the OBJ file for the Compact 
  30. model in  included  in  the  CSAP  ZIP.  The  entire  package  is 
  31. available  on  CompuServ  in  IBMPRO  Library  #3  as ABRD40.ARC.  
  32. Version 3.0.0 of CSAP MUST be regarded as a "beta test" version - 
  33. there are now many different possible configurations and  I  have 
  34. not  been  able to test them all.  It has been tested with MS-DOS 
  35. 3.3 on the small partitions that 3.3 can handle and  with  MS-DOS 
  36. 4.01  and DR DOS 3.41 on small partitions and on large partitions 
  37. up to 70 meg.  I would highly recommend that you take a full save 
  38. of your hard disk before using CSAP 3.0.0 until you are sure that 
  39. it works with your particular setup.  
  40.  
  41. Version 2.1.1 of CSAP corrects the incorrect sorting on Date/Time 
  42. that was reintroduced in CSAP 2.0.9 and  later  versions.  Thanks 
  43. to David Klatzco for reporting it.  
  44.  
  45. Version 2.1.0 of CSAP corrects the handling of the '.'  and  '..' 
  46. directory  specifiers  and  adds  the  documentation  of the '-V' 
  47. option to CSAP.DOC (the '-V' has been operative in  the  program 
  48. for some time but was left out of the documentation.) 
  49.  
  50. CSAP  is  composed of 5 modules;  CSAP.C,  SORTDIR.C,  ISDEV.C.C, 
  51. GETDPB.C,  and ABSREAD.OBJ.  The current version  of  CSAP,  CSAP 
  52. 3.0.0ß,   has   been   designed   for  compilation  with  Borland 
  53. International's  Turbo  C  2.0.   The  module  ISDEV.C  could  be 
  54. replaced by Turbo C's supplied function isatty(), however, I plan 
  55. to extend ISDEV.C to distinguish among files,  CON,  AUX, and the 
  56. printer.  The function isatty() just distinguishes between  files 
  57. and the others.  
  58.  
  59. GETDPB.C cannot be compiled in Turbo C's interactive  environment 
  60. (TC).  It  is  primarily  inline  ASM  code and requires the more 
  61. conventional environment provided by Turbo C's TCC command.  As a 
  62. result,  CSAP was designed to be compiled through the  use  of  a 
  63. MAKEFILE and the MAKE facility of Turbo C.  
  64.  
  65. CSAP currently compiles and executes correctly in  any  of  Turbo 
  66. C's  supported  memory  models  except HUGE.  The memory model is 
  67. defined as a macro in the MAKEFILE and is supplied  on  the  MAKE 
  68. command line, i.e.: 
  69.  
  70.         MAKE -DMDL=s
  71.  
  72. to make a SMALL memory model version of CSAP  (the  "s"  must  be 
  73. lower  case  since  it  is  a  parameter  to  TCC and TCC is case 
  74. sensitive on its parameters).  The resultant  EXE  file  will  be 
  75. named  CSAPx.EXE where 'x' is C,  S,  M,  or L depending upon the 
  76. memory model selected.  The default memory model (if -DMDL is not 
  77. specified on the MAKE command) is the COMPACT model.  The current 
  78. MAKEFILE will NOT work properly for the TINY  memory  model,  the 
  79. library  specifications in the MAKEFILE would have to be modified 
  80. to use the SMALL libraries for the TINY model and the  effort  is 
  81. probably not worth it.  The command: 
  82.  
  83.         TCC -mt -G csap sortdir isdevice getdpb
  84.  
  85. would  have  to be used to produce a TINY memory model version of 
  86. CSAP and would produce an EXE file with the name CSAP.EXE.  
  87.  
  88. The  EXE  and OBJ files in the CSAPxxx ZIP have been produced for 
  89. the COMPACT model which is probably the most general.  
  90.  
  91.