home *** CD-ROM | disk | FTP | other *** search
/ Programmer Power Tools / Programmer Power Tools.iso / turbopas / sfmsrc.arc / SFMREAD.ME < prev    next >
Encoding:
Text File  |  1987-11-15  |  4.1 KB  |  92 lines
  1.                     SFM Notes and Revisions
  2.  
  3.     If you haven't already noticed, this program is written as
  4. a contest entry.  I am put it on GEnie as two separate files
  5. in order to avoid your having to load one huge file when
  6. many of you won't necessarily want the source code.  As per the
  7. contest rules I must make full source code available and may not
  8. request donations.  This is OK with me, especially since you
  9. have already invested a fair amount to download these files.  I
  10. hope you find the program worth the investment.
  11.  
  12. The archive file names are SFM.ARC and SFMSRC.ARC.
  13.  
  14.     If you have taken the time to also download the source code
  15. I am confident that you will find something of value there.  There
  16. is quite a bit of hard to find information concerning DOS incorporated
  17. in that code.  There is also a "technical document" included with the
  18. source code that I hope helps with understanding the general layout
  19. of SFM.
  20.  
  21.      As with all programs I put into the public domain I would like to
  22. hear from anyone who has an opinion concerning this program or any other
  23. I have contributed.  You may write to:
  24.  
  25.                David Steiner
  26.                2035 J Apt. #6
  27.                Lincoln, NE  68510
  28.                (402) 475-0601
  29.  
  30. or send me mail on GEnie [D.STEINER].
  31.  
  32.      Finally I would like to say that I have no qualms about persons
  33. using portions of this code in programs they write, just give me some
  34. credit.  However, I must make it clear that I don't want to see
  35. versions of this program that have been altered by other people.
  36. You may change the program to suit your needs however you wish, but
  37. do not redistribute such altered versions of SFM.  If you make a change
  38. that you consider to be for the better, please write me and perhaps send
  39. a disk containing the altered version if the change is major.  In such a
  40. case I will make the 'official' revision and distribute update files
  41. (giving credit to the individual who made the change).
  42.  
  43.      The reasons behind the above restrictions are many but I will
  44. highlight a couple.  My first concern is that someone may make an
  45. alteration and not realize the full extent of the changes made.
  46. Considering the power invested in SFM such a situation can be
  47. detrimental to a system's disks (I know, I once overwrote my hard
  48. disk's FAT with one from a RAM disk while testing some 'minor' changes).
  49. The second reason I will cover is simply that I have a starving ego to feed
  50. and wouldn't consider someone 'going over my head' to be terribly nice
  51. on their part.  Don't hold that against me, we folks who donate to the
  52. public domain have little else to keep us going.
  53.  
  54.                 Hope you find SFM useful,
  55.                                     David Steiner
  56.  
  57. REVISIONS:
  58.  
  59.     As I said, this program was a contest entry.  Imagine my chagrine
  60. when I noticed a bug in the program a few days after being sent off to
  61. CPCUG.
  62.  
  63.     The bug was relatively minor, and the only real one I have found
  64. so far.  When SFM was copying files from a root directory to somewhere
  65. else it would skip the first file in the directory, if it were marked.
  66. It had to do with the initialization of a variable in the CopyEntries
  67. procedure it was:
  68.  
  69.      i := NextEntry( w, 0 );
  70.  
  71. when it should have been simply:
  72.  
  73.      i := 0;
  74.  
  75. The change is made in this version so you need not worry about it, I
  76. however, still wonder if it is to be considered a point against me
  77. by the judges of the contest.
  78.  
  79. VERSION 1.01
  80.  
  81.     There was a very minor bug that I fixed concerning what happens
  82. when you change disks during a copy.  If you didn't have the destination
  83. disk loaded in one of the windows you would get a message saying that
  84. joined or substituted drives were not supported.  It was related to
  85. a stupid assumption I made when I wrote the disk changing routine,
  86. ChangeCopyDisk.
  87.  
  88.     I also updated it to keep track of how many files it is copying
  89. during a copy operation.  It now prints the Reading from and Writing
  90. to messages with the number of the file in addition to the name.
  91. This is nice for letting you know how much further SFM has to go before
  92. completing a copy.