home *** CD-ROM | disk | FTP | other *** search
/ Power Programming / powerprogramming1994.iso / progtool / c / csr20a.arc / README.CSR < prev    next >
Text File  |  1987-01-15  |  8KB  |  137 lines
  1. December 5, 1986
  2. ----------------
  3.  
  4. Hello, and welcome.  This archive contains Version 2.0 of the C Spot Run
  5. C Add-On Library.  If you have a copy of version 1.0 you are excused from
  6. the following explanatory paragraph.
  7.  
  8. C Spot Run is a collection of routines, utilities, and programming aids
  9. for C programmers, and is centered around MS/PC-DOS, IBM-PC's, and
  10. compatibles.  The collection is rather well documented and is distributed,
  11. for the most part, in OBJect code form.  (Source code is available in 
  12. exchange for a $50 dollar contribution.)  A more complete description of
  13. the library can be found in the beginning of the manual.
  14.  
  15. This release of the library has a quite a few new functions, an improved
  16. CheckC, a new manual, quite a few bug fixes (which doesn't say much for
  17. the first version), a new issue of the support newsletter, and a slightly
  18. better educated author.  However, contrary to what I was so naive as to 
  19. believe when I released the first version, I have discovered that the library
  20. is not now and never will be complete.  The possibilities are endless, and
  21. I hope some of you can help me explore them.
  22.  
  23. Most of my comments and 'news' can be found in the newsletter, but as I've
  24. been writing it for so long I don't remember what all I said there, nor do
  25. I feel like reading it, which would tempt me to rewrite it.  Regardless, I
  26. have some comments I can share here.
  27.  
  28. Concerning the Manual:  Writing the descriptions for all of the routines
  29. in the library is a VERY boring job, involving lots of referece to printouts,
  30. file dates, argument sequence, etc.  Thus you may find the descriptions weak,
  31. and very often the example will show little more than the calling sequence.
  32. (When I work on the manual I'm rarely in the mood to write 25 individual
  33. example programs.)  So, if anyone of you would like to improve the examples 
  34. significantly, you are welcome to try, and if you succeed I'll register you
  35. and send you the source code.  (It's incredibly easy to give this stuff 
  36. away when the cost to mail a disk is around $1.50....)  I suggest you call
  37. me first so someone doesn't beat you to it and waste your time.  (But then
  38. I can't imagine why anyone would want to do it after the third example....)
  39.  
  40. Concerning User Response:  I was pleasantly suprised at the number of
  41. responses, by phone, mail, and BBS, and I welcome many more.  However, I
  42. didn't get ANY 'User Response Forms' in return.  I appreciate all the people
  43. who called with comments, and those who answered the BBS questionaire, but
  44. I can't seem to keep track of the comments and other data.  Thus, now that
  45. I am reasonably organized, (I now keep the source code disk apart from the
  46. working subdirectory on the HD so I can respond to orders immediately, and
  47. I use a data base to track 'contact' names and addresses), I will place
  48. anyone who sends in a User Response Form, or calls voice and leaves a name,
  49. address, and comments, onto a mailing list.  (And anyone who includes a stamp
  50. (I use mailing labels, so I don't need SASEs) will have my sincerest
  51. grattitude.  I'm only a hobbiest, you know....)
  52.  
  53. Concerning this Package Remaining Shareware:  I've heard horror stories of
  54. shareware authors who made 45 cents in 3 years, and dream stories about guys
  55. who went full time making thousands.  I've made more than 45 cents, but not
  56. quite thousands.  The point is that I want to keep this package shareware, 
  57. I think the reasons are in the newsletter, but I don't want to pour hundreds
  58. of hours of work down the drain.  This package will remain shareware as long
  59. as somebody new registers once in a while, to pay for my phone bill and 
  60. compiler updates. 
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. Concerning Other Compilers:  Not now, but soon.  Get on the mailing list and
  70. you'll hear about it.  (I already have people volunteered to do it for most
  71. major PC compilers.)  Also, this version is compiled with MSC 3.0.  I already
  72. have 4.0, which the next version will be compiled with, but I am not quite 
  73. ready to recompile the entire package.  Microsoft assures me that 4.0 users
  74. will be able to use the library as it is now, compiled with 3.0.
  75.  
  76. Concerning a Screen Editor/Code Generator:  After I get this released and off
  77. of my back I will be working with Dennis L. Raney (author of SE, more info 
  78. to follow) on this program.  Suggestions welcomed.  
  79.  
  80. For those of you wondering what SE is, it is a Turbo Pascal program that
  81. generates source code for colorful screens in ANSI, Turbo Pascal, BASIC,
  82. and C (using CSR's screen routines.)  The input functions are severely
  83. limited, and don't work at all with C.  However the program is great for 
  84. designing title screens or prototypes, and is lots of fun to play with.  It
  85. is available for download on various BBSs in addition to the Pinelands.
  86. (Look for Screen Edit version 2.0, SE20.ARC.)
  87.  
  88.  
  89. January 10, 1987
  90. ----------------
  91.  
  92. Ok, I think its good enough to release.  (In other words, I don't want to
  93. type another function description or line of code for a year.)  Some final
  94. comments....  This is version 2.0 because due to the large number of new
  95. functions there may be some structural bugs I don't know of in the input or
  96. something.  (I hope not.)  A version number like 1.1 gives the impression that
  97. all the bugs of 1.0 were fixed, but there are so many new things here that
  98. totally new bugs could have arrived....  I think I mentioned above that I've
  99. been writing this for a long time.  I believe I started the newsletter in 
  100. August, not to mention that modifications to the source started within weeks
  101. of the first release.  The result is a little overlap with function duty,
  102. some outdated news both here and in the newsletter, and a few weak spots 
  103. in documentation and overall design.  (I made some bad choices in the
  104. original design, and the correction strategy involves new functions to
  105. do mostly the same things as the old ones, which will remain in the library
  106. for compatibility.)....  I'm planning on attending a Microsoft Windows
  107. Developers Seminar at the end of this month, and I'm anticipating some of
  108. the rumored C compilers 'for the masses,' like 'Turbo C' or 'Quick C.'  I 
  109. feel that these new 'frontiers' will present a need for specialized routines
  110. and tools.  However this is just speculation, I don't know what they will
  111. involve.  If anyone would like to discuss it, feel free to call me.
  112.  
  113. In conclusion, I suggest you read the newsletter enclosed, and print out the
  114. documentation with the command COPY CSPOTRUN.DOC PRN.  (Note:  You may
  115. consider looking at the docs with a DOS program before printing them if you
  116. are not sure you'll be using the library.  Also, when printing be sure you
  117. are at the top of a page before starting, and have enough paper for the 
  118. documentation which is about 210+ pages long.  (I suggest a three ring
  119. binder.))  Feel free to contact me as follows for discussion of CSR, the C
  120. language, your favorite compiler, or pizza toppings.
  121.  
  122.   Bob Pritchett
  123.   New Dimension Software
  124.   23 Pawtucket Dr.
  125.   Cherry Hill, NJ 08003
  126.   Voice: (609) 424-2595
  127.    Data: (609) 354-9259 (300-2400B)
  128.  
  129.  
  130. January 15, 1987
  131. ----------------
  132.  
  133. Oh no!  The CheckC and FLine utilities were accidentally excluded from
  134. version 2.0!  They are included in this, version 2.0a, and are distributed
  135. in CSRUPDT1.ARC.  (The documentation does not change.)  My apologies for
  136. the inconvenience.
  137.