home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / C / CSR30_1.ZIP / README.DAT < prev    next >
Encoding:
Text File  |  1988-07-13  |  8.1 KB  |  164 lines
  1.                                C Spot Run
  2.  
  3.                     A User-Supported C Add-On Library
  4.  
  5.                        Version 3.0  "ReadMe" File
  6.  
  7.                               July 12, 1988
  8.  
  9.  
  10.         Hello and welcome to the C Spot Run package.  I'm your  host,
  11.     the  infamous README file.... This file serves several  purposes:
  12.     it allows me to fill you in on the latest information that didn't
  13.     make it into the documentation; it helps you to get started  with
  14.     this  package; it lets me show off some CSR features through  the
  15.     README.C  program, and it is less formal than the  documentation.
  16.     So  let's get started....  (NOTE: To print this file  type  "COPY
  17.     README.DAT PRN" at the DOS prompt.)
  18.  
  19.         Following is a list of the files in this archive and a  short
  20.     description of each.
  21.  
  22.         CCDEMOMS.BAT     Batch to compile CSRDEMO for Microsoft.
  23.         CCDEMOTC.BAT     Batch to compile CSRDEMO for Turbo C.
  24.         CHECKC.EXE       Executable for the CheckC program.
  25.         COLOR.H          Include file with color definitions.
  26.         CSPOTRUN.DOC     Complete C Spot Run documentation.
  27.         CSR.H            New standard header file for C Spot Run.
  28.         CSRDEMO.C        Demo program for C Spot Run.
  29.         CSRDEMO.EXE      Executable of CSRDEMO.C.
  30.         CSRDEMO.PRJ      Project file to make CSRDEMO in Turbo C.
  31.         CSRDEMO.MAK      Make file to compile CSRDEMO in QuickC.
  32.         CSRDOS.H         Include file for directory searching.
  33.         CSRMENU.H        Include file for menu routines.
  34.         CSRMISC.H        Assorted #definitions for CSR.
  35.         CSRMODES.H       Include file with set_mode() options.
  36.         CSRORDER.C       Source to CSR online order form program.
  37.         CSRORDER.EXE     Executable of online order form program.
  38.         CSRQCS.LIB       Linkable  version  of  the  library  for
  39.                          Microsoft C v5.x and QuickC.  (Small)
  40.         CSRQCM.LIB       Linkable  version  of  the  library  for
  41.                          Microsoft C v5.x and QuickC.  (Medium)
  42.         CSRSHELL.ASM     Shell for assembly interface to C.
  43.         CSRSOUND.H       Some note values and declarations.
  44.         CSRTIME.H        Text arrays for week and names.
  45.         ERRORS.H         Text of critical DOS errors.
  46.         FLINE.EXE        Executable for the FirstLine program.
  47.         README.C         The source code to the README program.
  48.         README.DAT       The file you are reading now.
  49.         README.EXE       The executable version of README.
  50.         SKEY.H           Special extended key definitions.
  51.         TIMERS.C         Source code to timer functions.
  52.         TCSCSR.LIB       Linkable  version  of  the  library  for
  53.                          Turbo C v1.5.  (Small)
  54.  
  55.  
  56.     What's Up
  57.  
  58.         So  much  has happened since Version 2.1  was  released  last
  59.     August  that  I don't know where to begin.  I  suppose  the  best
  60.     place would be with the apology, and that's for the fact that  it
  61.     has  been  almost a year since the last release.   I  can  easily
  62.     understand  the agonizing frustration of users who moved  to  the
  63.     new Microsoft and Borland compilers only to find that CSR  hadn't
  64.     moved with them. It has been a long road for me but I can finally
  65.     announce  with  great pleasure that CSR is now working  with  the
  66.     latest  compiler  versions in all of their  incarnations.   I  am
  67.     forever  grateful  for  the  technical  and  moral  support  I've
  68.     received  from users who have been more than patient  during  the
  69.     transition.
  70.  
  71.  
  72.     The NDS News
  73.  
  74.         The C Spot Run Support Newsletter has changed immensely.  Now
  75.     reborn  as  The  NDS  News it  hosts  numerous  useful  articles,
  76.     complete  with  source code examples, and  sports  an  attractive
  77.     desktop-published design. It is now available in hard-copy  only,
  78.     so  if  you haven't received a copy yet you'll want  to  get  one
  79.     right away.
  80.  
  81.         How do you get a copy?  Glad you asked. <smile>  You need  to
  82.     get  on the mailing list, and you can do that by sending  in  the
  83.     form generated by CSRORDER, or, better yet, by registering as a C
  84.     Spot Run User. For the time being I'm sending a copy to  everyone
  85.     on  the mailing list. However the postage and printing costs  are
  86.     rising  constantly and I won't be able to keep this up.  All  you
  87.     need to do to assure continued newsletter subscription and update
  88.     notification is to register for CSR at any level.
  89.  
  90.  
  91.     Getting Started
  92.  
  93.         The   first   step  to  using  CSR  is  to  print   out   the
  94.     documentation.   It's  250 pages long, so check  your  paper  and
  95.     ribbon.  Make sure you're using a monospaced font if you're using
  96.     a laser printer, and then type "Copy CSpotRun.DOC PRN" at the DOS
  97.     prompt.   Unlike  previous versions this  documentation  includes
  98.     form feeds, so alignment isn't a problem.  (The first page can go
  99.     several lines off either way.)
  100.  
  101.         If  you're  new  to CSR you'll want to  read  the  first  few
  102.     sections of the documentation in order to get started,  otherwise
  103.     you're  all set, except for running the CSRORDER  program,  which
  104.     you'll  want  to  do right away to REGISTER  and/or  get  on  the
  105.     mailing list....
  106.  
  107.  
  108.     Registration: How and Why
  109.  
  110.         If  you use C Spot Run it's important to register as a  user.
  111.     Not  only  do  you receive the benefits of  source  code,  update
  112.     notifications,  the  NDS News, etc., but you get a  warm  feeling
  113.     from  helping  to  support the Shareware  effort.   Without  your
  114.     support  I can't afford to go on supporting CSR, as much  as  I'd
  115.     like to.
  116.  
  117.         I  want to make registration as easy as possible for you,  so
  118.     there are a number of options.  First, with the NDS News comes  a
  119.     printed  order  form with complete instructions on a  nice,  good
  120.     looking form.  Secondly, the CSRORDER program included with  this
  121.     package  will  prompt you for all of  the  important  information
  122.     online  and  printout a one page form for registering  or  simply
  123.     getting on the mailing list.  Your third option is to send in the
  124.     order form at the end of the CSR documentation.  And last but not
  125.     least,  you can register with a credit card on-line and  download
  126.     the source code right away!
  127.  
  128.         This  last option needs the most explanation, so here it  is:
  129.     The Shareware BBS in San Diego, CA, at (619) 455-5226, 2400 baud,
  130.     allows you to register on-line with a Visa or Mastercard and then
  131.     download the source code immediately.  (After registering on-line
  132.     you should send in one of the printed forms with PAID written  on
  133.     it  to  assure  that an "official" disk is mailed  and  a  serial
  134.     number assigned.)
  135.  
  136.  
  137.     Final Comments
  138.  
  139.         In the confusion of putting this release together some things
  140.     may  have  slipped  by me.  I've tried to test  CSR  in  all  the
  141.     distributed  configurations  and I'm confident that  the  package
  142.     performs as documented.  The library has undergone months of  use
  143.     with  QuickC  /  MSC  5.x, and I've tested  it  a  lot  with  the
  144.     integrated environments and command line version of Turbo C v1.5.
  145.     If  you do find a problem, though, please let me know right  away
  146.     so  I  can try and fix it.  The problems with Turbo C  v1.0  this
  147.     past year practically crippled the product, and I don't want that
  148.     to happen again.
  149.  
  150.         If all goes well a v3.1 of CSR should follow in the next  few
  151.     months  to handle any bugs that crop up and expand  the  function
  152.     library.  Vaporware, I know, but I'm honestly trying.
  153.  
  154.         Finally,  in  the  v2.1  README  file  I  asked  for  letters
  155.     supporting my college applications.  I want to thank those of you
  156.     who  took the time to write something about myself and  CSR,  and
  157.     I'm  happy  to  announce  that  I've  been  accepted  at   Drexel
  158.     University as a Computer Science student this fall.
  159.  
  160.         Thanks for your support, and good luck with CSR.  Please feel
  161.     free to call me with any questions, comments, or suggestions.
  162.  
  163.         - Bob Pritchett  (609) 424-2595 (Voice)
  164.